Integração via SIP
Este documento descreve os parâmetros necessários para integrar sistemas de telefonia (PBX, gateways ou aplicações SIP) aos serviços da Tallk.me atuando como provedor VoIP.
Dados de Sinalização SIP
-
FQDN do SBC (SIP Server):
sbc.tallk.me-
⚠️ O FQDN atualmente resolve para o IP 38.210.208.222.
-
Recomenda-se fortemente utilizar o FQDN em vez do IP fixo, pois o apontamento pode ser alterado automaticamente em caso de contingência ou manutenção.
-
É essencial que o serviço de DNS esteja plenamente funcional, permitindo a atualização dinâmica desse apontamento.
-
-
Porta de registro SIP:
5060(UDP, salvo configuração específica em contrário)
Parâmetros de Mídia (RTP)
-
Range de portas RTP:
10000 – 30000(UDP) -
IPs de mídia (RTP):
-
38.210.208.218 -
38.210.208.219
-
Esses endereços devem estar explicitamente liberados no firewall para tráfego UDP bidirecional dentro do range de portas informado.
Codecs Suportados
Os codecs abaixo devem ser configurados na ordem de preferência:
-
G.711 (u-law / a-law)
-
G.729
Observação: recomenda-se evitar a habilitação de codecs adicionais para prevenir negociações incorretas e possíveis falhas de áudio.
Uso via WebPhone
Caso o cliente utilize os serviços da Tallk através do WebPhone, e possua firewall ou proxy restritivo, é necessário:
-
Permitir tráfego TCP irrestrito com o FQDN:
-
wrtc.tallk.me -
IP atual:
38.210.210.149
-
Esse acesso é essencial para o correto funcionamento de sinalização e mídia via WebRTC.
APIs Relacionadas
-
API Interna de Agentes:
api-agente.tallk.me
Esse endpoint é utilizado para integrações sistêmicas e não interfere diretamente no fluxo SIP/RTP, mas pode ser necessário em cenários de automação.
Recomendações Adicionais para Ambientes com Firewall Restritivo
Para garantir uma comunicação SIP estável e saudável em redes restritas, recomenda-se também validar os pontos abaixo:
1. Protocolo de Transporte
-
Priorizar UDP para SIP e RTP, salvo orientação contrária.
-
Evitar inspeção SIP (SIP ALG) no firewall.
-
🔴 SIP ALG deve estar desativado, pois costuma causar problemas de registro, áudio unilateral ou quedas de chamada.
-
2. NAT e Keepalive (Fazer conforme orientaçã)
-
Caso o equipamento esteja atrás de NAT:
-
Habilitar NAT Keepalive (OPTIONS ou CRLF keepalive).
-
Configurar intervalos de keepalive entre 15 e 30 segundos.
-
3. Timeout de Sessão
-
Garantir que o firewall não finalize sessões UDP prematuramente:
-
SIP: timeout ≥ 60 segundos
-
RTP: timeout ≥ 120 segundos
-
4. Resolução DNS
-
O firewall deve permitir:
-
Consultas DNS (UDP/TCP 53)
-
Atualizações periódicas de cache
-
Isso é crítico para o correto funcionamento do FQDN sbc.tallk.me.
5. QoS (Opcional, mas Recomendado)
-
Priorizar tráfego SIP/RTP via QoS, quando disponível:
-
SIP (5060)
-
RTP (10000–30000)
-
6. Sincronização de Tempo (Recomendado)
-
Garantir que o equipamento SIP esteja com NTP funcional, evitando problemas de autenticação e expiração de registros.
7. Plano de discagem
-
Invite com DDD + número. (10-11) dígitos. Exemplo: 1122223333 ou 11988887777
Serviços que envolvem DIDs ou 0800
A configuração de DID com plataforma de terceiros funciona bem com tudo que foi descrito acima, mas se a sua plataforma tem alguma limitação, temos a flexibilidade em alterar o formato do envio no INVITE. Isso necessariamente altera os IPs envolvidos.
Fique atento e consulte o nosso time de suporte para demais esclarecimentos.
Considerações Importantes
Fique atento caso exista qualquer configuração personalizada no ambiente do cliente.
Em alguns cenários, pode ser necessário:
-
Solicitar o registro SIP em outro IP ou domínio
-
Manter um formato de registro diferente do padrão, especialmente em clientes mais antigos
Em ambientes legados, é possível que o registro SIP já tenha sido configurado anteriormente de forma distinta do modelo tradicional atualmente adotado.
Nessas situações, é fortemente recomendado consultar o time de suporte interno da Tallk antes de realizar alterações, garantindo a definição do melhor plano de ação e evitando impactos em produção.
Em caso de dúvidas adicionais ou cenários específicos (PBX legado, múltiplos NATs, SBC próprio, etc.), recomenda-se validar a topologia antes da ativação em produção.
Nosso time de suporte está a disposição para auxilio e acompanhamento da comunicação em nossa ponta.