> 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. # Entroncamento SIP da Bandwidth > **Note** > > Antes de seguir este guia, considere ler o [guia de entroncamento SIP](/docs/pt/eleven-agents/phone-numbers/sip-trunking) 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: 1. **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). 2. **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. 3. **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. 4. **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: 1. Uma conta ativa da ElevenLabs 2. Uma conta ativa da Bandwidth Universal Platform com entroncamento SIP ativado (com sip-auth ativado) 3. Pelo menos um número de telefone comprado ou portado para sua conta da Bandwidth 4. Acesso de administrador à sua conta no [app da Bandwidth](https://app.bandwidth.com/) ## Configuração de chamadas recebidas (Bandwidth para ElevenLabs) Configure as definições de originação da Bandwidth para encaminhar chamadas recebidas à ElevenLabs. #### Entre no app da Bandwidth Faça login no [app da Bandwidth](https://app.bandwidth.com/). #### Crie um Voice Configuration Package 1. Acesse a aba **Service Management** e selecione **Voice Configuration**. 2. Clique em **Create New** para iniciar a criação de um novo Voice Configuration Package. 3. Insira um nome de pacote exclusivo. 4. Clique em **Add Route**. 5. Escolha **Route to Domain Name**. 6. 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](/docs/pt/overview/administration/data-residency) para ver as regiões disponíveis. 7. Clique em **Save** para concluir a criação do Voice Configuration Package. > **Note** > > Consulte a [documentação de VCP da Bandwidth ](https://dev.bandwidth.com/docs/universal-platform/create-a-vcp) para mais > detalhes. #### Verifique a formatação E.164 A Bandwidth envia chamadas recebidas no formato E.164. Ao importar o número de telefone para a ElevenLabs, use o mesmo formato com um `+` no início (por exemplo, `+15551234567`). ## 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 1. No app da Bandwidth, selecione **Account** e clique em **SIP Credentials**. 2. Role até **Manage Realms** e clique em **Add**. 3. 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. > **Note** > > 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 1. Na seção **SIP Credentials**, clique em **Add**. 2. Insira um **Username** e uma **Password**. 3. Selecione o realm criado na etapa anterior. 4. 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: ```bash nslookup -type=SRV _sip._{udp/tls}.{realm_FQDN} ``` 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](/docs/pt/eleven-agents/phone-numbers/sip-trunking) 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](https://elevenlabs.io/app/agents/phone-numbers). > **Warning** > > Depois de configurar seu tronco SIP da Bandwidth, siga o [guia de entroncamento SIP](/docs/pt/eleven-agents/phone-numbers/sip-trunking) para concluir a configuração na > ElevenLabs. ## Solução de problemas #### As chamadas recebidas não conseguem se conectar * Verifique se `sip.rtc.elevenlabs.io` foi 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. ## Links úteis * [Guia de entroncamento SIP](/docs/pt/eleven-agents/phone-numbers/sip-trunking) * [Referência de SIP](/docs/pt/eleven-agents/phone-numbers/sip-reference) * [Guia de integração de troncos UC da Bandwidth](https://www.bandwidth.com/support/en/articles/12822954-uc-trunking-integration-guide) * [Configuração de autenticação SIP da Bandwidth](https://www.bandwidth.com/support/en/articles/12823069-sip-authentication-network-bridge-setup-and-configuration) * [Gerenciamento de Voice Configuration Packages da Bandwidth](https://www.bandwidth.com/support/en/articles/12823404-managing-voice-configuration-packages-on-the-universal-platform) * [Guia da Universal Platform](https://www.bandwidth.com/support/en/collections/12889706-universal-platform)