ImplantarTelefoniaTwilio

Roteamento regional do Twilio

Configure o roteamento regional para números de telefone do Twilio e garanta a conformidade com requisitos de residência de dados.

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.

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

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

1

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

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

2

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

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 se precisar de ajuda para habilitar o roteamento regional na sua conta.

3

Especifique a região de roteamento na ElevenLabs

Ao importar ou configurar um número de telefone do Twilio na página 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

    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.

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

Monitore suas primeiras chamadas no painel de Histórico de chamadas após configurar o roteamento regional para garantir que tudo funcione conforme o esperado.

Problemas comuns

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

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.

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.

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

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