--- title: "Configurer un trunk SIP pour recevoir et passer des appels" description: "Connectez votre PBX ou votre SBC à Bird dans l’ordre : créez le trunk, acheminez les appels entrants vers vos passerelles, ouvrez les appels sortants, puis testez les deux sens." canonical: "https://bird.com/fr-fr/documentation/guides/voice/sip-trunk-setup" --- # Configurer un trunk SIP pour recevoir et passer des appels Cette page décrit la configuration complète d’un trunk, dans l’ordre imposé par le tableau de bord. Lorsque l’omission d’une étape produit un symptôme visible, l’étape l’indique : vous pouvez donc aussi utiliser la page comme liste de contrôle lorsqu’un appel de test échoue. Pour le sens de chaque paramètre, suivez les liens vers [Trunks SIP](/docs/guides/voice/sip-trunks), [Recevoir des appels](/docs/guides/voice/receiving-calls) et [Passer des appels](/docs/guides/voice/placing-calls). ## Avant de commencer - Un espace de travail Bird. Les appels, les numéros et les trunks appartiennent à un seul espace de travail : effectuez donc toutes les étapes dans le même. - Les adresses publiques de votre équipement : les hôtes vers lesquels Bird doit acheminer les appels, et les adresses depuis lesquelles votre équipement envoie le SIP. - Pour les appels entrants, un numéro Bird dans cet espace de travail. Pour les appels sortants, un identifiant d’appelant : un numéro Bird de l’espace de travail ou un numéro que vous avez [vérifié](/docs/guides/voice/caller-ids). - Un numéro Bird dont le `status` est `active`. Un numéro encore en attente de ses justificatifs de propriété ou de son enregistrement ne transmet aucun appel entrant ni sortant : consultez [Déposer les justificatifs de propriété d’un numéro](/docs/guides/numbers/ownership-paperwork). ## 1. Créer le trunk Ouvrez **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), sélectionnez **Add new SIP trunk**, saisissez un nom, puis sélectionnez **Create trunk**. Un nouveau trunk ne transmet aucun appel, dans aucun sens, tant que vous n’avez pas activé chaque sens. ## 2. Activer les appels entrants Sous **Inbound calling**, sélectionnez **Enable inbound**. La section **Inbound routing** apparaît en dessous. Si vous sautez cette étape, vous ne pouvez pas diriger de numéros vers le trunk : le trunk n'apparaît pas dans la liste des trunks du numéro. ## 3. Ajouter vos passerelles Dans **Inbound routing**, ouvrez l'onglet **Gateways** et sélectionnez **Add gateway** pour chaque adresse à laquelle Bird doit acheminer les appels : | Champ | Valeur à saisir | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Name** | Un libellé facile à reconnaître, par exemple `Primary SBC` | | **Host** | Le nom d'hôte ou l'adresse IP publique de votre équipement, sans `sip:` ni partie utilisateur | | **Port** | Laissez vide pour utiliser le port par défaut du transport, ou saisissez le port sur lequel votre équipement écoute | | **Transport** | UDP, TCP ou TLS, selon votre équipement | | **R-URI user part** | Format du numéro composé dans la Request-URI. Par défaut, E.164 avec `+` | | **Origination format** | Format du numéro appelant. Par défaut, E.164 avec `+` | | **Priority** | Rang de la passerelle dans **All gateways (automatic)** : les numéros les plus bas sonnent en premier, et les numéros égaux se partagent les appels. Par défaut, 0 | Si votre équipement attend des numéros sans le `+` initial, ouvrez la liste du format et choisissez **Without the plus**, ou un préfixe international `00` ou `011`. [Ce dont une passerelle a besoin](/docs/guides/voice/receiving-calls#what-a-gateway-needs) explique les formats de numéro. Bird transmet l'en-tête `To` tel que l'opérateur de l'appelant l'a envoyé. Si votre équipement lit le numéro composé dans `To`, sélectionnez **Rewrite To user part** et construisez le même format que pour **R-URI user part**. Bird remplace alors la partie utilisateur de `To` pour les appels vers cette passerelle. Votre passerelle doit accepter les appels de Bird sans challenge Digest SIP, car Bird n'y répond pas. ## 4. Choisir le groupe dans lequel les appels sont recherchés Bird achemine chaque appel vers un groupe de passerelles. Toutes les passerelles figurent dans **All gateways (automatic)**, qui les essaie dans l'ordre de leur **Priority** dans l'onglet **Gateways**, de la plus basse à la plus élevée. Pour le basculement en cas de panne via ce groupe, attribuez à la passerelle de secours un numéro de **Priority** plus élevé que celui de la passerelle principale. Si l'onglet **Groups** n'affiche pas **All gateways (automatic)**, le routage enregistré du trunk contient à la place un groupe qui lui est propre, et **Priority** ne détermine pas l'ordre de ce groupe ; consultez [Utiliser le groupe automatique](/docs/guides/voice/hunt-groups#use-the-automatic-group). Lorsque vous ajoutez la première passerelle à un trunk dont le routage n'a jamais été enregistré, le tableau de bord dirige la route par défaut vers **All gateways (automatic)**. Pour d'autres durées de sonnerie, d'autres pondérations ou une partie seulement des passerelles, créez votre propre groupe : dans l'onglet **Groups**, sélectionnez **Add group**, nommez le groupe, puis utilisez **Add gateway to group** pour chaque passerelle. [Basculer et répartir les appels entrants](/docs/guides/voice/hunt-groups) explique chaque ordre, la durée de sonnerie et le moment où la recherche s'arrête. ## 5. Diriger la route par défaut vers le groupe Dans l'onglet **Rules**, repérez **Default route** (**No rule above matched**). Réglez **Then** sur **Route to group** et choisissez votre groupe. Sélectionnez **Review and save**, puis confirmez. La route par défaut traite chaque appel auquel aucune règle ne correspond : sans règle, elle traite donc tous les appels. Si elle est réglée sur **Reject**, ces appels sont refusés avant d'atteindre votre équipement, même si des passerelles figurent dans un groupe. Lors de la vérification, le tableau de bord affiche l'avertissement **Calls never reach some gateways** lorsqu'une passerelle n'appartient à aucun groupe vers lequel une règle ou la route par défaut envoie des appels. Corrigez cet avertissement avant de tester. Cette route par défaut appartient au trunk. Elle est distincte du paramètre d'espace de travail **Calls to numbers without their own route** de la page **Numbers**, qui détermine le sort des numéros sans route propre. ## 6. Diriger vos numéros vers le trunk Ouvrez **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), ouvrez le numéro et, sous **Inbound routing**, choisissez **Deliver to a SIP trunk**. Sélectionnez le trunk et enregistrez. Un numéro sans route propre suit la route par défaut de l'espace de travail, initialement réglée sur le rejet. Pour envoyer d'un coup tous ces numéros vers ce trunk, réglez **Calls to numbers without their own route** sur le trunk. Consultez [Définir une route par défaut](/docs/guides/voice/receiving-calls#set-a-default-route). Si vous sautez cette étape alors que la route par défaut de l'espace de travail est encore réglée sur le rejet, les appels entrants sont rejetés et le champ **Inbound route** de l'enregistrement d'appel indique **Reject the leg**. ## 7. Activer les appels sortants et indiquer qui peut en émettre Sous **Outbound calling**, sélectionnez **Enable outbound**. La section **Connection** apparaît avec le **SIP domain** du trunk. Bird identifie votre trunk par ce domaine : copiez-le donc en entier. Ajoutez ensuite au moins un moyen de reconnaître votre équipement : - **Allowed IP addresses** : les adresses publiques depuis lesquelles votre équipement envoie SIP. Derrière un NAT, utilisez l’adresse publique du routeur. - **Allowed API keys** : pour un équipement qui répond à un challenge Digest, avec le nom d’utilisateur `bird` et le secret d’une clé API comme mot de passe. Tant que les appels sortants ne sont pas activés, le trunk refuse tout appel sortant. Tant que le trunk ne peut pas reconnaître votre équipement, les appels sont refusés avant même la création d’un enregistrement d’appel. Consultez [Contrôler qui peut envoyer des appels](/docs/guides/voice/sip-trunks#controlling-who-may-send-calls). ## 8. Configurer votre PBX ou SBC Sur votre PBX ou SBC : - **Envoyez les appels sortants vers le domaine SIP du trunk.** Indiquez le domaine SIP comme hôte de la Request-URI. Utilisez le port `5060` (UDP ou TCP) ou `5061` (TLS). Un appel dont l’hôte de la Request-URI porte un autre nom est refusé. - **Composez les numéros au format international.** Indiquez le numéro appelé dans la partie utilisateur de la Request-URI avec `+` suivi de l’indicatif du pays, par exemple `+442071234567`. N’ajoutez pas de préfixe technique. Consultez [Ce que Bird attend dans l’INVITE](/docs/guides/voice/placing-calls#what-bird-expects-on-the-invite). - **Présentez un identifiant d’appelant autorisé** dans l’en-tête `From`. - **Proposez G.711** (loi A ou loi µ) et envoyez les DTMF sous forme d’événements téléphoniques RFC 4733. La même section de cette page traite des médias. - **Autorisez les adresses de Bird.** Si votre pare-feu ou votre SBC n’accepte que des adresses listées, autorisez les adresses de signalisation et de média de la région de votre trunk, listées dans [Exigences réseau des trunks SIP](/docs/guides/voice/network-requirements). ## 9. Activer les pays que vous appelez Ouvrez **Voice** > [**Destinations**](https://bird.com/dashboard/w/voice/destinations), cochez chaque pays que vous appelez, puis sélectionnez **Save changes**. Dans un nouvel espace de travail, aucun pays n'est activé, et un appel vers un pays désactivé est rejeté avec `destination_not_enabled`. Consultez [Destinations vocales](/docs/guides/voice/destinations). ## 10. Testez les deux sens 1. **Entrant :** appelez votre numéro Bird depuis un téléphone ordinaire, puis ouvrez **Voice** > [**Legs**](https://bird.com/dashboard/w/voice/legs) dans le même espace de travail. 2. **Sortant :** passez un appel depuis votre équipement vers n'importe quel numéro joignable d'un pays activé, en présentant comme identifiant d'appelant votre numéro Bird ou un numéro vérifié. Vous n'avez pas besoin d'un second numéro Bird pour ce test. 3. Ouvrez chaque leg. **Inbound route** indique ce que le numéro était configuré pour faire. Un appel rejeté affiche son motif et, lorsque la correction porte sur l'un de vos paramètres, un lien vers ce paramètre. Un appel réussi affiche **Answered**. Conservez le **Leg ID** si vous contactez le support. Si un appel est absent, rejeté ou n'atteint jamais votre équipement, suivez [Dépannage de la voix](/docs/guides/voice/troubleshooting), qui part du symptôme. ## Étapes suivantes | Page | Contenu | | ---------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [Trunks SIP](/docs/guides/voice/sip-trunks) | Tous les paramètres du trunk, l'authentification et Digest | | [Recevoir des appels](/docs/guides/voice/receiving-calls) | Routes des numéros, passerelles, groupes et route par défaut de l’espace de travail | | [Passer des appels](/docs/guides/voice/placing-calls) | Ce que Bird attend dans le `INVITE` | | [Dépannage de la voix](/docs/guides/voice/troubleshooting) | Diagnostiquer un appel à partir de son symptôme | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/voice-api) (product) - [Voice overview](/docs/guides/voice/overview) (docs) [Get an implementation brief](/learn/workspace?topic=voice)