> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Routing regionalny Twilio

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

> **Note**
>
> 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

> **Warning**
>
> 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

### Sprawdź routing regionalny Twilio

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

1. Zaloguj się do [konsoli Twilio](https://console.twilio.com/)
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

> **Tip**
>
> 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).

### Skonfiguruj routing regionalny w Twilio

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

1. W [konsoli Twilio](https://console.twilio.com/) przejdź do konfiguracji numeru telefonu
2. Znajdź sekcję **Voice & Fax**
3. Ustaw **Edge Location** zgodnie z wybranym regionem
4. Zapisz konfigurację

> **Note**
>
> 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](https://support.twilio.com/).

### Określ region routingu w ElevenLabs

Gdy importujesz lub konfigurujesz numer telefonu Twilio na stronie [Phone Numbers](https://elevenlabs.io/app/agents/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
   > **Warning**
   >
   > 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](https://console.twilio.com/).

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

> **Tip**
>
> Po skonfigurowaniu routingu regionalnego monitoruj pierwsze kilka połączeń w [panelu historii połączeń](https://elevenlabs.io/app/agents/history), aby upewnić się, że wszystko działa zgodnie z oczekiwaniami.

## Typowe problemy

#### Przekazywanie połączeń nie działa

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

#### Mój numer telefonu pochodzi z Europy, ale routing prowadzi przez USA

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.

#### Nie używam środowiska izolowanego — czy tego potrzebuję?

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

#### Skąd mam wiedzieć, którego regionu użyć?

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)

#### Pojawiają się błędy uwierzytelniania poświadczeń Twilio

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

* [Dokumentacja routingu regionalnego Twilio](https://www.twilio.com/docs/global-infrastructure/edge-locations)
* [Przewodnik ElevenLabs po rezydencji danych](/docs/pl/overview/administration/data-residency)
* [Przewodnik po numerach telefonów Twilio](/docs/pl/eleven-agents/phone-numbers/twilio-integration/native-integration)