SIP Trunks (BYOC)
Os SIP Trunks permitem que você integre seu próprio provedor de telefonia SIP com o Tropicall. Com o recurso BYOC (Bring Your Own Carrier), você pode usar números de telefone que já possui em provedores como Twilio, Telnyx ou Plivo para receber e fazer chamadas através dos seus agentes de IA.Este é um recurso avançado para usuários que já possuem infraestrutura SIP ou preferem gerenciar sua própria telefonia. Se você está começando, recomendamos usar os Números de Telefone nativos do Tropicall.
Por que usar seu próprio provedor?
Use Números Existentes
Mantenha os números de telefone que sua empresa já utiliza, sem precisar migrar ou divulgar novos contatos.
Negocie Seus Preços
Aproveite acordos comerciais que você já tem com seu provedor SIP para custos de telefonia.
Cobertura Internacional
Acesse números em países que não estão disponíveis através do provedor padrão do Tropicall.
Controle Total
Gerencie sua infraestrutura de telefonia de forma centralizada no provedor de sua preferência.
Como funciona?
O SIP Trunk atua como uma ponte entre seu provedor de telefonia e o Tropicall: Fluxo de uma chamada:- Cliente liga para seu número no provedor (Twilio, Telnyx, etc.)
- O provedor encaminha a chamada para o Tropicall via SIP
- O Tropicall identifica o agente vinculado ao trunk
- O agente de IA atende e conduz a conversa
Provedores Suportados
O Tropicall oferece configuração simplificada para os principais provedores SIP. Ao selecionar um provedor conhecido, os IPs permitidos são preenchidos automaticamente.- Twilio
- Telnyx
- Plivo
- Custom
Twilio Elastic SIP Trunking
O Twilio é uma das plataformas mais populares para comunicação em nuvem.Vantagens:- Presença global em mais de 100 países
- Interface intuitiva de gerenciamento
- Documentação extensa
- América do Norte (Ashburn, Oregon)
- Europa (Dublin, Frankfurt)
- Ásia-Pacífico (Singapura, Tóquio, Sydney)
- América do Sul (São Paulo)
pstn.twilio.comDocumentação Twilio SIP Trunking →Acessando a Página de SIP Trunks
1
Acesse o Dashboard
Faça login em app.tropicall.ai
2
Navegue para SIP Trunks
No menu lateral, clique em SIP Trunks
3
Visualize seus trunks
A página exibe estatísticas e a lista de todos os seus SIP Trunks configurados
Interface da Página
Ao acessar a página, você verá: Cards de Estatísticas:- Total: Quantidade de trunks configurados
- Ativos: Trunks funcionando corretamente
- Pendentes: Trunks aguardando configuração
- Com Erro: Trunks que precisam de atenção
- Nome e provedor
- Status atual (Ativo, Configurando, Erro)
- Endereço SIP
- Indicadores de Inbound/Outbound configurados
Criando um SIP Trunk
O processo de criação é guiado por um wizard de 3 etapas:1
Escolha o Provedor
Clique em Novo SIP Trunk no canto superior direito.Na primeira tela, selecione seu provedor:
- Twilio - IPs e endereço preenchidos automaticamente
- Telnyx - IPs e endereço preenchidos automaticamente
- Plivo - IPs e endereço preenchidos automaticamente
- Custom - Configuração manual completa
2
Configure o Trunk
Preencha as informações de configuração:Nome do Trunk (obrigatório)
- Um nome descritivo para identificar o trunk
- Exemplo: “Twilio Principal”, “Telnyx Vendas”
- Preenchido automaticamente para provedores conhecidos
- Para Custom, informe o endereço do servidor SIP
- Lista de IPs/CIDRs do seu provedor
- Preenchido automaticamente para provedores conhecidos
- Um IP ou CIDR por linha
- Ativo por padrão
- Melhora a qualidade do áudio removendo ruídos de fundo
3
Configure Credenciais (Opcional)
Para fazer chamadas de saída, configure as credenciais:UsernameClique em Criar Trunk para finalizar.
- Usuário de autenticação SIP do seu provedor
- Senha de autenticação SIP
Se você não configurar credenciais, apenas chamadas de entrada (inbound) funcionarão. Chamadas de saída (outbound) requerem autenticação.
Após a Criação
Depois de criar o trunk:- Status Configurando: O sistema cria os recursos no TropiCall
- Status Ativo: Em alguns segundos, o trunk estará pronto
- Próximo passo: Configure seu provedor SIP conforme as instruções
Configurando no Provedor
Após criar o SIP Trunk no Tropicall, você precisa configurar seu provedor para direcionar as chamadas. Clique em Ver Instruções de Setup no card do trunk para ver as instruções específicas.Twilio
Twilio
Passo 1: Criar SIP Trunk no Twilio
- Acesse o Console do Twilio
- Navegue para Elastic SIP Trunking → Manage → Trunks
- Clique em Create new SIP Trunk
- Dê um nome ao trunk (ex: “Tropicall”)
Passo 2: Configurar Origination (Chamadas Inbound)
- No trunk criado, vá para a aba Origination
- Clique em Add new Origination URI
- No campo Origination SIP URI, insira o endpoint mostrado nas instruções do Tropicall
- Formato:
sip:seu-endpoint.sip.tropicall.ai
- Formato:
- Configure Priority: 10
- Configure Weight: 10
- Salve as configurações
Passo 3: Configurar Termination (Chamadas Outbound)
- Vá para a aba Termination
- Copie o Termination SIP URI (você usará no Tropicall se precisar de outbound)
- Em IP Access Control Lists, adicione os IPs do Tropicall se necessário
- Em Credential Lists, configure username e password
Passo 4: Associar Número
- Vá para Phone Numbers no console Twilio
- Selecione o número que deseja usar
- Em Voice Configuration, selecione SIP Trunk
- Escolha o trunk criado no passo 1
Telnyx
Telnyx
Passo 1: Criar FQDN Connection
- Acesse o Portal Telnyx
- Navegue para Voice → SIP Trunking
- Clique em Create SIP Connection
- Selecione FQDN como tipo de conexão
- Dê um nome à conexão (ex: “Tropicall”)
Passo 2: Configurar Inbound
- Em Inbound Settings, adicione o FQDN do Tropicall
- Use o endpoint mostrado nas instruções:
seu-endpoint.sip.tropicall.ai
- Use o endpoint mostrado nas instruções:
- Configure Destination Number Format para
+E.164 - Selecione o protocolo desejado (TCP ou UDP)
Passo 3: Configurar Outbound
- Em Outbound Settings, crie um Outbound Voice Profile
- Configure autenticação com username e password
- Defina as regras de roteamento conforme necessário
Passo 4: Associar Número
- Vá para Numbers no portal
- Selecione seu número
- Associe à conexão SIP criada
Plivo
Plivo
Passo 1: Criar Inbound Trunk
- Acesse o Console Plivo
- Navegue para Zentrunk → Inbound Trunks
- Clique em Create New Inbound Trunk
- Adicione o URI do Tropicall:
sip:seu-endpoint.sip.tropicall.ai
Passo 2: Criar Outbound Trunk
- Vá para Zentrunk → Outbound Trunks
- Clique em Create New Outbound Trunk
- Configure Credential List com username e password
- Copie o Termination SIP Domain
Passo 3: Associar Número
- Vá para Phone Numbers no console
- Selecione seu número
- Configure Application para usar o Inbound Trunk criado
Provedor Customizado
Provedor Customizado
Informações Necessárias
Para configurar um provedor customizado, você precisará:-
Endpoint SIP do Tropicall: Mostrado na tela de instruções
- Formato:
sip:seu-endpoint.sip.tropicall.ai
- Formato:
-
IPs do seu provedor: Para configurar no campo “IPs Permitidos” do Tropicall
- Consulte a documentação do seu provedor
- Credenciais SIP: Username e password para autenticação outbound
Requisitos Técnicos
- Codec suportado: G.711 (PCMU/PCMA)
- DTMF: RFC 2833 recomendado
- Timeout: Mínimo 30 segundos
Configuração no Provedor
Configure seu provedor para:- Enviar chamadas inbound para o endpoint do Tropicall
- Aceitar chamadas outbound autenticadas com as credenciais configuradas
Vinculando Números ao Trunk
Após configurar o SIP Trunk, você pode vincular números de telefone para usar esse trunk em vez do provedor padrão.1
Acesse Números de Telefone
Vá para a página Números de Telefone no menu lateral
2
Selecione o Número
Encontre o número que deseja vincular ao trunk
3
Abra o Menu
Clique no menu de três pontos (⋮) no card do número
4
Vincular ao Trunk
Selecione Vincular SIP Trunk e escolha o trunk desejado
5
Revincule o Agente
Se o número já tinha um agente vinculado, revincule-o para aplicar o novo trunk
Quando você vincula um número a um SIP Trunk customizado, as chamadas passam a ser roteadas através do seu provedor em vez do provedor padrão do Tropicall.
Desvincular do Trunk
Para voltar a usar o provedor padrão:- Acesse o menu do número (⋮)
- Selecione Vincular SIP Trunk
- Escolha a opção para remover o vínculo
Status dos Trunks
| Status | Cor | Descrição | Ação |
|---|---|---|---|
| Ativo | Verde | Trunk configurado e funcionando | Pronto para uso |
| Configurando | Azul | Criando recursos no TropiCall | Aguarde alguns segundos |
| Pendente | Amarelo | Aguardando configuração inicial | Complete a criação |
| Erro | Vermelho | Falha na configuração | Verifique a mensagem e tente novamente |
O que fazer em cada situação?
Status Configurando
Status Configurando
O trunk está sendo criado no sistema. Isso leva apenas alguns segundos.Se o status persistir por mais de 1 minuto, atualize a página.
Status Erro
Status Erro
Houve uma falha na criação do trunk. A mensagem de erro aparece no card.Ações:
- Verifique se os IPs estão no formato correto (CIDR)
- Confirme se o endereço SIP é válido
- Clique em Tentar Novamente para reprocessar
Chamadas não funcionam
Chamadas não funcionam
Se o trunk está ativo mas as chamadas não funcionam:Para chamadas inbound:
- Verifique se configurou o provedor corretamente
- Confirme se o endpoint SIP está correto no provedor
- Verifique se os IPs permitidos incluem todos os IPs do seu provedor
- Confirme se as credenciais estão corretas
- Verifique se o provedor aceita conexões do Tropicall
Gerenciando Trunks
Visualizar Instruções de Setup
A qualquer momento, você pode ver as instruções de configuração:- Localize o trunk na lista
- Clique em Ver Instruções de Setup ou acesse pelo menu (⋮)
- A tela mostra o endpoint SIP e instruções passo a passo
Tentar Novamente (Retry)
Se um trunk está com erro:- Clique no botão Tentar Novamente no card
- O sistema tentará recriar os recursos no TropiCall
- Aguarde o novo status
Excluir um Trunk
1
Acesse o Menu
Clique no menu (⋮) no card do trunk
2
Selecione Excluir
Clique em Excluir
3
Confirme
Leia o aviso e confirme a exclusão
- Os recursos no TropiCall são removidos
- Números que estavam vinculados voltam ao provedor padrão
- A configuração no seu provedor SIP permanece (remova manualmente se necessário)
Resolução de Problemas
| Problema | Causa Provável | Solução |
|---|---|---|
| Trunk fica em “Erro” | IPs ou endereço SIP inválidos | Verifique o formato e tente novamente |
| Chamadas inbound não chegam | Provedor não configurado | Siga as instruções de setup do provedor |
| Chamadas inbound caem | IPs não autorizados | Confirme que todos os IPs do provedor estão na lista |
| Chamadas outbound falham | Credenciais incorretas | Verifique username e password |
| Qualidade ruim do áudio | Codec incompatível | Confirme uso de G.711 no provedor |
| Trunk não deleta | Números vinculados | Desvincule os números primeiro |
Boas Práticas
Nomeie Descritivamente
Use nomes que identifiquem o propósito: “Twilio Vendas”, “Telnyx Suporte”. Facilita a gestão com múltiplos trunks.
Teste Antes de Produção
Configure e teste o trunk com um número de teste antes de migrar números importantes.
Mantenha Credenciais Seguras
Use credenciais específicas para o Tropicall. Evite compartilhar com outros sistemas.
Monitore os Status
Verifique periodicamente se os trunks estão ativos, especialmente após mudanças no provedor.
Quando usar BYOC vs. Números Tropicall?
| Cenário | Recomendação |
|---|---|
| Começando do zero | Use Números Tropicall |
| Já tem números em uso | Use BYOC para manter os números |
| Precisa de cobertura internacional específica | Use BYOC com provedor global |
| Quer simplicidade | Use Números Tropicall |
| Tem acordos comerciais com provedor | Use BYOC para aproveitar preços |

