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

# Roteamento regional do Twilio

## Visão geral

O roteamento regional garante que seus dados de telefonia permaneçam em uma região geográfica específica. Ao usar o Twilio com a ElevenLabs em um ambiente isolado (como residência de dados na UE), você precisa configurar o roteamento regional corretamente para manter a conformidade com os requisitos de residência de dados.

Este guia explica o que é roteamento regional, por que ele é importante e como configurá-lo corretamente tanto no Twilio quanto na ElevenLabs.

## O que é roteamento regional?

O roteamento regional é o mecanismo do Twilio para garantir que os dados das chamadas sejam processados e armazenados em uma região geográfica específica. Pense nele como residência de dados para sua infraestrutura de telefonia.

> **Note**
>
> Por padrão, os números de telefone do Twilio são configurados para rotear pela região dos EUA (`us1`), \*\*mesmo que
> o próprio número de telefone seja de outro país \*\*. Por exemplo, um número de telefone italiano ainda
> será roteado pelos EUA, a menos que o roteamento regional seja configurado explicitamente.

## Por que o roteamento regional é importante

Ao usar a ElevenLabs em um ambiente isolado (como residência de dados na UE), todo o processamento de dados deve permanecer na região designada. Sem uma configuração adequada de roteamento regional:

* **Violações de residência de dados**: os dados das chamadas podem ser roteados por regiões não pretendidas
* **Falha em operações de API**: operações em chamadas em andamento (como transferir, colocar em espera e retomar) falharão
* **Incompatibilidades de roteamento do SDK**: o SDK do Twilio usa a região `us1` por padrão, fazendo com que chamadas de API sejam enviadas para a região errada, mesmo quando o Twilio roteou a chamada corretamente no backend

## Como funciona

Quando você importa um número de telefone do Twilio para a ElevenLabs:

1. **O Twilio roteia a chamada**: o Twilio roteia automaticamente chamadas recebidas para a região configurada na sua conta do Twilio (pode ser `us1`, `ie1` para a Irlanda, `au1` para a Austrália etc.)
2. **A ElevenLabs precisa saber a região**: para executar operações em chamadas em andamento (como transferências), a ElevenLabs precisa enviar solicitações de API para a mesma região em que o Twilio roteou a chamada
3. **A especificação da região evita falhas**: ao especificar a região de roteamento na plataforma ElevenLabs, garantimos que todas as chamadas de API sejam direcionadas à região correta do Twilio

> **Warning**
>
> Se a região de roteamento não for especificada ou estiver incorreta, operações como transferências de chamada falharão
> porque as solicitações de API serão enviadas para a região padrão `us1`, enquanto a chamada real estará sendo
> tratada em uma região diferente.

## Configuração

### Verifique o roteamento regional do Twilio

Primeiro, verifique qual região seu número de telefone do Twilio está configurado para usar:

1. Faça login no [Console do Twilio](https://console.twilio.com/)
2. Navegue até **Phone Numbers** → **Manage** → **Active numbers**
3. Selecione seu número de telefone
4. Procure a seção de configuração **Voice & Fax**
5. Verifique a configuração **Regional routing** ou **Edge Location**

Regiões comuns do Twilio:

* `us1` - Estados Unidos (padrão)
* `ie1` - Irlanda (Europa)
* `au1` - Austrália
* `br1` - Brasil
* `jp1` - Japão
* `sg1` - Singapura

> **Tip**
>
> Se você estiver usando um ambiente isolado (como residência de dados na UE), verifique se seus números do Twilio estão
> configurados para rotear pela região correspondente (por exemplo, `ie1` para a UE).

### Configure o roteamento regional no Twilio

Se seu número de telefone não estiver configurado para a região correta:

1. No [Console do Twilio](https://console.twilio.com/), acesse a configuração do seu número de telefone
2. Encontre a seção **Voice & Fax**
3. Defina **Edge Location** para corresponder à região desejada
4. Salve a configuração

> **Note**
>
> A configuração de roteamento regional no Twilio pode exigir configuração adicional ou permissões da conta.
> Entre em contato com o [Suporte do Twilio](https://support.twilio.com/) se precisar de ajuda para habilitar o roteamento regional
> na sua conta.

### Especifique a região de roteamento na ElevenLabs

Ao importar ou configurar um número de telefone do Twilio na página [Phone Numbers](https://elevenlabs.io/app/agents/phone-numbers) da ElevenLabs:

1. Navegue até a configuração do número de telefone
2. Se estiver usando um ambiente isolado, você verá uma mensagem de aviso: "Você está usando um número de telefone em um ambiente isolado. Confira a região de roteamento desse número de telefone no seu provedor."
3. Verifique se a **região de roteamento** corresponde à configuração do Twilio
4. Garanta que a região especificada corresponda à região configurada na sua conta do Twilio
   > **Warning**
   >
   > Se estiver usando roteamento regional, você precisa usar uma **chave de API regional** do Twilio que
   > corresponda à sua região de roteamento. Sua chave de API padrão dos EUA não funcionará para regiões fora dos EUA
   > e resultará em erros de autenticação. Gere uma chave de API específica para a região no seu [Console do Twilio](https://console.twilio.com/).

## Como verificar sua configuração

Para verificar se o roteamento regional está configurado corretamente:

1. **Verifique o Console do Twilio**: confirme se seu número de telefone mostra o Edge Location correto
2. **Verifique a plataforma ElevenLabs**: confirme se a configuração da região de roteamento corresponde à sua configuração do Twilio
3. **Teste as operações de chamada**: faça uma chamada de teste e confirme se operações como transferência de chamada funcionam corretamente

> **Tip**
>
> Monitore suas primeiras chamadas no painel de [Histórico de chamadas](https://elevenlabs.io/app/agents/history) após configurar o roteamento regional para garantir que
> tudo funcione conforme o esperado.

## Problemas comuns

#### As transferências de chamada estão falhando

Isso normalmente indica uma incompatibilidade no roteamento regional. Verifique se:

* Seu número de telefone do Twilio está configurado com o Edge Location correto
* A região de roteamento especificada na ElevenLabs corresponde à configuração do Twilio
* Você está usando um ambiente isolado que corresponde à região de roteamento

#### Meu número de telefone é da Europa, mas está roteando pelos EUA

A origem geográfica do número de telefone não determina o comportamento de roteamento. Você precisa
configurar explicitamente o roteamento regional no Twilio. Por padrão, todos os números (incluindo números europeus) são roteados
por `us1`, a menos que sejam configurados de outra forma.

#### Não estou usando um ambiente isolado — preciso disso?

Se você estiver usando o ambiente padrão da ElevenLabs (sem residência de dados na UE ou outro ambiente isolado),
a configuração de roteamento regional é opcional.

#### Como sei qual região usar?

Escolha uma região que:

* Corresponda aos seus requisitos de residência de dados (por exemplo, `ie1` para residência de dados na UE)
* Esteja mais próxima dos seus usuários para ter latência ideal
* Corresponda ao seu ambiente isolado da ElevenLabs, se aplicável

#### Estou recebendo erros de autenticação com minhas credenciais do Twilio

Se você estiver recebendo erros de autenticação ao usar roteamento regional, verifique se está usando a **chave de API regional** correta:

* O roteamento regional exige uma chave de API específica da região do Twilio, e não sua chave de API padrão dos EUA
* Gere uma nova chave de API limitada à sua região de destino (por exemplo, `ie1`, `au1`) no Console do Twilio
* Atualize suas credenciais na ElevenLabs com a chave de API regional
* Seu Account SID permanece o mesmo, mas a chave de API deve corresponder à região

## Práticas recomendadas

* **Correspondência de regiões**: garanta que o roteamento regional do Twilio corresponda ao seu ambiente da ElevenLabs
* **Documente a configuração**: mantenha registros de quais números usam quais regiões
* **Teste bem**: confirme se as operações de chamada funcionam corretamente após alterar o roteamento regional
* **Monitore chamadas**: observe falhas no painel de Histórico de chamadas que possam indicar problemas de roteamento
* **Planeje a expansão**: se pretende expandir para novas regiões, considere o roteamento regional desde o início

## Recursos adicionais

* [Documentação de roteamento regional do Twilio](https://www.twilio.com/docs/global-infrastructure/edge-locations)
* [Guia de residência de dados da ElevenLabs](/docs/pt/overview/administration/data-residency)
* [Guia de números de telefone do Twilio](/docs/pt/eleven-agents/phone-numbers/twilio-integration/native-integration)