# 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**](https://bird.com/dashboard/w/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](/docs/guides/voice/sip-trunks) avec les appels entrants activés et au moins une passerelle de livraison. - **Pour un transfert :** un [identifiant d'appelant vérifié](/docs/guides/voice/caller-ids) 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. 1. Ouvrez **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), ouvrez le trunk, et sous **Inbound calling** sélectionnez **Enable inbound**. 2. 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. 3. Ouvrez **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), ouvrez le numéro, et sous **Inbound routing** choisissez **Deliver to a SIP trunk**. 4. 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. 1. Ouvrez **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), ouvrez le numéro, et sous **Inbound routing** choisissez **Forward to another number**. 2. 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. 3. 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](/docs/guides/voice/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**](https://bird.com/dashboard/w/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}`](/docs/api/reference/get-voice-call) et [`GET /v1/voice/calls`](/docs/api/reference/list-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](/docs/guides/voice/call-log#rejected-calls) 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](/docs/guides/voice/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](/docs/guides/voice/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](/docs/guides/voice/overview#limits) 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](/pricing/voice), 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](/docs/guides/voice/placing-calls#cost-and-billing) couvre le fonctionnement du temps facturable, des tarifs et du portefeuille dans les deux sens. ## Étapes suivantes | Page | Ce qu'elle couvre | | ----------------------------------------------------- | ------------------------------------------------------------------- | | [Trunks SIP](/docs/guides/voice/sip-trunks) | Créer un trunk, ses deux directions, et contrôler qui peut envoyer | | [Caller IDs](/docs/guides/voice/caller-ids) | Enregistrer un numéro et prouver que vous le contrôlez | | [Journal d'appels](/docs/guides/voice/call-log) | Chaque champ d'un enregistrement d'appel, et chaque raison de rejet | | [Événements Voice](/docs/guides/voice/events) | Recevoir les résultats d'appels poussés vers vos propres systèmes | | [Dépannage Voice](/docs/guides/voice/troubleshooting) | Diagnostiquer un appel qui n'aboutit pas, à partir de son symptôme | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/products/voice) (product) [Get an implementation brief](/learn/workspace?topic=voice)