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

<div contenteditable="false" id="bkmrk-">---

</div>## 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)

<div contenteditable="false" id="bkmrk--1">---

</div>## 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.

<div contenteditable="false" id="bkmrk--2">---

</div>## 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.

<div contenteditable="false" id="bkmrk--3">---

</div>## 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.

<div contenteditable="false" id="bkmrk--4">---

</div>## 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.

<div contenteditable="false" id="bkmrk--5">---

</div>## 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

<div contenteditable="false" id="bkmrk--6">---

</div>### 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.

<div contenteditable="false" id="bkmrk--7">---

</div>## 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.

<div contenteditable="false" id="bkmrk--8">---

</div>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.