Routage régional Twilio

Configurez le routage régional des numéros de téléphone Twilio afin de garantir la conformité en matière de résidence des données.

Vue d’ensemble

Le routage régional garantit que vos données de téléphonie restent dans une région géographique spécifique. Lorsque vous utilisez Twilio avec ElevenLabs dans un environnement isolé, tel qu’un hébergement des données en Europe, vous devez configurer correctement le routage régional pour respecter les exigences de résidence des données.

Ce guide explique ce qu’est le routage régional, son importance et comment le configurer correctement dans Twilio et ElevenLabs.

Qu’est-ce que le routage régional ?

Le routage régional est le mécanisme de Twilio qui garantit que les données d’appel sont traitées et stockées dans une région géographique spécifique. Considérez-le comme la résidence des données pour votre infrastructure de téléphonie.

Par défaut, les numéros de téléphone Twilio sont configurés pour être acheminés via la région US (us1), **même si le numéro de téléphone lui-même provient d’un autre pays **. Par exemple, un numéro de téléphone italien sera toujours acheminé via les États-Unis, sauf si le routage régional est explicitement configuré.

Pourquoi le routage régional est important

Lorsque vous utilisez ElevenLabs dans un environnement isolé, tel qu’un hébergement des données en Europe, tous les traitements de données doivent rester dans la région désignée. Sans configuration appropriée du routage régional :

Violations de la résidence des données : les données d’appel peuvent être acheminées via des régions non prévues
Échecs des opérations API : les opérations sur les appels en cours, comme les transferts, la mise en attente ou la reprise, échoueront
Incohérences de routage du SDK : le SDK Twilio utilise par défaut la région us1, ce qui envoie les appels API vers la mauvaise région, même lorsque Twilio a correctement acheminé l’appel côté backend

Fonctionnement

Lorsque vous importez un numéro de téléphone Twilio dans ElevenLabs :

Twilio achemine l’appel : Twilio achemine automatiquement les appels entrants vers la région configurée dans votre compte Twilio. Il peut s’agir de us1, ie1 pour l’Irlande, au1 pour l’Australie, etc.
ElevenLabs doit connaître la région : pour effectuer des opérations sur les appels en cours, comme les transferts, ElevenLabs doit envoyer les requêtes API vers la même région que celle où Twilio a acheminé l’appel
La spécification de la région évite les échecs : en indiquant la région de routage sur la plateforme ElevenLabs, nous veillons à ce que tous les appels API ciblent la bonne région Twilio

Si la région de routage n’est pas spécifiée ou est incorrecte, des opérations telles que les transferts d’appel échoueront, car les requêtes API seront envoyées vers la région us1 par défaut alors que l’appel est en réalité traité dans une autre région.

Configuration

Vérifier votre routage régional Twilio

Commencez par vérifier la région configurée pour votre numéro de téléphone Twilio :

Connectez-vous à votre console Twilio
Accédez à Phone Numbers → Manage → Active numbers
Sélectionnez votre numéro de téléphone
Recherchez la section de configuration Voice & Fax
Vérifiez le paramètre Regional routing ou Edge Location

Régions Twilio courantes :

us1 - États-Unis (par défaut)
ie1 - Irlande (Europe)
au1 - Australie
br1 - Brésil
jp1 - Japon
sg1 - Singapour

Si vous utilisez un environnement isolé, tel qu’un hébergement des données en Europe, assurez-vous que vos numéros Twilio sont configurés pour être acheminés via la région correspondante, par exemple ie1 pour l’UE.

Configurer le routage régional dans Twilio

Si votre numéro de téléphone n’est pas configuré pour la bonne région :

Dans la console Twilio, accédez à la configuration de votre numéro de téléphone
Recherchez la section Voice & Fax
Définissez Edge Location pour qu’il corresponde à la région souhaitée
Enregistrez la configuration

La configuration du routage régional dans Twilio peut nécessiter une configuration supplémentaire ou des autorisations de compte. Contactez le support Twilio si vous avez besoin d’aide pour activer le routage régional pour votre compte.

Indiquer la région de routage dans ElevenLabs

Lorsque vous importez ou configurez un numéro de téléphone Twilio dans la page Phone Numbers d’ElevenLabs :

Accédez à la configuration du numéro de téléphone
Si vous utilisez un environnement isolé, vous verrez le message d’avertissement suivant : « Vous utilisez un numéro de téléphone dans un environnement isolé. Vérifiez la région de routage de ce numéro de téléphone auprès de votre fournisseur. »
Vérifiez que la région de routage correspond à votre configuration Twilio
Assurez-vous que la région indiquée correspond à celle configurée dans votre compte Twilio
Si vous utilisez le routage régional, vous devez utiliser une clé API régionale Twilio qui correspond à votre région de routage. Votre clé API américaine standard ne fonctionnera pas pour les régions hors des États-Unis et entraînera des erreurs d’authentification. Générez une clé API spécifique à la région dans votre console Twilio.

Vérifier votre configuration

Pour vérifier que le routage régional est correctement configuré :

Vérifiez la console Twilio : confirmez que votre numéro de téléphone affiche le bon emplacement Edge
Vérifiez la plateforme ElevenLabs : assurez-vous que le paramètre de région de routage correspond à votre configuration Twilio
Testez les opérations d’appel : effectuez un appel de test et vérifiez que les opérations telles que le transfert d’appel fonctionnent correctement

Surveillez vos premiers appels dans le dashboard Calls History dashboard après avoir configuré le routage régional afin de vous assurer que tout fonctionne comme prévu.

Problèmes courants

Les transferts d’appel échouent

Cela indique généralement une incohérence de routage régional. Vérifiez que :

Votre numéro de téléphone Twilio est configuré avec le bon emplacement Edge
La région de routage indiquée dans ElevenLabs correspond à votre configuration Twilio
Vous utilisez un environnement isolé qui correspond à la région de routage

Mon numéro de téléphone vient d’Europe, mais est acheminé via les États-Unis

L’origine géographique du numéro de téléphone ne détermine pas le comportement de routage. Vous devez explicitement configurer le routage régional dans Twilio. Par défaut, tous les numéros, y compris les numéros européens, sont acheminés via us1 sauf configuration contraire.

Je n’utilise pas d’environnement isolé, en ai-je besoin ?

Si vous utilisez l’environnement ElevenLabs standard, et non un hébergement des données en Europe ou un autre environnement isolé, la configuration du routage régional est facultative.

Comment savoir quelle région utiliser ?

Choisissez une région qui :

Répond à vos exigences de résidence des données, par exemple ie1 pour une résidence des données européenne
Est la plus proche de vos utilisateurs pour une latence optimale
Correspond à votre environnement isolé ElevenLabs, le cas échéant

Je reçois des erreurs d’authentification avec mes identifiants Twilio

Si vous rencontrez des erreurs d’authentification lors de l’utilisation du routage régional, vérifiez que vous utilisez la bonne clé API régionale :

Le routage régional nécessite une clé API Twilio spécifique à la région, et non votre clé API américaine standard
Générez dans la console Twilio une nouvelle clé API limitée à votre région cible, par exemple ie1 ou au1
Mettez à jour vos identifiants dans ElevenLabs avec la clé API régionale
Votre Account SID reste le même, mais la clé API doit correspondre à la région

Bonnes pratiques

Faites correspondre les régions : assurez-vous que le routage régional Twilio correspond à votre environnement ElevenLabs
Documentez la configuration : conservez une trace des régions utilisées par chaque numéro
Testez minutieusement : vérifiez le bon fonctionnement des opérations d’appel après avoir modifié le routage régional
Surveillez les appels : recherchez dans le dashboard Calls History les échecs pouvant indiquer des problèmes de routage
Anticipez le passage à l’échelle : si vous prévoyez de vous étendre à de nouvelles régions, envisagez le routage régional dès le départ