Elastic SIP Trunking

Démarrer : Configurer votre Trunk Elastic SIP Twilio

Avant de commencer

Pour utiliser Twilio Elastic SIP Trunking, vous devez disposer d'un compte Twilio. Inscrivez-vous pour un compte Twilio gratuit si vous n'en avez pas encore.

Configurez votre Trunk Elastic SIP Twilio :

• Configurer les Trunks
  • Paramètres généraux
  • Paramètres de terminaison
  • Paramètres d'origine
  • Numéros
• Connecter votre réseau via
  • Internet public
  • Twilio Interconnect
• Adresses IP de Twilio
• Fonctionnalités
  • Codecs
  • Appels par seconde
  • Enregistrement des appels
  • Technologie de trunking sécurisée
  • Renvoi d'appel
  • Durée d'appel étendue
  • En-têtes SIP
  • Transfert d'appel via SIP REFER
  • URL de reprise après sinistre
  • Appels d'urgence
  • Nom de l'appelant : Recherches CNAM et Enregistrement CNAM
  • Appels fiables avec STIR/SHAKEN
  • Manipulation de l'en-tête SIP

Configuration requise

Pour utiliser Twilio Elastic SIP Trunking, vous devez vous assurer que vous disposez des éléments suivants :

• Un élément réseau compatible SIP (par exemple, Session Border Controller, serveur d'appels SIP, IP-PBX, SIP-PRI IAD, etc.) avec accès à Internet.

• Une bande passante suffisante pour prendre en charge le trafic d'appels maximal. La bande passante maximale peut être déterminée par :

  • Bande passante maximale des Trunks SIP = appels simultanés max. x 100 kbits/s

  La valeur de 100 kbits/s reflète la bande passante nécessaire pour le codec G711, ainsi qu'une marge suffisante pour la surcharge.

Tableau de bord

Connectez-vous à la console et accédez à la section « Elastic SIP Trunking ». Votre Tableau de bord s'affiche, fournissant un aperçu général de votre utilisation de la technologie de trunking : minutes, appels et coût.

Dans le menu de navigation de gauche, vous trouverez des liens vers :

• Overview (Présentation) : commencez ici, consultez les documents du tutoriel ou accédez aux fonctionnalités et à la tarification.
• Manage (Gérer) : accédez aux Trunks, aux listes de contrôle d'accès IP, aux listes d'informations d'identification d'utilisateur ou aux informations réseau.

Menu Manage

Dans le menu « Manage » (Gérer), vous aurez accès à tous les aspects de la configuration de vos Trunks. Plus précisément, vous aurez des liens vers :

• Trunks : répertorie vos Trunks SIP existants. Créez, supprimez et configurez vos Trunks.
• Listes de contrôle d'accès IP : gérez vos listes de contrôle d'accès IP (un ensemble d'adresses IP autorisé à atteindre votre domaine SIP).
• Listes d'informations d'identification d'utilisateur : gérez vos informations d'identification d'utilisateur (un ensemble de noms d'utilisateur et mots de passe autorisé à atteindre votre domaine SIP).
• Informations réseau : informations importantes sur la plateforme de Twilio dont vous aurez besoin pour configurer votre infrastructure de communication.

Trunks

Twilio Elastic SIP Trunking est une solution basée sur le cloud qui fournit une connectivité pour une infrastructure de communication IP pour la connexion au RTCP (Réseau téléphonique Commuté Public), pour passer et recevoir des appels téléphoniques vers le « reste du monde » via n'importe quelle connexion Internet haut débit.

Un Trunk est composé des paramètres suivants :

• Général : indiquez un nom convivial pour votre Trunk et consultez son identifiant unique (Trunk SID).
• Terminaison : configurez les paramètres pour placer le trafic sortant de votre infrastructure de communication vers le RTCP.
• Origine : configurez les paramètres de réception de trafic entrant sur vos numéros Twilio pour transmettre des appels à votre infrastructure de communication depuis le RTCP.
• Numéros : vous permet d'associer des numéros à un Trunk donné et d'afficher tous les numéros actuellement associés à un Trunk.

L'élément de la barre de navigation Trunks vous permet d'afficher une liste complète de vos Trunks Elastic SIP. Cliquez sur chacun d'eux pour modifier leur configuration. Vous avez également la possibilité de supprimer un Trunk donné de cette vue.

Créer un Trunk

Dans la barre de navigation Trunks, cliquez sur « Create New Trunk » (Créer un nouveau Trunk) pour créer un nouveau Trunk. Vous pouvez également le faire à partir de la section Getting Started.

Paramètres généraux

Ces paramètres s'appliquent à l'ensemble du Trunk, quelle que soit la direction de votre trafic.

Nom convivial

Donnez un nom convivial à votre Trunk.

Trunk SID

Il s'agit de l'identifiant unique de ce Trunk, qui est attribué automatiquement une fois que vous créez un Trunk.

Enregistrement des appels

Dans cette liste déroulante, vous pouvez activer l'enregistrement des appels pour ce Trunk. Lorsque cette option est activée, tous les appels sont enregistrés (trafic d'origine et de terminaison) dans un modèle de consommation avec paiement à l'utilisation. Des options d'enregistrement pour un seul canal ou deux canaux peuvent être sélectionnés. Le paramètre par défaut d'un Trunk est Do Not Record (ne pas enregistrer). Vous pouvez sélectionner :

• Do Not Record (Ne pas enregistrer) : l'enregistrement est désactivé sur ce Trunk.
• Record from ringing (Enregistrer dès la sonnerie) : l'enregistrement commence lorsque la sonnerie commence.
• Record from answer (Enregistrer dès la réponse) : l'enregistrement commence lorsqu'un appel est pris.
• Dual Record from ringing (Enregistrer en double dès la sonnerie) : l'enregistrement commence lorsque la sonnerie commence et les deux pistes sont visualisées séparément.
• Dual Record from answer (Enregistrer en double dès la réponse) : l'enregistrement commence lorsqu'un appel est pris et les deux pistes sont visualisées séparément. +Recording Trim* (Coupure d'enregistrement) : si cette option est activée, le silence sera coupé de l'enregistrement. Si cette option est désactivée, le silence ne sera pas coupé de l'enregistrement.

Technologie de trunking sécurisée

Le chiffrement garantit que le média d'appel et la signalisation associée restent privés pendant la transmission. Le protocole TLS (Transport Layer Security) assure le chiffrement de la signalisation SIP et le protocole SRTP (Secure Real-Time Transport Protocol) assure le chiffrement du contenu des appels/des paquets multimédias. Découvrez comment activer et résoudre les problèmes TLS à l'aide de ce blog.

Le protocole TLS est conçu pour établir une connexion sécurisée entre un client et un serveur communiquant sur un canal non sécurisé. RFC 5246, le protocole TLS (Transport Layer Security), version 1.2, spécifie la version 1.2 du protocole TLS (Transport Layer Security).

Spécifications TLS :

• Versions TLS prises en charge : TLSv1.0, TLSv1.1 et TLSv1.2.
• Chiffrements pris en charge : ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-SHA256,ECDHE-RSA-AES128-SHA256,ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-SHA384,ECDHE-RSA-AES256-SHA384,AES128-GCM-SHA256,AES128-SHA256,AES128-SHA,AES256-GCM-SHA384,AES256-SHA256,AES256-SHA

REMARQUE : Twilio recommande vivement l'utilisation du protocole TLS version 1.2

SRTP fournit un framewok pour le chiffrement RTP et RTCP. RFC 4568, Session Description Protocol (SDP) Security Description (SDES) pour Media Streams (flux multimédias), définit un tel protocole spécifiquement conçu pour échanger des éléments cryptographiques à l'aide d'un nouvel attribut crypto SDP défini.

Spécifications SRTP :

• Origine de la technologie de trunking : Une seule suite cryptographique sera incluse : AES_CM_128_HMAC_SHA1_80 Terminaison de la technologie de trunking : Les suites cryptographiques prises en charge incluent AES_CM_128_HMAC_SHA1_80 et AES_CM_128_HMAC_SHA1_32. Toutes deux peuvent être incluses dans un ordre de préférence.
• Le paramètre MKI (Master Key Identifier) en option n'est pas pris en charge.

Lorsqu'une technologie de trunking sécurisée est activée, tous les appels non chiffrés sont rejetés. Assurez-vous de configurer l'utilisation de TLS dans vos Paramètres d'origine en incluant le paramètre transport=tls. Si le paramètre de transport est présent sur l'un de vos URI spécifiant un autre transport (par exemple transport=udp), il est ignoré et TLS est utilisé. Par défaut, le port 5061 sera utilisé pour TLS, mais vous pouvez spécifier le port que vous souhaitez utiliser dans votre URI d'origine.

Importer le certificat CA racine de Twilio

TLS est utilisé pour chiffrer la signalisation SIP entre les endpoints SIP. Pour que cela fonctionne correctement, il est nécessaire que certains périphériques du réseau importent un certificat SSL. Twilio utilise les certificats d'une autorité de certification (CA). Il est important que vous ajoutiez le certificat racine suivant à votre infrastructure de communication pour établir son authenticité sur le réseau. Télécharger le certificat CA de Twilio.

Il est important de noter que Twilio utilise un certificat générique qui peut être utilisé pour plusieurs sous-domaines d'un domaine (*.pstn.twilio.com). Si votre élément réseau ne prend pas en charge les certificats génériques, désactivez la validation des certificats.

Prise en charge TLS/SRTP avec Asterisk

Asterisk est fourni par défaut avec le pilote chan_sip et fonctionne bien avec Twilio. Toutefois, si vous avez une raison d'utiliser le pilote PJSIP avec Asterisk, veuillez noter ce qui suit :

• Asterisk 13.8 cert2 est défini par défaut sur PJSIP 2.5 et ne fonctionne pas avec Twilio pour TLS/SRTP. Les appels non chiffrés fonctionnent.
• Asterisk 13.8 cert2 peut également utiliser le dernier pilote PJSIP, qui au moment de la rédaction de cet article est 2.5.5. Twilio fonctionne bien malgré l'apparition du message suivant dans votre journal :

PJSIP 2.5.5 émet l'erreur suivante, mais l'appel est toujours affiché.

Sep 27 13:03:56] ERROR[10886]: pjproject:0 :     tlsc0x7f217c03 RFC 5922 (section 7.2) n'autorise pas les certificats génériques TLS. Veuillez prévenir votre fournisseur SIP !

Le lien suivant est un guide pour l'installation d'une version non fournie de PJSIP. Remplacez la version par 2.5.5 dans les étapes.

Installer le pilote de canal PJSIP

Transfert d'appel via SIP REFER

Lorsque le transfert d'appels est activé, Twilio utilise un SIP REFER entrant depuis votre infrastructure de communication et crée un message INVITE à l'adresse dans l'en-tête Refer-To. Rendez-vous ici pour en savoir plus.

Paramètres multimédia

RTP symétrique

En général, votre infrastructure de communication IP doit utiliser votre adresse IP publique dans le SDP, et il s'agit de la SEULE destination vers laquelle Twilio enverra des médias. Cependant, si vous traversez un NAT non compatible SIP, vous ne connaissez peut-être pas votre adresse IP publique et votre SDP inclura votre adresse IP privée, ce qui entraîne généralement des problèmes audio unidirectionnels. Twilio peut résoudre ce problème en se verrouillant sur le flux multimédia RTP entrant et en envoyant le RTP vers cette destination dans le cadre de l'activation du RTP symétrique.

Lorsque le RTP symétrique est activé, Twilio détecte d'où provient le flux RTP distant et commence à envoyer le RTP à cette destination au lieu de celle négociée dans le SDP. Veuillez noter que ce paramètre est plus vulnérable aux attaques RTP.

Lorsque le RTP symétrique est désactivé, Twilio envoie le RTP à la destination négociée dans le SDP. Ce paramètre est considéré comme plus sûr, et donc recommandé.

Paramètres de terminaison

La configuration des paramètres de terminaison vous permettra de placer le trafic sortant de votre infrastructure de communication dans le RTCP. Pour utiliser un Trunk pour la terminaison, un URI SIP de terminaison et au moins un schéma d'authentification (Listes de contrôle d'accès IP et/ou Listes d'informations d'identification d'utilisateur) sont nécessaires.

URI de terminaison

Configurez un nom de domaine SIP pour identifier de manière unique votre URI SIP de terminaison pour ce Trunk. Cet URI sera utilisé par votre infrastructure de communication pour diriger le trafic SIP vers Twilio.

• {example}.pstn.twilio.com

Twilio vous recommande d'utiliser un tiret au lieu d'un point pour améliorer la lisibilité de votre domaine. Cependant, dans certains cas, vous pouvez préférer un sous-domaine comme a.b.pstn.twilio.com du domaine de niveau supérieur b.pstn.twilio.com

Un sous-domaine tel que a.b.pstn.twilio.com peut être créé selon les exigences suivantes :

• Le domaine de niveau supérieur (b.pstn.twilio.com) doit d'abord être créé.
• Le domaine de niveau supérieur (b.pstn.twilio.com) doit être créé par le même compte ou le compte parent.

Configurer un Trunk sur votre infrastructure de communication (par exemple, IP-PBX ou SBC)

Configurez un Trunk sur votre infrastructure de communication et dirigez-le vers {example}.pstn.twilio.com pour le trafic sortant en direction de Twilio.

URI de terminaison localisés

Si vous souhaitez vous connecter manuellement à un emplacement edge géographique spécifique le plus proche de l'emplacement de votre infrastructure de communication, vous pouvez le faire en pointant votre infrastructure de communication vers l'un des URI SIP de terminaison localisés suivants :

Redondance avec les URI de terminaison

Twilio Elastic SIP Trunking utilise un nom de domaine complet ou FQDN ({example}.pstn.twilio.com) comme URI de terminaison. Celui-ci est utilisé par votre infrastructure de communication pour diriger le trafic SIP vers Twilio. Comme expliqué dans la section précédente, des URI de terminaison localisés sont disponibles.

Par exemple, {example}.pstn.ashburn.twilio.com, ce FQDN spécifique est résolu dans l'enregistrement DNS A suivant :

Pour chaque emplacement edge, nous avons 3-4 adresses IP utilisées à des fins de fiabilité (voir adresses IP). Chacune de ces adresses IP représente un avantage public unique pour nos services Elastic SIP Trunking dans le cloud Twilio, distribuées sur plusieurs Availability Zones (zones de disponibilité) à des fins de fiabilité.

Il est fortement recommandé de ne pas utiliser une seule adresse IP, mais plutôt d'utiliser toutes les adresses IP et d'effectuer un basculement sur une autre adresse IP si la première ne répond pas.

Une stratégie courante, que nous déployons en interne et que nous avons demandé à nos opérateurs d'appliquer à notre égard, consiste à passer à la prochaine adresse IP au bout de 4 secondes s'il n'y a pas de réponse à une INVITE. Une seule machine derrière une seule adresse IP tombe toujours en panne à un moment donné. La solution globale doit donc prendre cela en compte et se protéger contre ces défaillances.

En outre, en cas de panne complète d'Ashburn, il est recommandé de basculer vers un autre emplacement edge (par exemple, en cas de connexion à ashburn, basculer vers umatilla), en gardant à l'esprit que l'emplacement edge résoudra à son tour 3-4 adresses IP différentes pour plus de fiabilité.

Authentification

Configurez les détails d'authentification pour garantir la sécurité/l'authenticité de votre trafic de terminaison. Vous devez configurer au minimum une ACL ou une authentification avec identifiants. Si vous configurez les deux, l'ACL et les informations d'identification sont appliquées.

Pour créer une nouvelle liste de contrôle d'accès (ACL) :

• Cliquez sur « Create IP Access Control List » (Créer une liste de contrôle d'accès IP) dans la section « Authentication » (Authentification).
• Attribuez à la liste de contrôle d'accès un nom descriptif pour cette liste d'adresses IP. Quelque chose comme « Adresses IP du centre de données Dallas ».
• Ajoutez des adresse IP à votre nouvelle liste de contrôle d'accès (il s'agit des adresses IP utilisées pour le trafic SIP sortant par les éléments de périphérie de votre infrastructure de communication, par exemple SBC).
• Attribuez à vos adresses IP un nom convivial qui décrit l'adresse IP, par exemple « SBC de production ».
• Cliquez sur « Create ACL » (Créer une ACL).

Pour créer une nouvelle liste d'informations d'identification d'utilisateur :

• Cliquez sur « Create Credential List » (Créer une liste d'informations d'identification d'utilisateur) dans la section « Authentication » (Authentification).
• Attribuez à la liste d'informations d'identification d'utilisateur un nom convivial qui décrit l'utilisateur que vous authentifiez. Quelque chose comme « Admin, Twilio ».
• Saisissez un nom d'utilisateur (il doit s'agir du nom d'utilisateur utilisé pour l'authentification Digest liée au trafic SIP sortant par les éléments de périphérie de votre infrastructure de communication, par exemple SBC).
• Saisissez le mot de passe correspondant à cet utilisateur.
• Cliquez sur « Create Credentials list » (Créer une liste d'informations d'identification).

Si vous utilisez les informations d'identification de l'utilisateur, votre INVITE SIP sera associée à une erreur 407 Proxy Authentication Required demandant les informations d'identification appropriées de l'utilisateur.

À la fin de cette étape, votre Trunk sera en mesure de traiter les appels de terminaison de votre infrastructure de communication, via Twilio, vers le RTCP.

Numéros d'ID de l'appelant autorisés dans les appels de terminaison

Vous devez spécifier un numéro d'ID de l'appelant qui correspond soit à un DID Twilio sur votre compte, soit à un numéro d'ID de l'appelant vérifié sur la console ou avec l'API d'ID de l'appelant sortant.

Si aucun numéro d'ID de l'appelant n'est spécifié dans le champ From (De) de l'INVITE SIP, l'ID de l'appelant distant ou l'identité assertée P sera utilisé.

Paramètres d'origine

La configuration des paramètres d'origine vous permettra de recevoir du trafic entrant du RTCP vers un numéro Twilio, transmis à votre infrastructure de communication. Avec des numéros de téléphone disponibles dans plus de 100 pays, Twilio vous offre un Trunk SIP véritablement mondial. Au moins un numéro Twilio doit être associé à ce Trunk si vous le configurez pour l'origine.

Les paramètres d'origine configurés dans cette section s'appliquent à tous les numéros associés à ce Trunk.

URI SIP d'origine

Configurez votre URI SIP d'origine, qui identifie le point d'entrée de l'élément réseau vers votre infrastructure de communication (par exemple, IP-PBX, SBC). La partie hôte de l'URI SIP peut être une adresse IP ou un nom de domaine complet (FQDN).

• sip:172.56.42.132
• • sip:mysbc.com

Twilio renseigne automatiquement la partie utilisateur de l'URI SIP en fonction du numéro Twilio auquel l'appel du RTCP est destiné. Par exemple, si l'appel du RTCP est reçu pour le numéro Twilio +14158675309, qui est associé à ce Trunk, l'URI résultant envoyé à votre infrastructure de communication sera :

• sip:+14158675309@172.56.42.132
• sip:+14158675309@mysbc.com

Vous pouvez également configurer une partie utilisateur spécifique (par exemple « anniebp ») dans l'URI SIP d'origine. Notez que le même URI sera utilisé pour tous les numéros associés à ce Trunk. Par conséquent, si l'appel du RTCP est reçu pour le numéro Twilio +14158675309, qui est associé au Trunk, l'URI qui en résulte vers votre infrastructure de communication sera toujours le suivant pour tous les numéros de téléphone :

• sip:anniebp@172.56.42.132
• sip:anniebp@mysbc.com

Remarque : Le numéro Twilio composé (+14158675309) sera toujours transmis dans un en-tête SIP Diversion pour les appels d'origine de la technologie de trunking.

En-têtes X

Il est possible d'envoyer n'importe quel en-tête SIP commençant par le préfixe X-, en l'ajoutant à l'URI SIP d'origine. Par exemple, vous pouvez configurer : sip:+14158675309@mysbc.com?X-myheader=foo pour envoyer X-myheader:foo sur tous les appels d'origine.

Paramètre transport

Par défaut, Twilio envoie des requêtes SIP d'origine à votre infrastructure de communication via UDP. Elles peuvent être personnalisées pour être envoyées sur TCP plutôt que sur UDP. Modifiez ce paramètre en utilisant le paramètre de transport dans l'URI SIP d'origine :

• sip:anniebp@172.56.42.132;transport=tcp

Vous pouvez également les personnaliser pour utiliser TLS pour la signalisation SIP. Lors de l'utilisation de TLS, le port par défaut est 5061, mais un autre port peut être spécifié. Modifiez ce paramètre en utilisant le paramètre de transport dans l'URI SIP d'origine et, éventuellement, en spécifiant un numéro de port différent :

• sip:anniebp@172.56.42.132:5062;transport=tls

Paramètre edge

Pour spécifier le paramètre edge géographique à partir duquel Twilio enverra le trafic SIP d'origine vers votre infrastructure de communication, vous devez inclure le paramètre edge dans votre URI SIP d'origine. Par exemple, si le paramètre edge=dublin provient de votre URI SIP d'origine, Twilio enverra le trafic SIP depuis l'emplacement edge Europe/Irlande :

• sip:anniebp@172.56.42.132;edge=dublin

Si le paramètre edge n'est pas spécifié, Twilio enverra le trafic SIP d'origine à partir de l'emplacement edge où l'appel RTCP entrant arrive.

Remarque : Vous devez vous assurer d'autoriser les adresses IP de l'emplacement edge Twilio pour la signalisation SIP et le trafic multimédia RTP.

Utiliser plusieurs URI SIP d'origine

Il est possible de configurer jusqu'à dix (10) URI SIP d'origine présentant une pondération et une priorité différentes.

Le champ de priorité détermine la priorité d'utilisation de l'URI SIP. Twilio utilise toujours l'URI SIP avec la valeur de priorité la plus faible en premier, et passe à d'autres URI SIP de valeur égale ou supérieure si la session de cet URI SIP échoue.

Si un service possède plusieurs URI SIP d'origine avec la même valeur de priorité, Twilio utilise le champ de pondération pour déterminer quel URI SIP utiliser. La valeur de pondération n'est pertinente que par rapport aux autres URI SIP ayant la même valeur de priorité.

Priority classe l'importance de l'URI. Les valeurs vont de 0 à 65535, le nombre le plus bas représentant l'importance la plus élevée. Weight est utilisé pour déterminer la part de charge lorsque plusieurs URI ont la même priorité. Ses valeurs vont de 1 à 65535. Plus la valeur est élevée, plus un URI est chargé.

Il est possible d'activer ou de désactiver un URI SIP d'origine. Lorsqu'un URI SIP d'origine est activé, il est actif dans la sélection de route. S'il n'est pas activé, il n'est pas utilisé pour acheminer le trafic vers votre infrastructure de communication.

Dans l'exemple suivant, les champs de priorité et de pondération sont utilisés pour fournir une combinaison de services d'équilibrage de charge et de basculement.

Les trois premières URI SIP ont une priorité de 10. La valeur du champ de pondération est donc utilisée par Twilio pour déterminer le serveur à contacter. La somme des trois valeurs est de 100, donc sip:mysbc1.com sera utilisé 60 % du temps. Les deux URI SIP sip:mysbc2.com et sip:mysbc3.com seront utilisés pour 20 % des demandes chacun. Si sip:mysbc1.com est indisponible, les deux machines restantes partagent la charge de façon égale, car elles sont sélectionnées 50 % du temps.

Si aucun des trois serveurs avec la priorité 10 n'est disponible, l'enregistrement avec la valeur de priorité la plus basse suivante est choisi, c'est-à-dire sip:mysbc-backup.com. Remarque : Si l'un des codes d'état SIP suivants est renvoyé (« 2xx », « 400 », « 404 », « 405 », « 410 », « 416 », « 482 », « 484 », « 486 », « 6xx »), Twilio ne basculera pas vers l'URI SIP d'origine suivant. S'il n'y a pas de réponse SIP d'un serveur donné, Twilio bascule au bout de 4 secondes.

URL de reprise après sinistre

En cas de sinistre empêchant la transmission de vos appels à votre URI SIP d'origine ci-dessus, vous pouvez configurer une URL de reprise après sinistre pointant vers une application construite sur le puissant outil de script de Twilio, appelé TwiML. Vous pouvez utiliser TwiML pour construire une application qui gérera les appels selon les besoins de votre plan de reprise après sinistre, y compris la réplication des fonctionnalités de votre PBX (par exemple, SVI ou serveur vocal interactif).

• http://fallback.mycompany.com/index

Pour plus d'informations sur la construction de votre application TwiML, reportez-vous au Quickstart Twilio et au guide d'API TwiML. Veuillez noter que lorsque les appels sont redirigés vers votre URL de reprise après sinistre, les tarifs Twilio Voice normaux s'appliquent (voir tarifs voice).

Recherches CNAM

CNAM est un acronyme qui signifie Caller ID Name (Nom de l'ID de l'appelant). CNAM est utilisé pour afficher le nom de l'appelant avec le numéro de téléphone, afin d'aider les utilisateurs à identifier facilement un appelant.

Lorsque vous activez la recherche CNAM, le nom de l'ID de l'appelant est inséré dans l'INVITE SIP via les champs « From », « Contact » et « P-Asserted-Identity » (le cas échéant) pour chaque appelant.

Notez que les recherches CNAM pour les numéros US/CA sont facturées par recherche, même si les données peuvent ne pas être disponibles. Actuellement, la requête de recherche de nom d'ID d'appelant pour les numéros internationaux renvoie des valeurs nulles, mais n'est pas facturée.

Activer cette fonction à l'aide de la console Twilio :

Pour activer la recherche CNAM à l'aide de la console, connectez-vous à la console et accédez à la section « Elastic SIP Trunking ».

Après avoir sélectionné un Trunk, accédez aux paramètres d'origine (via le sous-menu de gauche). Ici, vous verrez un bouton qui vous permet d'activer la recherche CNAM. Vous saurez que le réglage a été activé lorsque le bouton est bleu et le mot « ENABLED » (Activé) s'affiche.

• La recherche CNAM doit être activée par Trunk.
• La recherche CNAM n'est prise en charge que pour les numéros de téléphone US/CA.
• La recherche CNAM est facturée par recherche réussie (cela inclut le cas où le nom n'est pas disponible pour un numéro dans les bases de données CNAM National). On sait que de nombreux numéros AT&T ne sont pas publiés dans les bases de données CNAM National.
• La recherche CNAM est facturée par recherche réussie, même si l'appel lui-même échoue.

Renvoi d'appel

Le renvoi d'appel vous permet de rediriger un appel d'origine Trunking. Votre infrastructure de communication peut rediriger une INVITE entrante en répondant par un SIP 302 (déplacé temporairement). Cette réponse contient un champ d'en-tête de contact avec les nouvelles adresses à essayer.

• Twilio prend en charge un seul renvoi par appel :
  • Si une cible redirigée envoie également une réponse SIP 302 à une autre cible, Twilio échoue à l'appel.
  • Twilio respecte la première URI de la réponse SIP 302 : Plusieurs URI dans l'en-tête SIP Contact à l'exception du premier ou plusieurs en-têtes SIP Contact à l'exception du premier seront ignorés.
• Les renvois d'appel vers les domaines Twilio (*.sip.twilio.com ou *.pstn.twilio.com) ne sont pas pris en charge.
• Si l'appel est vers un endpoint SIP enregistré, le renvoi n'est pas autorisé.
• Le paramètre edge n'est pas pris en charge dans un URI de contact SIP 302. L'appel redirigé utilisera le même emplacement edge en sortie que l'appel d'origine.
• Le paramètre tnx n'est pas pris en charge dans un URI de contact SIP 302. L'appel redirigé utilisera la même connexion d'interconnexion que l'appel d'origine. . + Si la technologie de trunking sécurisée a été utilisée pour l'INVITE d'origine, l'appel redirigé utilisera également TLS/SRTP.
• Si l'enregistrement des appels a été utilisé pour l'INVITE d'origine, l'appel redirigé sera également enregistré.

En-têtes SIP Diversion

Origine de la technologie de trunking

Lorsque Twilio reçoit un trafic entrant sur vos numéros Twilio du RTCP, qui doit être dirigé vers votre infrastructure de communication, il ajoute un en-tête SIP Diversion indiquant le numéro Twilio qui a été composé. Cet en-tête sert d'enregistrement historique qui indique que l'appel a été transféré du numéro composé vers l'URI SIP d'origine de votre Trunk SIP. L'exemple ci-dessous illustre un en-tête Diversion.

Diversion : <sip:+14155550000@twilio.com>

Terminaison de la technologie de trunking

Lorsque Twilio reçoit un trafic sortant de votre infrastructure de communication dans le RTCP, votre message SIP peut parfois inclure des en-têtes SIP Diversion si l'appel a précédemment transféré. Twilio transmettra les en-têtes SIP Diversion qu'il reçoit aux opérateurs.

Recevoir un premier appel d'origine

Effectuez votre premier appel test en composant le numéro Twilio de votre Trunk, par exemple +14158675309, et assurez-vous que votre extension d'infrastructure de communication correspondante sonne.

Supprimer un Trunk

Vous pouvez supprimer un Trunk :

• Dans la section « Trunks » (Trunks), à l'aide de la liste des Trunks affichée. Notez que quand vous procédez ainsi, tous les numéros associés à ce Trunk sont automatiquement dissociés du Trunk, mais ne sont pas libérés. Pour les libérer, accédez à la section « Voice and Messaging » (Voix et messagerie), cliquez sur « Numbers » (Numéros) et libérez les numéros souhaités dans cette section.
• Depuis n'importe quel écran de configuration spécifique du Trunk, à l'aide de l'option « Delete this Trunk » (Supprimer ce Trunk).

Notez que lorsque vous effectuez cette opération, tous les numéros précédemment associés à ce Trunk sont dissociés du Trunk, mais ils ne sont pas libérés de votre compte. Les numéros de téléphone Twilio sont facturés mensuellement. À moins que vous n'utilisiez activement un numéro, ou que vous ne souhaitiez conserver un numéro réservé pour une utilisation ultérieure, vous pouvez réduire vos coûts en libérant vos numéros inutilisés. Pour libérer un numéro, accédez à la section « Voice and Messaging » (Voix et messagerie), cliquez sur « Numbers » (Numéros) et libérez le numéro souhaité dans cette section.

Votre réseau

Préparez votre infrastructure de communication pour vous assurer que votre infrastructure SIP dispose d'une connectivité à Twilio et vice versa.

• Configurez les URI de terminaison de votre Trunk Twilio en utilisant éventuellement un URI de terminaison localisé si vous souhaitez vous connecter manuellement à un emplacement edge géographique spécifique de la plateforme Twilio.
• Autorisez tous les ports et adresses IP de signalisation et multimédia de Twilio sur votre pare-feu.
• Configurez votre infrastructure pour qu'elle ne s'enregistre pas pour ce Trunk.
• Assurez-vous que votre infrastructure enverra une valeur minimale de 20 pour Max-Forwards afin de garantir le traitement réussi de votre appel.
• Assurez-vous que tous les numéros de téléphone envoyés via SIP à Twilio sont toujours au format E.164.
• Configurez éventuellement votre infrastructure de communication pour émettre des messages d'OPTIONS SIP comme mécanisme ping vers votre Trunk Elastic SIP (Envoyer la demande de message à : URI de terminaison que vous avez créé (example.pstn.twilio.com)) ; la plateforme Twilio répondra en conséquence. Veuillez conserver une valeur ping inférieure à 1 OPTION SIP toutes les 10-15 secondes pour éviter que vos demandes ne soient interdites par notre plateforme.

Déployer derrière un NAT

Si vous effectuez un déploiement derrière un NAT sans protocole Session Border Controller, il est important de maintenir la liaison de traduction NAT ouverte.

• Pour la signalisation, lors de l'utilisation d'UDP, cela peut être réalisé en envoyant périodiquement des OPTIONS SIP à Twilio, qui répondra par le code 200OK.
• Pour la signalisation, lors de l'utilisation de TCP ou TLS, cela peut être réalisé en envoyant périodiquement des OPTIONS SIP à Twilio, ou des CR-LF de maintien en activité (en envoyant périodiquement un double CRLF (le « ping »), puis en attendant de recevoir un seul CRLF (le « pong ») de Twilio), ce dernier ayant la plus petite surcharge.
• Pour RTP, il s'agit généralement moins d'un problème car les paquets de média sont envoyés plus fréquemment.

Adresses IP

Vous DEVEZ autoriser L'ENSEMBLE des plages d'adresses IP et ports suivants de Twilio sur votre pare-feu pour la signalisation SIP et le trafic multimédia RTP. Ceci est important si vous avez des numéros à différents emplacements de périphérie et à des fins de résilience (par exemple, si les passerelles de l'Amérique du Nord en Virginie sont hors service, les passerelles de l'Amérique du Nord en Oregon seront utilisées). Twilio ne garantit pas l'emplacement edge d'où le média sera émis, sans utiliser le paramètre edge, car il peut dépendre de la passerelle PSTN-SIP qui fournit l'appel à l'emplacement edge Twilio.

Pour obtenir la liste complète, reportez-vous à la section Elastic SIP Trunking adresses IP de Twilio.

Pour plus d'informations sur la configuration de votre infrastructure avec votre Trunk Twilio Elastic SIP, reportez-vous aux guides de configuration SIP Trunking.