WdrażanieTelefoniaTwilio

Routing regionalny Twilio

Skonfiguruj routing regionalny dla numerów Twilio, aby zapewnić zgodność z wymogami rezydencji danych.

Omówienie

Routing regionalny zapewnia, że dane telefoniczne pozostają w określonym regionie geograficznym. Gdy używasz Twilio z ElevenLabs w środowisku izolowanym (np. z rezydencją danych w UE), musisz poprawnie skonfigurować routing regionalny, by zachować zgodność z wymogami rezydencji danych.

W tym przewodniku wyjaśniamy, czym jest routing regionalny, dlaczego ma znaczenie i jak poprawnie skonfigurować go w Twilio oraz ElevenLabs.

Czym jest routing regionalny?

Routing regionalny to mechanizm Twilio, który zapewnia przetwarzanie i przechowywanie danych połączeń w określonym regionie geograficznym. Możesz traktować go jak rezydencję danych dla infrastruktury telefonicznej.

Domyślnie numery telefonów Twilio są skonfigurowane tak, by kierować ruch przez region USA (us1), **nawet jeśli sam numer pochodzi z innego kraju **. Na przykład włoski numer telefonu będzie nadal kierował ruch przez USA, jeśli routing regionalny nie zostanie wyraźnie skonfigurowany.

Dlaczego routing regionalny ma znaczenie

Gdy używasz ElevenLabs w środowisku izolowanym (np. z rezydencją danych w UE), całe przetwarzanie danych musi pozostać w wyznaczonym regionie. Bez poprawnej konfiguracji routingu regionalnego:

  • Naruszenia rezydencji danych: Dane połączeń mogą być kierowane przez niezamierzone regiony
  • Nieudane operacje API: Operacje na trwających połączeniach (takie jak przekazywanie, wstrzymanie, wznowienie) nie powiodą się
  • Niezgodności routingu SDK: SDK Twilio domyślnie używa regionu us1, przez co wywołania API są wysyłane do niewłaściwego regionu, nawet gdy Twilio prawidłowo skierowało połączenie po stronie backendu

Jak to działa

Gdy importujesz numer telefonu Twilio do ElevenLabs:

  1. Twilio kieruje połączenie: Twilio automatycznie kieruje połączenia przychodzące do regionu skonfigurowanego na twoim koncie Twilio (może to być us1, ie1 dla Irlandii, au1 dla Australii itd.)
  2. ElevenLabs musi znać region: Aby wykonywać operacje na trwających połączeniach (np. przekazywanie), ElevenLabs musi wysyłać żądania API do tego samego regionu, do którego Twilio skierowało połączenie
  3. Określenie regionu zapobiega błędom: Wskazując region routingu na platformie ElevenLabs, zapewniamy, że wszystkie wywołania API trafiają do właściwego regionu Twilio

Jeśli region routingu nie zostanie podany lub będzie nieprawidłowy, operacje takie jak przekazywanie połączeń nie powiodą się, ponieważ żądania API zostaną wysłane do domyślnego regionu us1, podczas gdy faktyczne połączenie jest obsługiwane w innym regionie.

Konfiguracja

1

Sprawdź routing regionalny Twilio

Najpierw sprawdź, którego regionu używa twój numer telefonu Twilio:

  1. Zaloguj się do konsoli Twilio
  2. Przejdź do Phone Numbers → Manage → Active numbers
  3. Wybierz swój numer telefonu
  4. Znajdź sekcję konfiguracji Voice & Fax
  5. Sprawdź ustawienie Regional routing lub Edge Location

Typowe regiony Twilio:

  • us1 - Stany Zjednoczone (domyślnie)
  • ie1 - Irlandia (Europa)
  • au1 - Australia
  • br1 - Brazylia
  • jp1 - Japonia
  • sg1 - Singapur

Jeśli używasz środowiska izolowanego (np. z rezydencją danych w UE), upewnij się, że numery Twilio są skonfigurowane do routingu przez pasujący region (np. ie1 dla UE).

2

Skonfiguruj routing regionalny w Twilio

Jeśli twój numer telefonu nie jest skonfigurowany dla właściwego regionu:

  1. W konsoli Twilio przejdź do konfiguracji numeru telefonu
  2. Znajdź sekcję Voice & Fax
  3. Ustaw Edge Location zgodnie z wybranym regionem
  4. Zapisz konfigurację

Konfiguracja routingu regionalnego w Twilio może wymagać dodatkowej konfiguracji lub uprawnień do konta. Jeśli potrzebujesz pomocy z włączeniem routingu regionalnego na swoim koncie, skontaktuj się z pomocą Twilio.

3

Określ region routingu w ElevenLabs

Gdy importujesz lub konfigurujesz numer telefonu Twilio na stronie Phone Numbers ElevenLabs:

  1. Przejdź do konfiguracji numeru telefonu
  2. Jeśli używasz środowiska izolowanego, zobaczysz komunikat ostrzegawczy: “Używasz numeru telefonu w środowisku izolowanym. Sprawdź dokładnie region routingu dla tego numeru u swojego dostawcy.”
  3. Sprawdź, czy region routingu odpowiada konfiguracji Twilio
  4. Upewnij się, że podany region jest taki sam jak region skonfigurowany na twoim koncie Twilio

    Jeśli używasz routingu regionalnego, musisz użyć regionalnego klucza API Twilio, który odpowiada twojemu regionowi routingu. Standardowy amerykański klucz API nie zadziała w regionach spoza USA i spowoduje błędy uwierzytelniania. Wygeneruj klucz API dla konkretnego regionu w konsoli Twilio.

Weryfikacja konfiguracji

Aby sprawdzić, czy routing regionalny jest poprawnie skonfigurowany:

  1. Sprawdź konsolę Twilio: Potwierdź, że numer telefonu ma właściwe ustawienie Edge Location
  2. Sprawdź platformę ElevenLabs: Zweryfikuj, czy ustawienie regionu routingu odpowiada konfiguracji Twilio
  3. Przetestuj operacje na połączeniu: Wykonaj połączenie testowe i sprawdź, czy operacje takie jak przekazywanie połączeń działają poprawnie

Po skonfigurowaniu routingu regionalnego monitoruj pierwsze kilka połączeń w panelu historii połączeń, aby upewnić się, że wszystko działa zgodnie z oczekiwaniami.

Typowe problemy

Zwykle oznacza to niezgodność routingu regionalnego. Sprawdź, czy:

  • Twój numer telefonu Twilio jest skonfigurowany z właściwym ustawieniem Edge Location
  • Region routingu podany w ElevenLabs odpowiada konfiguracji Twilio
  • Używasz środowiska izolowanego pasującego do regionu routingu

Pochodzenie geograficzne numeru telefonu nie określa sposobu routingu. Musisz wyraźnie skonfigurować routing regionalny w Twilio. Domyślnie wszystkie numery (w tym europejskie) są kierowane przez us1, chyba że skonfigurujesz je inaczej.

Jeśli używasz standardowego środowiska ElevenLabs (bez rezydencji danych w UE ani innego środowiska izolowanego), konfiguracja routingu regionalnego jest opcjonalna.

Wybierz region, który:

  • Spełnia twoje wymagania dotyczące rezydencji danych (np. ie1 dla rezydencji danych w UE)
  • Jest najbliżej użytkowników, aby zapewnić optymalne opóźnienia
  • Pasuje do twojego izolowanego środowiska ElevenLabs (jeśli dotyczy)

Jeśli podczas używania routingu regionalnego widzisz błędy uwierzytelniania, sprawdź, czy używasz właściwego regionalnego klucza API:

  • Routing regionalny wymaga klucza API Twilio dla konkretnego regionu, a nie standardowego amerykańskiego klucza API
  • Wygeneruj w konsoli Twilio nowy klucz API ograniczony do docelowego regionu (np. ie1, au1)
  • Zaktualizuj poświadczenia w ElevenLabs, używając regionalnego klucza API
  • Twój Account SID pozostaje taki sam, ale klucz API musi odpowiadać regionowi

Dobre praktyki

  • Dopasuj regiony: Upewnij się, że routing regionalny Twilio pasuje do środowiska ElevenLabs
  • Dokumentuj konfigurację: Zapisuj, które numery używają których regionów
  • Dokładnie testuj: Po zmianie routingu regionalnego sprawdź, czy operacje na połączeniach działają poprawnie
  • Monitoruj połączenia: Obserwuj błędy w panelu historii połączeń, które mogą wskazywać problemy z routingiem
  • Planuj skalowanie: Jeśli planujesz ekspansję na nowe regiony, uwzględnij routing regionalny od początku

Dodatkowe zasoby