Conecte um provedor de VoIP

Conecte um provedor que você já usa (Twilio ou Telnyx por chave de API; SignalWire, Vonage, Plivo ou qualquer tronco SIP via SIP) ou abra uma nova conta Telnyx com configuração guiada.

O tráfego de produção deve ser executado em números que você possui por meio do seu próprio provedor de VoIP. A página Conexões → VoIP do painel (/dashboard/voip-connections) conecta sua conta de provedor; depois de conectada, você importa números que suportam chamadas de entrada e de saída.

Clique em Nova conexão e escolha uma das duas opções: Conectar um provedor que você já usa ou Configurar uma nova conta Telnyx.

Conecte um provedor que você já usa#

Escolha o provedor onde estão seus números:

Para Twilio e Telnyx, cole as credenciais e clique em Conectar e testar. O ThunderPhone verifica as credenciais e configura o lado do provedor para você. Para Telnyx, o ThunderPhone adiciona uma conexão SIP própria à sua conta Telnyx (chamada thunderphone-production-<org>-outbound-<id>) e realiza chamadas de saída por ela, para que a Telnyx cobre essas chamadas de você. Ele usa o perfil de voz de saída da conexão Telnyx onde estão seus números, portanto, os países permitidos e os limites de gastos desse perfil se aplicam. Se essa conexão não tiver um perfil de voz de saída e sua conta tiver exatamente um perfil ativado, o ThunderPhone usará esse perfil. Para usar outro, atribua-o à conexão no portal da Telnyx e salve novamente a conexão do ThunderPhone. Se a conta não tiver nenhum perfil ativado, ou tiver vários, atribua um à conexão no portal da Telnyx e salve novamente a conexão do ThunderPhone. Até lá, as chamadas de saída falharão com outbound_trunk_unavailable; as chamadas de entrada continuarão funcionando.

Quando a Telnyx recusa uma chamada de saída (por exemplo, SIP 403 Forbidden), a recusa vem da sua própria conta Telnyx. As causas mais comuns são falta de crédito disponível, um número de origem que não está nessa conta Telnyx, ou um perfil de voz de saída que não permite o país de destino.

Configuração SIP para SignalWire, Vonage e Plivo#

Esses três abrem o formulário SIP manual com as etapas para esse provedor no início, um link para o próprio guia de configuração do provedor e um exemplo de domínio SIP:

• SignalWire: crie credenciais SIP para chamadas de saída, informe o domínio SIP, nome de usuário e senha, e atribua a cada número um script SWML que conecte as chamadas de entrada ao ponto de extremidade SIP do ThunderPhone.
• Vonage: no painel de tronco SIP, crie um tronco com credenciais de saída, informe seu domínio (por exemplo, your-trunk.sip-us.vonage.com) e as credenciais, adicione o ponto de extremidade SIP do ThunderPhone como URI SIP de entrada do tronco e vincule seus números ao tronco.
• Plivo: crie um tronco de saída com uma credencial e informe seu Domínio SIP de terminação (<trunk-id>.zt.plivo.com), nome de usuário e senha; crie um tronco de entrada cuja URI primária seja o ponto de extremidade SIP do ThunderPhone seguido de ;transport=tcp; depois, defina o Tipo de aplicativo de cada número como esse tronco.

O resultado é uma conexão SIP manual (provider: "manual" na API), testada e verificada exatamente como uma inserida manualmente. O cartão da conexão mostra o nome do provedor, por exemplo SignalWire · SIP.

Configure uma nova conta Telnyx#

Ainda não tem um provedor? O fluxo guiado orienta você na criação de uma conta Telnyx e na conexão dela:

1. Criar a conta

   Clique em Abrir cadastro da Telnyx, crie sua conta e marque "Criei minha conta."

2. Obter uma chave de API

   Clique em Abrir página de chaves de API, gere uma chave e cole-a em Chave de API (v2). Opcionalmente, dê um nome à conexão.

3. Conectar e testar

   Clique em Conectar e testar — o ThunderPhone verifica as credenciais e provisiona o necessário na Telnyx antes de salvar.

O que o ThunderPhone configura na Telnyx#

A menos que você insira seu próprio ID de conexão, ambas as rotas da Telnyx (a configuração guiada e a inserção de uma chave de API) deixam a mesma coisa na sua conta Telnyx: uma conexão SIP chamada thunderphone-<your organization id>. Ela é uma conexão FQDN cujo registro FQDN aponta para o endpoint SIP do ThunderPhone, e todo número que você importa é atribuído a ela. A Telnyx envia chamadas desses números diretamente para o ThunderPhone por SIP.

• Os campos de webhook ficam vazios intencionalmente. Nenhum webhook, aplicativo Call Control, aplicativo TeXML ou telefone SIP registrado está envolvido.
• Não mova números importados para outra conexão ou aplicativo, nem registre um dispositivo nela.
• Se você inseriu seu próprio ID de conexão ao conectar, o ThunderPhone usa essa conexão e nunca a altera; ela deve ser uma conexão FQDN que aponta para o endpoint SIP do ThunderPhone.

Antes de 30 de agosto de 2026, a conexão thunderphone-… criada pelo ThunderPhone era uma conexão de credenciais, que não pode receber chamadas. Se a sua ainda aparecer como uma conexão de credenciais, entre em contato com o suporte e faremos a conversão.

Configuração manual de SIP#

Os blocos do SignalWire, Vonage e Plivo abrem este formulário, assim como Vou inserir todas as configurações manualmente em Outro provedor. Qualquer tronco SIP funciona, incluindo DIDWW ou uma PBX que você opera por conta própria. Informe o nome da conexão, o domínio / URI SIP, nome de usuário e senha opcionais, porta e transporte; Configurações avançadas adiciona criptografia de mídia (SRTP). O formulário também mostra o endereço SIP para o qual seu tronco deve enviar chamadas de entrada: sip.thunderphone.com, na porta 5060 para UDP ou TCP, ou 5061 para TLS. Com TLS, a sinalização SIP permanece criptografada até o LiveKit Cloud, onde o ThunderPhone processa a chamada; o áudio nunca passa por sip.thunderphone.com, portanto o SRTP funciona como antes. Enderece cada chamada ao número discado no formato E.164, com o mesmo número, incluindo o +, tanto na linha de solicitação quanto no cabeçalho To: por exemplo, sip:+14155550142@sip.thunderphone.com. O + permite que o ThunderPhone processe a chamada na região correta (consulte a observação em lista de permissões de IP). Troncos configurados anteriormente com um endereço <your-project>.sip.livekit.cloud continuam funcionando enquanto IPs de origem permitidos estiver vazio; você não precisa alterá-los. O ThunderPhone transforma essas configurações em um par dedicado de troncos SIP no LiveKit Cloud: chamadas de saída dos números da conexão são feitas para seu domínio SIP com suas credenciais, e chamadas de entrada para esses números são aceitas de qualquer endereço, a menos que você preencha o campo opcional IPs de origem permitidos. Preencha-o somente se sua operadora publicar IPs de sinalização fixos: uma lista incorreta ou incompleta faz o ThunderPhone rejeitar as chamadas de entrada da sua operadora. Dois botões fazem o trabalho principal:

• Gerar guia de configuração com IA — cria instruções específicas do provedor para a configuração necessária no lado do tronco.
• Testar e salvar conexão — verifica se o endpoint SIP resolve para um endereço público e, para TCP/TLS, aceita uma conexão na porta escolhida (hosts UDP recebem apenas a verificação de DNS) e, em seguida, salva. Ele ainda não pode fazer uma chamada porque a conexão não tem números; a comprovação real ocorre no momento da importação (abaixo).

Editar uma conexão posteriormente executa novamente a mesma verificação nas configurações alteradas antes de salvar qualquer coisa, depois recria o tronco e verifica novamente cada número da conexão com uma breve chamada de teste em segundo plano — os números aparecem como Provisionando até que a chamada de teste seja bem-sucedida. Alterar apenas IPs de origem permitidos em uma conexão Conectada é diferente: isso nunca afeta chamadas de saída, portanto o ThunderPhone atualiza imediatamente a lista no tronco de entrada e os números permanecem Ativos. O teste de chamada de entrada volta para não testado; execute-o novamente ou faça uma chamada real pela sua operadora para confirmar que a nova lista permite a entrada de chamadas. O teste falha quando sua chamada seria recusada pela lista. Senhas armazenadas nunca são exibidas novamente; deixe a senha em branco para mantê-la ou marque "Remover a senha armazenada" para um tronco autenticado por IP.

Lista de permissões de IP e autenticação do tronco#

Algumas operadoras (DIDWW, conexões Telnyx com autenticação por IP, a maioria dos PBXs atrás de um firewall) aceitam tráfego SIP somente de endereços incluídos em uma lista de permissões ou autenticam chamadas de saída por IP de origem. O ThunderPhone usa dois conjuntos de endereços.

Borda SIP. As chamadas de entrada enviadas para sip.thunderphone.com passam pela borda SIP do ThunderPhone, que transporta apenas a sinalização SIP. O primeiro INVITE vai para sip.thunderphone.com; o restante da sinalização da chamada (ACK, desligamento, transferências) ocorre entre sua operadora e o servidor de borda que recebeu a chamada, sip-1 ou sip-2. Se o seu firewall filtra a sinalização SIP, permita os três, nas portas UDP e TCP 5060 e na porta TLS 5061:

LiveKit Cloud. O áudio (RTP) de cada chamada e a sinalização SIP das chamadas de saída ocorrem entre sua operadora e o LiveKit Cloud, nunca pela borda SIP. Permita todas as faixas abaixo, tanto para a sinalização SIP quanto para mídia:

O LiveKit aplica essas faixas ao Realtime, à sinalização e mídia SIP e aos Webhooks, e elas cobrem chamadas processadas nas regiões do Canadá, UE, Índia, Japão e EUA. Nomes de região para um endpoint fixado: canada, eu, india, japan, us.

Algumas regras práticas para o próprio tronco:

• O ThunderPhone não se registra. Ele nunca envia SIP REGISTER para sua operadora; portanto, configure o tronco para autenticação baseada em IP e/ou por credenciais (nome de usuário + senha), não por registro.
• As chamadas de saída devem usar credenciais. Ative a autenticação por nome de usuário/senha no lado da operadora e insira os mesmos valores no formulário SIP manual. Trate a lista de permissões de IP como uma segunda camada, não a única — chamadas de saída para destinos fora das regiões cobertas podem ser originadas de outros endereços.
• A entrada é a direção inversa. O campo opcional IPs de origem permitidos no formulário é onde você insere os endereços de sinalização da sua operadora para que o ThunderPhone aceite chamadas somente deles. Insira endereços IP ou faixas CIDR; nomes de host nunca correspondem. Deixe-o em branco a menos que sua operadora publique uma lista fixa. O ThunderPhone verifica a lista em cada chamada de entrada usando o endereço que sua borda SIP vê; portanto, depois de definir a lista, envie suas chamadas para sip.thunderphone.com. Uma chamada de um endereço que não está na lista, ou enviada diretamente para um endereço <your-project>.sip.livekit.cloud, é recusada: ela falha ou conecta e termina imediatamente.

As faixas são publicadas pelo LiveKit em Regiões, endpoints regionais e IPs estáticos; o ThunderPhone verifica essa página semanalmente e atualiza este guia quando ela muda.

Após conectar#

Importe números em Números de telefone → Adicionar número → Conectar provedor VoIP (ou diretamente pela conexão). Cada número importado é verificado antes de ser ativado. Para uma conexão SIP manual, essa verificação faz uma breve chamada de teste (de alguns segundos) do seu número, pelo seu tronco SIP, para um número do ThunderPhone — assim, o nome de usuário, a senha, o transporte e o roteamento de saída da sua operadora são todos testados de verdade. Sua operadora cobra essa chamada como qualquer outra.

Se a operadora recusá-la, o número permanecerá em Provisionamento e a página de números de telefone exibirá a resposta da operadora (por exemplo, "credenciais do ThunderPhone recusadas (SIP 401)"); corrija a conexão e verifique novamente. Se sua operadora aceitar o tronco, mas o plano de roteamento dela não cobrir o número de teste do ThunderPhone (DIDWW responde "Número de destino bloqueado pela lista negra do plano de roteamento"), o número será exibido como Verificado · operadora aceitou: ele pode ser usado, mas as chamadas para outros destinos não foram testadas. Essa chamada comprova que seu tronco consegue fazer chamadas usando o número; ela não comprova que você é proprietário do número nem testa chamadas para o número; o teste de entrada opcional abaixo faz isso. Números verificados oferecem suporte a chamadas de entrada e saída — o que libera campanhas de saída e chamadas de saída programáticas.

Teste de chamada recebida#

Verificar número abre uma caixa de diálogo que também pode testar chamadas recebidas. O teste faz uma chamada para o seu número, verifica se a chamada chega ao ThunderPhone e então desliga sem iniciar seu agente:

• Números com seu próprio tronco SIP de saída (números SIP manuais e números da Twilio depois que o ThunderPhone configura chamadas de saída na sua conta Twilio) primeiro ligam para si mesmos: o ThunderPhone disca o número a partir do próprio número, por esse tronco. A caixa de diálogo avisa antes de fazer a chamada. A chamada sai pela sua operadora e, se o roteamento de entrada estiver correto, volta diretamente para o ThunderPhone. Quando ela volta com o próprio identificador de chamadas do número, essa única chamada comprova tanto que sua operadora aceita as chamadas do ThunderPhone como se fossem do número quanto que as chamadas para o número chegam ao ThunderPhone, em qualquer país. Algumas operadoras recusam ou não conectam uma chamada de um número para ele mesmo; isso não diz nada sobre seu roteamento, então o ThunderPhone liga usando um de seus próprios números. Se o seu número encaminhar para outro lugar, esse telefone pode tocar duas vezes: primeiro mostrando o próprio identificador de chamadas do número e depois o número de teste do ThunderPhone.
• Outros números (e a alternativa acima) recebem chamadas de um dos próprios números do ThunderPhone. Por enquanto, o ThunderPhone só pode fazer essas chamadas para números dos EUA e do Canadá; para outros números, o teste informa que não pôde ser executado, com a resposta da sua operadora caso a chamada para si mesmo tenha sido recusada.

Se sua operadora alterar o identificador de chamadas no caminho, o ThunderPhone não poderá reconhecer a chamada, então seu agente poderá atendê-la por um momento. O teste de chamada recebida é opcional. Ignore-o e o número continuará funcionando; a página de números de telefone mostrará então Recebimento não testado, e você poderá executá-lo mais tarde com Testar ou com o item de menu Testar chamadas recebidas do número. Logo após uma importação, a página de números de telefone também pede que você teste chamadas recebidas nos novos números. Nada é discado até que você confirme na caixa de diálogo.

Se o seu provedor enviar o número para outro lugar, o destino para o qual ele aponta poderá tocar por até 8 segundos por chamada antes de o ThunderPhone desligar. Se algo atender primeiro (um aplicativo Twilio que atende e depois encaminha, um menu telefônico), o teste espera a chamada encaminhada chegar ao ThunderPhone: até 8 segundos na chamada para si mesmo e 15 segundos em uma chamada de um número do ThunderPhone. O resultado permanece no número (Recebimento aprovado ou reprovado) até você alterar a conexão ou reimportar o número, o que o redefine como não testado. Alterar uma conexão verifica novamente as chamadas de saída em segundo plano, mas nunca liga para o seu número sem que você peça.

Solução de problemas com chamadas recebidas#

O botão Testar da conexão verifica as credenciais, e a verificação confere a discagem de saída. Para verificar chamadas recebidas, execute o teste de chamada recebida acima ou ligue para o número de um telefone e procure a chamada em Histórico de chamadas. Os testes de Falar no navegador e as simulações de bot para bot não passam pela sua operadora, portanto não mostram se as chamadas recebidas funcionam. Uma simulação direcionada ao número de telefone (loopback SIP) realmente faz a chamada pela sua operadora; portanto, quando atendida, ela testa o roteamento de chamadas recebidas.

• Você ouve a mensagem da sua própria operadora móvel (por exemplo, "Bem-vindo à Verizon" ou "o número discado não está em serviço"): a chamada falhou antes de chegar ao ThunderPhone. Verifique se o número está ativo na sua conta do provedor e atribuído à conexão ou ao tronco SIP do ThunderPhone.
• Sinal de ocupado ou a chamada toca até cair: o provedor aceitou a chamada, mas não conseguiu entregá-la. Com a Telnyx, verifique a Conexão do número no portal da Telnyx: ela deve ser a conexão FQDN thunderphone-… descrita acima ou sua própria conexão FQDN apontando para o endpoint SIP do ThunderPhone. Com a Twilio, o número deve estar vinculado ao tronco SIP do ThunderPhone, e não a um webhook de voz ou app TwiML.
• Os logs da sua operadora mostram 404 No trunk found (SIP manual): a chamada chegou ao ThunderPhone, mas não correspondeu a nenhum tronco. Verifique se o número foi importado nesta conexão e se o tronco aponta para sip.thunderphone.com. Se ele apontar para um endereço <your-project>.sip.livekit.cloud, IPs de origem permitidos deve estar vazio: com uma lista definida, somente chamadas enviadas para sip.thunderphone.com são aceitas.
• 404 Not Found de sip.thunderphone.com (SIP manual): a chamada não foi endereçada a um número de telefone, ou a linha de solicitação e o cabeçalho To indicam números diferentes. Envie o número discado em ambos, como acima.
• 403 Forbidden de sip.thunderphone.com: a linha de solicitação indica outro host. Enderece a chamada para sip.thunderphone.com, por exemplo, sip:+14155550142@sip.thunderphone.com.
• A chamada chega ao ThunderPhone, mas o agente errado atende, ou ninguém atende: verifique o agente de chamadas recebidas do número em Números de telefone.

O copiloto no aplicativo pode verificar um número para você: pergunte por que as chamadas para o número falham. Para conexões Telnyx, ele também consulta, em modo somente leitura e para administradores da organização, a qual conexão a Telnyx atribui o número.

Próximas etapas#