Regionale Twilio-routering | ElevenLabs Documentation

Overzicht

Regionale routing zorgt ervoor dat je telefoniedata binnen een specifieke geografische regio blijft. Wanneer je Twilio met ElevenLabs gebruikt in een geïsoleerde omgeving (zoals EU-residency), moet je regionale routing correct configureren om te voldoen aan vereisten voor dataresidentie.

Deze handleiding legt uit wat regionale routing is, waarom het belangrijk is en hoe je dit correct configureert in zowel Twilio als ElevenLabs.

Wat is regionale routing?

Regionale routing is het mechanisme van Twilio dat ervoor zorgt dat oproepgegevens binnen een specifieke geografische regio worden verwerkt en opgeslagen. Zie het als dataresidentie voor je telefonie-infrastructuur.

Twilio-telefoonnummers zijn standaard geconfigureerd om via de Amerikaanse regio (us1) te worden gerouteerd, **zelfs als het telefoonnummer zelf uit een ander land komt **. Een Italiaans telefoonnummer wordt bijvoorbeeld nog steeds via de VS gerouteerd, tenzij je regionale routing expliciet configureert.

Waarom regionale routing belangrijk is

Wanneer je ElevenLabs in een geïsoleerde omgeving gebruikt (zoals EU-residency), moet alle gegevensverwerking binnen je aangewezen regio blijven. Zonder correcte configuratie van regionale routing:

Schendingen van dataresidentie: Oproepgegevens kunnen via onbedoelde regio’s worden gerouteerd
Mislukte API-bewerkingen: Bewerkingen op lopende oproepen (zoals doorverbinden, in de wacht zetten en hervatten) mislukken
Afwijkingen in SDK-routing: De Twilio SDK gebruikt standaard de regio us1, waardoor API-calls naar de verkeerde regio worden gestuurd, zelfs wanneer Twilio de oproep in de backend correct heeft gerouteerd

Zo werkt het

Wanneer je een Twilio-telefoonnummer naar ElevenLabs importeert:

Twilio routeert de oproep: Twilio routeert inkomende oproepen automatisch naar de regio die in je Twilio-account is geconfigureerd (dit kan us1, ie1 voor Ierland, au1 voor Australië enzovoort zijn)
ElevenLabs moet de regio kennen: Om bewerkingen op lopende oproepen uit te voeren (zoals doorverbinden), moet ElevenLabs API-requests naar dezelfde regio sturen waar Twilio de oproep naartoe heeft gerouteerd
Regiospecificatie voorkomt fouten: Door de routingregio op het ElevenLabs-platform op te geven, zorgen we ervoor dat alle API-calls op de juiste Twilio-regio zijn gericht

Als de routingregio niet is opgegeven of onjuist is, mislukken bewerkingen zoals het doorverbinden van oproepen, omdat de API-requests naar de standaardregio us1 worden gestuurd terwijl de daadwerkelijke oproep in een andere regio wordt afgehandeld.

Configuratie

Controleer je regionale Twilio-routing

Controleer eerst voor welke regio je Twilio-telefoonnummer is geconfigureerd:

Log in bij je Twilio Console
Ga naar Phone Numbers → Manage → Active numbers
Selecteer je telefoonnummer
Zoek de configuratiesectie Voice & Fax
Controleer de instelling Regional routing of Edge Location

Veelvoorkomende Twilio-regio’s:

us1 - Verenigde Staten (standaard)
ie1 - Ierland (Europa)
au1 - Australië
br1 - Brazilië
jp1 - Japan
sg1 - Singapore

Als je een geïsoleerde omgeving gebruikt (zoals EU-residency), zorg er dan voor dat je Twilio-nummers zijn geconfigureerd om via de overeenkomende regio te routeren (bijvoorbeeld ie1 voor de EU).

Configureer regionale routing in Twilio

Als je telefoonnummer niet voor de juiste regio is geconfigureerd:

Ga in de Twilio Console naar de configuratie van je telefoonnummer
Zoek de sectie Voice & Fax
Stel Edge Location in op de gewenste regio
Sla de configuratie op

De configuratie van regionale routing in Twilio kan aanvullende instellingen of accountmachtigingen vereisen. Neem contact op met Twilio Support als je hulp nodig hebt bij het inschakelen van regionale routing voor je account.

Geef de routingregio op in ElevenLabs

Wanneer je een Twilio-telefoonnummer importeert of configureert op de ElevenLabs-pagina Phone Numbers:

Ga naar de telefoonnummerconfiguratie
Als je een geïsoleerde omgeving gebruikt, zie je een waarschuwing met de tekst: “Je gebruikt een telefoonnummer in een geïsoleerde omgeving. Controleer de routingregio voor dit telefoonnummer bij je provider.”
Controleer of de routingregio overeenkomt met je Twilio-configuratie
Zorg ervoor dat de opgegeven regio overeenkomt met de regio die in je Twilio-account is geconfigureerd
Als je regionale routing gebruikt, moet je een regionale API-sleutel van Twilio gebruiken die overeenkomt met je routingregio. Je standaard Amerikaanse API-sleutel werkt niet voor regio’s buiten de VS en leidt tot authenticatiefouten. Genereer een regiospecifieke API-sleutel in je Twilio Console.

Je configuratie controleren

Zo controleer je of regionale routing correct is geconfigureerd:

Controleer Twilio Console: Bevestig dat je telefoonnummer de juiste Edge Location toont
Controleer het ElevenLabs-platform: Controleer of de instelling voor de routingregio overeenkomt met je Twilio-configuratie
Test oproepbewerkingen: Doe een testoproep en controleer of bewerkingen zoals het doorverbinden van oproepen correct werken

Controleer je eerste paar oproepen in het Calls History- dashboard na het configureren van regionale routing om te controleren of alles naar verwachting werkt.

Veelvoorkomende problemen

Doorverbinden van oproepen mislukt

Dit wijst doorgaans op een afwijking in regionale routing. Controleer het volgende:

Je Twilio-telefoonnummer is geconfigureerd met de juiste Edge Location
De routingregio die in ElevenLabs is opgegeven, komt overeen met je Twilio-configuratie
Je gebruikt een geïsoleerde omgeving die overeenkomt met de routingregio

Mijn telefoonnummer komt uit Europa, maar wordt via de VS gerouteerd

De geografische herkomst van het telefoonnummer bepaalt het routinggedrag niet. Je moet regionale routing expliciet in Twilio configureren. Standaard worden alle nummers (inclusief Europese nummers) via us1 gerouteerd, tenzij je dit anders configureert.

Ik gebruik geen geïsoleerde omgeving. Heb ik dit nodig?

Als je de standaardomgeving van ElevenLabs gebruikt (geen EU-residency of andere geïsoleerde omgeving), is de configuratie van regionale routing optioneel.

Hoe weet ik welke regio ik moet gebruiken?

Kies een regio die:

Overeenkomt met je vereisten voor dataresidentie (bijvoorbeeld ie1 voor EU-dataresidentie)
Het dichtst bij je gebruikers is voor optimale latentie
Overeenkomt met je geïsoleerde ElevenLabs-omgeving (indien van toepassing)

Ik krijg authenticatiefouten met mijn Twilio-gegevens

Als je authenticatiefouten ziet bij het gebruik van regionale routing, controleer dan of je de juiste regionale API-sleutel gebruikt:

Regionale routing vereist een regiospecifieke API-sleutel van Twilio, niet je standaard Amerikaanse API-sleutel
Genereer in de Twilio Console een nieuwe API-sleutel die is beperkt tot je doelregio (bijvoorbeeld ie1, au1)
Werk je gegevens in ElevenLabs bij met de regionale API-sleutel
Je Account SID blijft hetzelfde, maar de API-sleutel moet overeenkomen met de regio

Best practices

Regio’s afstemmen: Zorg dat je regionale Twilio-routing overeenkomt met je ElevenLabs-omgeving
Configuratie documenteren: Houd bij welke nummers welke regio’s gebruiken
Grondig testen: Controleer of oproepbewerkingen correct werken na het wijzigen van regionale routing
Oproepen monitoren: Let in het Calls History-dashboard op fouten die op routingproblemen kunnen wijzen
Plannen voor schaal: Als je wilt uitbreiden naar nieuwe regio’s, overweeg regionale routing dan vanaf het begin