Recevoir des appels
Un numéro détenu par votre espace de travail peut répondre à un appel entrant de trois façons : le livrer à l'un de vos trunks SIP, le transférer vers un numéro que vous avez vérifié, ou le rejeter. La réponse est un paramètre du numéro, et un numéro n'a qu'une seule réponse à la fois.
Tout numéro démarre sur le rejet : un numéro que personne n'a configuré refuse les appelants au lieu de n'avoir aucune réponse.
Prérequis
Avant de diriger un numéro vers une réponse :
- Un numéro capable de recevoir des appels. Ouvrez Voice > Numbers et vérifiez la colonne Directions pour une marque entrante. Un numéro que vous avez enregistré comme identifiant d'appelant depuis un autre opérateur ne reçoit pas d'appels ici : c'est cet opérateur qui achemine les appels vers ce numéro, il ne porte donc aucune réponse.
- Pour une livraison vers un trunk : un trunk SIP avec les appels entrants activés et au moins une passerelle de livraison.
- Pour un transfert : un identifiant d'appelant vérifié vers lequel transférer.
- Pour modifier le paramètre via API ou CLI : une clé API disposant du scope voice_management en écriture. Ce scope couvre la configuration vocale ; le scope voice couvre le trafic d'appels et les statistiques, donc la lecture du journal d'appels nécessite l'autre.
Livrer les appels à un trunk SIP
La livraison appelle votre propre système téléphonique aux adresses que vous déclarez sur le trunk. Activez d'abord la direction, car un numéro ne peut être dirigé que vers un trunk qui accepte déjà les appels entrants.
- Ouvrez Voice > SIP Trunks, ouvrez le trunk, et sous Inbound calling sélectionnez Enable inbound.
- Ajoutez au moins une passerelle dans la même section. Un trunk sans passerelle refuse chaque appel entrant vers les numéros auxquels il répond.
- Ouvrez Voice > Numbers, ouvrez le numéro, et sous Inbound routing choisissez Deliver to a SIP trunk.
- Sélectionnez le trunk et cliquez sur Save. Seuls les trunks avec les appels entrants activés apparaissent dans la liste.
La colonne Used for dans la liste Numbers affiche alors le numéro comme livré à ce trunk, et la page du trunk liste les numéros auxquels il répond.
Ce dont une passerelle a besoin
Une passerelle est une adresse vers laquelle un appel est livré, ainsi que la façon dont ce pair souhaite que les deux numéros de l'appel soient formatés :
| Paramètre | Ce que c'est |
|---|---|
| URI SIP | L'hôte de votre système téléphonique, avec un port optionnel, comme dans sip:pbx.example.com:5060. Indiquez l'hôte uniquement : une URI contenant une partie utilisateur est refusée |
| Priorité | L'ordre dans lequel les passerelles sont essayées, la plus basse en premier |
| Format de destination | Comment le numéro appelé est formaté pour ce pair. Par défaut E.164 |
| Format d'origine | Comment le numéro appelant est formaté pour ce pair, dans l'en-tête P-Asserted-Identity de l'appel livré. Par défaut E.164 |
Les passerelles partageant une même priorité reçoivent une part égale des appels, et n'importe laquelle peut être essayée en premier pour un appel donné. Pour basculer la livraison vers une deuxième adresse, attribuez à cette passerelle un numéro de priorité plus élevé : elle est essayée lorsque la première ne répond pas.
Les deux formats de numéro sont des modèles utilisant un seul espace réservé, {number}, qui représente le numéro sans son + initial. Le format de destination est placé devant l'hôte de l'URI SIP, de sorte que 1234#{number} livre un appel vers +31201234567 sous la forme sip:1234#31201234567@pbx.example.com:5060. La valeur par défaut pour les deux est +{number}, soit E.164. Un format ne contenant aucun {number} envoie chaque numéro auquel le trunk répond vers une seule adresse fixe.
Warning: turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again.
Transférer les appels vers un autre numéro
Un transfert répond à l'appel entrant, passe un second appel vers un numéro que vous avez vérifié, puis connecte les deux.
- Ouvrez Voice > Numbers, ouvrez le numéro, et sous Inbound routing choisissez Forward to another number.
- Sélectionnez le numéro vers lequel transférer. La liste contient vos identifiants d'appelant vérifiés, car un transfert ne peut cibler qu'un numéro dont vous avez prouvé le contrôle.
- Choisissez quel numéro l'appel transféré affiche comme appelant, puis sélectionnez Save.
La cible du transfert est vérifiée au moment où vous la définissez et à nouveau à chaque appel transféré. Un identifiant d'appelant que vous supprimez par la suite arrête le transfert au lieu de continuer, et les appels entrants sont rejetés à partir de ce moment.
L'appel transféré sonne pendant 45 secondes avant d'être abandonné, soit plus longtemps qu'une livraison par trunk, car l'extrémité distante est généralement le téléphone d'une personne et non un système téléphonique.
Le transfert passe un appel, donc les règles sortantes s'appliquent au second segment : transférer vers un pays que vous n'avez pas activé sous Destinations est refusé avec destination_not_enabled.
Un transfert, deux enregistrements d'appel
Un appel transféré produit deux enregistrements partageant un même session_id :
| Enregistrement | Ce que c'est |
|---|---|
| L'appel entrant | direction est inbound, et route indique que le numéro était configuré pour transférer, vers quel numéro, et quel numéro le segment transféré a présenté |
| L'appel transféré | direction est outbound, du numéro présenté par le segment vers le numéro de transfert. Il ne porte pas de route propre |
Regroupez-les par session_id pour voir l'appel complet. L'enregistrement d'arrivée est celui qui indique ce que le numéro était configuré pour faire.
Choisir quel numéro un appel transféré affiche comme appelant
Un appel transféré dispose de deux numéros qu'il peut présenter à la personne qui répond, et le choix modifie à la fois ce qu'elle voit et la probabilité qu'un opérateur interfère avec l'appel :
- Numéro appelant est le propre numéro de l'appelant : le téléphone sonne comme s'il avait composé directement et l'appel peut être rappelé depuis le journal d'appels. Comme le numéro ne vous appartient pas, certains opérateurs, le plus souvent aux États-Unis et dans certaines parties de l'Europe, marquent ces appels comme non vérifiés, remplacent le numéro ou les filtrent.
- Numéro composé est le numéro que l'appelant a composé, qui est l'un des vôtres. La personne qui répond voit lequel de vos numéros a été appelé plutôt que qui a appelé.
Il n'y a pas de valeur par défaut. Indiquez le choix pour chaque transfert que vous configurez via API ou CLI.
Les valeurs que votre espace de travail peut définir sont indiquées sur le numéro lui-même, dans forward_as_options de son inbound_configuration. Présenter le numéro composé nécessite que votre espace de travail soit approuvé pour passer des appels depuis des numéros achetés chez nous, et cette approbation n'est pas encore disponible : forward_as_options propose donc uniquement le numéro appelant et un transfert présente le propre numéro de l'appelant. Définir le numéro composé est refusé d'ici là.
En lecture, forward_as est la valeur que les appels portent réellement, qui peut différer de la dernière valeur écrite.
Consulter ce qu'un numéro a fait d'un appel
L'enregistrement d'un appel entrant porte un route en plus de son statut, et route est ce que le numéro était configuré pour faire au moment où l'appel a été traité. Modifier le paramètre du numéro par la suite ne change pas ce qu'indiquent ses appels passés.
| route.type | Ce que le numéro a fait |
|---|---|
| trunk | L'appel a été livré au trunk SIP nommé dans trunk_id |
| forward | L'appel a été transféré vers le numéro dans forward_to, en présentant le numéro dans forward_as |
| reject | Le numéro a refusé l'appel |
route indique ce que le numéro était configuré pour faire, pas que cela a fonctionné. Une route trunk sur un appel qui ne s'est jamais connecté signifie un numéro dirigé vers un trunk qui n'a pas pris l'appel, et c'est le statut de l'appel qui porte le résultat. route est absent sur les appels sortants et sur les appels enregistrés avant l'existence du champ.
Dans le tableau de bord, ouvrez l'appel depuis Voice > Calls et consultez la ligne Inbound route, qui renvoie au numéro dont les paramètres l'ont déterminé. Via API, route se trouve sur GET /v1/voice/calls/{call_id} et GET /v1/voice/calls, et direction filtre la liste sur les appels entrants.
Diagnostiquer un appel entrant refusé
Un appel entrant refusé est enregistré avec le statut rejected. Deux situations différentes le produisent, et rejection_reason est ce qui les distingue :
- Rejeté sans rejection_reason. Le numéro lui-même a refusé l'appel. L'appel n'a échoué à aucun de nos contrôles, il n'indique donc aucune raison, et route indique ce que le numéro était configuré pour faire. Une route reject signifie un numéro que personne n'a dirigé quelque part, ou un numéro délibérément configuré pour refuser.
- Rejeté avec un rejection_reason. L'appel a échoué à l'un de nos contrôles avant d'atteindre votre système téléphonique. La raison nomme le contrôle. Appels rejetés liste chaque raison et sa correction.
failed est un statut différent et ne signifie pas refusé : il signifie que l'appel a été tenté et n'a pas abouti, sip_response_code portant la réponse reçue.
Lisez route et rejection_reason ensemble pour distinguer les refus :
| route et raison | Cause |
|---|---|
| reject, aucune raison | Le numéro n'est dirigé vers aucune réponse. Supprimer un trunk ou désactiver ses appels entrants ramène ici chaque numéro qui y pointait : un numéro qui fonctionnait peut s'y retrouver |
| trunk, no_route_found | Le numéro est dirigé vers un trunk, et ce trunk n'a aucune passerelle pour livrer l'appel. Ajoutez-en une sur la page du trunk |
| forward, aucune raison | La cible du transfert n'est plus un identifiant d'appelant vérifié. Revérifiez-la sous Caller IDs, ou transférez vers un autre numéro |
| forward, destination_not_enabled | Le second segment n'a pas pu être passé vers le pays de la cible du transfert. Activez ce pays sous Destinations |
Les plafonds du compte s'appliquent aussi aux appels entrants : au-delà du solde de votre portefeuille, de la limite de dépenses vocales quotidiennes de votre organisation, ou de vos plafonds de simultanéité et de débit par seconde, un appel entrant est rejeté avec la raison correspondante. Vue d'ensemble Voice couvre les plafonds eux-mêmes.
Vérifier le coût d'un appel reçu
La réception d'un appel est facturée. Le tarif dépend du pays et du type du numéro qui le reçoit, et est publié par pays sous Receiving calls sur la page de tarification vocale, aux côtés des tarifs pour les appels que vous passez.
Un transfert est facturé comme deux appels : l'appel entrant au tarif de réception, et le segment que nous passons au tarif sortant pour le numéro vers lequel vous transférez. Des frais de traitement uniques sont facturés une seule fois pour l'appel et non une fois par segment.
Le portefeuille est vérifié avant la livraison d'un appel entrant : un solde insuffisant pour le couvrir signifie que l'appel est rejeté plutôt que facturé après coup. Coûts et facturation couvre le fonctionnement du temps facturable, des tarifs et du portefeuille dans les deux sens.
Étapes suivantes
| Page | Ce qu'elle couvre |
|---|---|
| Trunks SIP | Créer un trunk, ses deux directions, et contrôler qui peut envoyer |
| Caller IDs | Enregistrer un numéro et prouver que vous le contrôlez |
| Journal d'appels | Chaque champ d'un enregistrement d'appel, et chaque raison de rejet |
| Événements Voice | Recevoir les résultats d'appels poussés vers vos propres systèmes |
| Dépannage Voice | Diagnostiquer un appel qui n'aboutit pas, à partir de son symptôme |
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.