Entroncamento SIP da Bandwidth
Antes de seguir este guia, considere ler o guia de entroncamento SIP para entender como a ElevenLabs oferece suporte a troncos SIP.
Visão geral
Este guia explica como conectar seus troncos SIP da Bandwidth diretamente ao ElevenLabs Agents. Essa integração permite usar seus números de telefone e sua infraestrutura existentes da Bandwidth, aproveitando os recursos avançados de voz IA da ElevenLabs, tanto para chamadas recebidas quanto para chamadas de saída.
Como funciona o entroncamento SIP com a Bandwidth
O entroncamento SIP estabelece uma conexão direta entre sua infraestrutura de telefonia da Bandwidth e a plataforma ElevenLabs:
- Chamadas recebidas: as chamadas da Bandwidth são encaminhadas para a plataforma ElevenLabs usando nosso URI de originação. Você configura isso no app da Bandwidth usando um Voice Configuration Package (VCP).
- Chamadas de saída: as chamadas iniciadas pela ElevenLabs são encaminhadas para seu tronco SIP da Bandwidth usando o FQDN do seu realm ou os endereços SBC de terminação, permitindo que seus agentes façam chamadas de saída.
- Autenticação: a Bandwidth fornece autenticação baseada em SIP para troncos de Comunicações Unificadas (UC), usando autenticação digest por meio de credenciais SIP (network bridge). Esse método é essencial para facilitar chamadas de saída da ElevenLabs e garantir uma comunicação segura.
- Sinalização e mídia: a configuração inicial da chamada (sinalização) usa UDP/TLS. Depois que a chamada é estabelecida, os dados de áudio reais (fluxo RTP) são transmitidos por UDP.
Requisitos
Antes de configurar a integração do tronco SIP da Bandwidth, certifique-se de ter:
- Uma conta ativa da ElevenLabs
- Uma conta ativa da Bandwidth Universal Platform com entroncamento SIP ativado (com sip-auth ativado)
- Pelo menos um número de telefone comprado ou portado para sua conta da Bandwidth
- Acesso de administrador à sua conta no app da Bandwidth
Configuração de chamadas recebidas (Bandwidth para ElevenLabs)
Configure as definições de originação da Bandwidth para encaminhar chamadas recebidas à ElevenLabs.
Crie um Voice Configuration Package
- Acesse a aba Service Management e selecione Voice Configuration.
- Clique em Create New para iniciar a criação de um novo Voice Configuration Package.
- Insira um nome de pacote exclusivo.
- Clique em Add Route.
- Escolha Route to Domain Name.
- Insira no campo fornecido o FQDN informado pela ElevenLabs. Normalmente, ele é
sip.rtc.elevenlabs.io. Se sua conta da ElevenLabs usar uma região isolada de residência de dados ou a infraestrutura SIP estática, use o endpoint SIP correspondente. Consulte residência de dados para ver as regiões disponíveis. - Clique em Save para concluir a criação do Voice Configuration Package.
Consulte a documentação de VCP da Bandwidth para mais detalhes.
Configuração de chamadas de saída (ElevenLabs para Bandwidth)
Para chamadas de saída, a ElevenLabs precisa se autenticar com a Bandwidth. A abordagem recomendada é a autenticação digest SIP usando um realm e credenciais.
Crie um realm
- No app da Bandwidth, selecione Account e clique em SIP Credentials.
- Role até Manage Realms e clique em Add.
- Insira um nome para o realm e uma descrição opcional e clique em Add.
A Bandwidth cria um FQDN de realm no formato {realmname}.{hash}.auth.bandwidth.com. Anote esse FQDN — você o usará como endereço de saída na ElevenLabs.
Se você não visualizar a aba SIP Credentials, entre em contato com seu gerente de conta da Bandwidth ou abra um chamado com o suporte da Bandwidth para ativar a autenticação SIP na sua conta.
Crie credenciais SIP
- Na seção SIP Credentials, clique em Add.
- Insira um Username e uma Password.
- Selecione o realm criado na etapa anterior.
- Clique em Add SIP Credentials.
Armazene o nome de usuário e a senha com segurança. Você os inserirá na configuração do tronco SIP da ElevenLabs.
Anote o FQDN do seu realm
Seu endereço de terminação de saída é o FQDN do realm exibido após a criação (por exemplo, myrealm-a1b2c3.auth.bandwidth.com). Insira esse nome de host no campo Address ao configurar as definições de saída na ElevenLabs.
Para verificar os endereços IP de SBC associados ao seu realm, execute uma consulta SRV:
A Bandwidth fornece um par de IPs SBC emparelhados para redundância. Ambos devem estar acessíveis para o tráfego de saída.
Conclua a configuração na ElevenLabs
Depois de configurar essas definições no app da Bandwidth, importe seu número de telefone para a ElevenLabs:
Importe o número de telefone do tronco SIP
Siga o guia de entroncamento SIP para importar seu número de telefone da Bandwidth. Use as seguintes definições:
- Tipo de transporte: UDP (ou TLS, se seu tronco da Bandwidth usar sinalização criptografada)
- Criptografia de mídia: corresponda à configuração do seu tronco da Bandwidth
- Endereço de saída: o FQDN do seu realm (por exemplo,
myrealm-a1b2c3.auth.bandwidth.com) - Nome de usuário e senha do tronco SIP: as credenciais criadas no app da Bandwidth
Atribua um agente
Depois de importar, atribua um agente ao número de telefone no painel Phone Numbers.
Depois de configurar seu tronco SIP da Bandwidth, siga o guia de entroncamento SIP para concluir a configuração na ElevenLabs.
Solução de problemas
As chamadas recebidas não conseguem se conectar
- Verifique se
sip.rtc.elevenlabs.iofoi inserido como destino de rota nas definições de originação do VCP da Bandwidth. - Confirme se o número de telefone está atribuído ao VCP com as definições de originação corretas.
- Certifique-se de que o formato do número de telefone na ElevenLabs corresponde ao formato E.164 enviado pela Bandwidth (com
+no início). - Verifique se seu firewall permite tráfego de sinalização SIP no protocolo de transporte e na porta configurados (5060 para UDP, 5061 para TLS) e se as portas RTP não estão bloqueadas.
Chamadas de saída recebem erros 407 ou de autenticação
- Confirme se o nome de usuário do tronco SIP, a senha e o realm na ElevenLabs correspondem às credenciais criadas no app da Bandwidth.
- Verifique se o campo Address contém apenas o nome de host do FQDN do realm, sem o prefixo
sip:. - Certifique-se de que o tipo de transporte nas definições de saída da ElevenLabs corresponde à configuração do seu tronco da Bandwidth (UDP ou TLS).
Áudio em apenas uma direção ou sem áudio
- Confirme se as portas RTP estão abertas para tráfego de mídia e não são bloqueadas pelo seu firewall.
- Verifique a compatibilidade do codec G711ulaw. A Bandwidth e a ElevenLabs oferecem suporte a G711.
Perguntas frequentes
Qual transporte e quais portas de sinalização a Bandwidth exige?
A Bandwidth e a ElevenLabs usam UDP na porta 5060 para sinalização SIP. Se seu tronco da Bandwidth estiver configurado para transporte criptografado, use TLS na porta 5061.
Qual formato de número de telefone devo usar?
Use o formato E.164 com um + no início (por exemplo, +19192971100). A Bandwidth envia e espera números nesse formato.
Quais codecs de áudio são compatíveis?
A ElevenLabs oferece suporte a G711 e G722. A Bandwidth oferece suporte a G711ulaw e G729a. G711ulaw é o codec recomendado para compatibilidade entre as duas plataformas.