> 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 regionale Twilio

## Panoramica

Il routing regionale garantisce che i dati della tua telefonia rimangano all'interno di una regione geografica specifica. Quando usi Twilio con ElevenLabs in un ambiente isolato (come la residenza dei dati nell'UE), devi configurare correttamente il routing regionale per mantenere la conformità ai requisiti di residenza dei dati.

Questa guida spiega cos'è il routing regionale, perché è importante e come configurarlo correttamente sia in Twilio sia in ElevenLabs.

## Cos'è il routing regionale?

Il routing regionale è il meccanismo di Twilio che garantisce che i dati delle chiamate vengano elaborati e archiviati all'interno di una regione geografica specifica. Consideralo come la residenza dei dati per la tua infrastruttura di telefonia.

> **Note**
>
> Per impostazione predefinita, i numeri di telefono Twilio sono configurati per il routing attraverso la regione USA (`us1`), \*\*anche se
> il numero di telefono proviene da un altro Paese \*\*. Ad esempio, un numero di telefono italiano verrà comunque
> instradato attraverso gli Stati Uniti, a meno che il routing regionale non venga configurato esplicitamente.

## Perché il routing regionale è importante

Quando usi ElevenLabs in un ambiente isolato (come la residenza dei dati nell'UE), tutta l'elaborazione dei dati deve rimanere nella regione designata. Senza una configurazione corretta del routing regionale:

* **Violazioni della residenza dei dati**: i dati delle chiamate potrebbero essere instradati attraverso regioni non previste
* **Operazioni API non riuscite**: le operazioni sulle chiamate in corso (come trasferimento, messa in attesa e ripresa) non andranno a buon fine
* **Incongruenze nel routing dell'SDK**: l'SDK Twilio usa per impostazione predefinita la regione `us1`, causando l'invio delle chiamate API alla regione errata anche quando Twilio ha instradato correttamente la chiamata nel backend

## Come funziona

Quando importi un numero di telefono Twilio in ElevenLabs:

1. **Twilio instrada la chiamata**: Twilio instrada automaticamente le chiamate in arrivo verso la regione configurata nel tuo account Twilio (può essere `us1`, `ie1` per l'Irlanda, `au1` per l'Australia e così via)
2. **ElevenLabs deve conoscere la regione**: per eseguire operazioni sulle chiamate in corso (come i trasferimenti), ElevenLabs deve inviare richieste API alla stessa regione verso cui Twilio ha instradato la chiamata
3. **La specifica della regione evita errori**: specificando la regione di routing nella piattaforma ElevenLabs, garantiamo che tutte le chiamate API siano indirizzate alla regione Twilio corretta

> **Warning**
>
> Se la regione di routing non è specificata o non è corretta, operazioni come i trasferimenti di chiamata non andranno a buon fine
> perché le richieste API verranno inviate alla regione predefinita `us1`, mentre la chiamata effettiva viene
> gestita in una regione diversa.

## Configurazione

### Controlla il routing regionale di Twilio

Per prima cosa, verifica quale regione è configurata per il tuo numero di telefono Twilio:

1. Accedi alla [Twilio Console](https://console.twilio.com/)
2. Vai a **Phone Numbers** → **Manage** → **Active numbers**
3. Seleziona il tuo numero di telefono
4. Cerca la sezione di configurazione **Voice & Fax**
5. Controlla l'impostazione **Regional routing** o **Edge Location**

Regioni Twilio comuni:

* `us1` - Stati Uniti (predefinita)
* `ie1` - Irlanda (Europa)
* `au1` - Australia
* `br1` - Brasile
* `jp1` - Giappone
* `sg1` - Singapore

> **Tip**
>
> Se usi un ambiente isolato (come la residenza dei dati nell'UE), assicurati che i tuoi numeri Twilio siano
> configurati per il routing attraverso la regione corrispondente (ad esempio, `ie1` per l'UE).

### Configura il routing regionale in Twilio

Se il tuo numero di telefono non è configurato per la regione corretta:

1. Nella [Twilio Console](https://console.twilio.com/), vai alla configurazione del tuo numero di telefono
2. Trova la sezione **Voice & Fax**
3. Imposta **Edge Location** in modo che corrisponda alla regione desiderata
4. Salva la configurazione

> **Note**
>
> La configurazione del routing regionale in Twilio potrebbe richiedere configurazioni aggiuntive o autorizzazioni dell'account.
> Contatta il [supporto Twilio](https://support.twilio.com/) se hai bisogno di assistenza per abilitare il routing
> regionale per il tuo account.

### Specifica la regione di routing in ElevenLabs

Quando importi o configuri un numero di telefono Twilio nella pagina [Phone Numbers](https://elevenlabs.io/app/agents/phone-numbers) di ElevenLabs:

1. Vai alla configurazione del numero di telefono
2. Se usi un ambiente isolato, vedrai un messaggio di avviso: "Stai usando un numero di telefono in un ambiente isolato. Controlla nuovamente la regione di routing per questo numero di telefono nel tuo provider."
3. Verifica che la **regione di routing** corrisponda alla configurazione di Twilio
4. Assicurati che la regione specificata corrisponda a quella configurata nel tuo account Twilio
   > **Warning**
   >
   > Se usi il routing regionale, devi utilizzare una **chiave API regionale** di Twilio che
   > corrisponda alla tua regione di routing. La tua chiave API statunitense standard non funzionerà per le regioni non USA
   > e genererà errori di autenticazione. Genera una chiave API specifica per regione nella tua [Twilio Console](https://console.twilio.com/).

## Verifica della configurazione

Per verificare che il routing regionale sia configurato correttamente:

1. **Controlla la Twilio Console**: conferma che il tuo numero di telefono mostri la Edge Location corretta
2. **Controlla la piattaforma ElevenLabs**: verifica che l'impostazione della regione di routing corrisponda alla configurazione di Twilio
3. **Testa le operazioni di chiamata**: effettua una chiamata di prova e verifica che operazioni come il trasferimento di chiamata funzionino correttamente

> **Tip**
>
> Monitora le prime chiamate nella [dashboard della cronologia chiamate](https://elevenlabs.io/app/agents/history) dopo aver configurato il routing regionale per assicurarti che
> tutto funzioni come previsto.

## Problemi comuni

#### I trasferimenti di chiamata non riescono

In genere questo indica una mancata corrispondenza nel routing regionale. Verifica che:

* Il tuo numero di telefono Twilio sia configurato con la Edge Location corretta
* La regione di routing specificata in ElevenLabs corrisponda alla configurazione di Twilio
* Tu stia usando un ambiente isolato che corrisponda alla regione di routing

#### Il mio numero di telefono è europeo, ma il routing passa dagli Stati Uniti

L'origine geografica del numero di telefono non determina il comportamento di routing. Devi configurare esplicitamente
il routing regionale in Twilio. Per impostazione predefinita, tutti i numeri (compresi quelli europei) vengono instradati
attraverso `us1`, se non configurati diversamente.

#### Non uso un ambiente isolato: mi serve questa configurazione?

Se usi l'ambiente ElevenLabs standard (non la residenza dei dati nell'UE o un altro ambiente
isolato), la configurazione del routing regionale è facoltativa.

#### Come faccio a sapere quale regione usare?

Scegli una regione che:

* Corrisponda ai tuoi requisiti di residenza dei dati (ad esempio, `ie1` per la residenza dei dati nell'UE)
* Sia più vicina ai tuoi utenti per una latenza ottimale
* Corrisponda al tuo ambiente isolato ElevenLabs (se applicabile)

#### Ricevo errori di autenticazione con le mie credenziali Twilio

Se visualizzi errori di autenticazione quando usi il routing regionale, verifica di utilizzare la **chiave API regionale** corretta:

* Il routing regionale richiede una chiave API specifica per regione di Twilio, non la tua chiave API statunitense standard
* Genera una nuova chiave API limitata alla regione di destinazione (ad esempio, `ie1`, `au1`) nella Twilio Console
* Aggiorna le tue credenziali in ElevenLabs con la chiave API regionale
* Il tuo Account SID rimane invariato, ma la chiave API deve corrispondere alla regione

## Best practice

* **Fai corrispondere le regioni**: assicurati che il routing regionale Twilio corrisponda al tuo ambiente ElevenLabs
* **Documenta la configurazione**: tieni traccia dei numeri che utilizzano ciascuna regione
* **Esegui test approfonditi**: verifica che le operazioni di chiamata funzionino correttamente dopo aver modificato il routing regionale
* **Monitora le chiamate**: controlla eventuali errori nella dashboard della cronologia chiamate che potrebbero indicare problemi di routing
* **Pianifica la scalabilità**: se intendi espanderti in nuove regioni, considera il routing regionale fin dall'inizio

## Risorse aggiuntive

* [Documentazione sul routing regionale Twilio](https://www.twilio.com/docs/global-infrastructure/edge-locations)
* [Guida alla residenza dei dati di ElevenLabs](/docs/it/overview/administration/data-residency)
* [Guida ai numeri di telefono Twilio](/docs/it/eleven-agents/phone-numbers/twilio-integration/native-integration)