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, Recevoir des appels et Passer des appels.

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é.
• 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.

1. Créer le trunk

Ouvrez 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 :

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 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.

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 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, 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.

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.

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.
• 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.

9. Activer les pays que vous appelez

Ouvrez 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.

10. Testez les deux sens

1. Entrant : appelez votre numéro Bird depuis un téléphone ordinaire, puis ouvrez 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, qui part du symptôme.

Étapes suivantes