Ir para o conteúdo principal

Integrações SIP

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 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:

  1. G.711 (u-law / a-law)

  2. 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.

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.

Voltar ao topo