Comunicação OpenSIPS ao SIPPROXY TSi Telecom

1. O que é o OpenSIPS nesta arquitetura

O OpenSIPS é um servidor SIP de alto desempenho que atua como SBC (Session Border Controller), registrador, roteador e softswitch na infraestrutura da TSi Telecom. Ele é o ponto central que recebe e envia toda a sinalização SIP entre endpoints (telefones, softphones, PABXs) e o mundo externo.

Nesta implementação, o OpenSIPS não apenas registra usuários e roteia chamadas: ele também gerencia autenticação, diálogos, NAT traversal, áudio RTP (via RTPProxy), filas de call center, balanceamento de carga entre gateways e rastreamento de chamadas. Tudo isso é feito com base em módulos especializados carregados dinamicamente.

A conexão com a operadora de telefonia é feita por meio do SIPPROXY, o servidor SIP da TS Telecom que recebe as chamadas destinadas à rede pública (PSTN) e devolve as chamadas recebidas. O endereço desse proxy é sipproxy.tsitelecom.com.br, que resolve para 177.10.116.79 e escuta na porta 5060 (UDP e TCP).

2. Arquitetura e diagrama completo

A plataforma é dividida em camadas bem definidas. A camada de sinalização SIP é independente da camada web de relatórios, garantindo segurança e isolamento.

Nota importante: a landpage que você está lendo faz parte da camada web de documentação. A sinalização SIP em si flui diretamente entre o OpenSIPS Core e o SIPPROXY, sem passar por navegadores ou pela internet comum.

3. Serviços, containers e funções

Cada componente da stack é executado em um container Docker independente, conectado à rede interna tsi-network. Essa separação facilita manutenção, atualizações e escalabilidade.

4. Portas, protocolos e firewall

Abaixo estão todas as portas utilizadas pelos serviços OpenSIPS, com indicação de onde são expostas e quem pode acessá-las.

Status de comunicação com o SIPPROXY

Testes de conectividade realizados diretamente com sipproxy.tsitelecom.com.br (177.10.116.79):

Portas expostas na internet (UFW)

Portas internas (rede Docker tsi-network)

5. Módulos ativos e o que cada um faz

O poder do OpenSIPS vem dos seus módulos. Cada módulo adiciona uma capacidade específica à plataforma. Abaixo estão os principais módulos carregados na configuração atual.

6. Fluxo completo de uma chamada

Entender o caminho de uma chamada ajuda a diagnosticar problemas e a treinar equipes. Abaixo está o fluxo passo a passo.

6.1 Registro de um ramal (REGISTER)

1. O telefone envia um REGISTER sip:opensips.tsiapp.io SIP/2.0 para a VPS na porta 5060.
2. O OpenSIPS recebe a mensagem e verifica se o domínio é conhecido (is_myself("$rd")).
3. O módulo auth_db exige autenticação digest usando usuário e senha da tabela subscriber.
4. Se autenticado, o registrar salva a localização do ramal no usrloc e no MariaDB.
5. O telefone recebe 200 OK e fica disponível para receber chamadas.

6.2 Chamada para fora (INVITE → PSTN via SIPPROXY)

1. O ramal disca um número, por exemplo 5511999999999, e envia INVITE ao OpenSIPS.
2. A rota principal detecta que o destino é numérico e direciona para route(pstn).
3. route(require_auth) verifica se o originador é confiável (tabela address) ou exige autenticação.
4. O módulo drouting consulta as rotas de discagem e define o próximo salto.
5. O rtpproxy insere um SDP intermediário para permitir que o áudio flua corretamente.
6. O OpenSIPS encaminha o INVITE para sipproxy.tsitelecom.com.br:5060 (177.10.116.79).
7. O SIPPROXY completa a chamada na rede pública (PSTN).
8. Respostas e BYE trafegam pelo mesmo caminho, gerenciados pelo módulo dialog.

6.3 Chamada para o Call Center (filas)

1. O usuário disca *800.
2. O OpenSIPS identifica o prefixo e direciona para route(callcenter).
3. O módulo call_center coloca a chamada na fila tsiapp_support.
4. Quando um agente fica disponível, a chamada é entregue a ele.
5. Durante a espera, o MOH (Asterisk) fornece música de espera.

7. Configuração do SIPPROXY explicada

No arquivo /opt/tsi-stack/apps/opensips/config/opensips.cfg, existe um tratamento especial para mensagens REGISTER cujo domínio de destino seja o SIPPROXY. Isso é útil quando endpoints são configurados para se registrar diretamente no domínio da operadora, mas o OpenSIPS precisa interceptar e redirecionar para o IP correto.

Trecho de configuração

if (is_method("REGISTER")) {
    if ($rd == "sipproxy.tsitelecom.com.br") {
        xlog("L_INFO", "REGISTER outbound override: $rd -> 177.10.116.79:5060\n");
        $rd = "177.10.116.79";
        $rp = "5060";
    }
}

O que esse trecho faz?

• $rd é a variável que representa o domínio do Request-URI da mensagem SIP.
• $rp representa a porta do Request-URI.
• Se um REGISTER chegar destinado a sipproxy.tsitelecom.com.br, o OpenSIPS altera o destino para o IP 177.10.116.79 e porta 5060.
• Em seguida, como o novo destino não é local (!is_myself("$rd")), o fluxo cai em route(relay), que chama t_relay() e encaminha o REGISTER ao SIPPROXY.

Por que isso é importante?

Alguns telefones e PABXs são configurados com o domínio textual da operadora em vez do IP. Sem esse override, o OpenSIPS tentaria resolver o domínio ou tratar a mensagem localmente, o que poderia falhar. Com o override, a mensagem é encaminhada de forma determinística para o IP correto.

8. Ferramentas de operação

MI HTTP (Management Interface)

A porta 8888 expõe uma API JSON-RPC que permite consultar e controlar o OpenSIPS programaticamente. Exemplo de consulta de versão:

POST http://172.20.50.2:8888/mi/
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "version",
  "id": 1
}

Resposta típica:

{"jsonrpc":"2.0","result":{"Server":"OpenSIPS (3.6.6 (x86_64/linux))"},"id":1}

Backup e recuperação

O script /opt/tsi-stack/apps/opensips/scripts/backup.sh realiza backup automatizado do banco MariaDB e dos arquivos de configuração. Os backups são armazenados em /opt/tsi-stack/apps/opensips/backups/ com data e hora.

9. Camadas de segurança

10. Troubleshooting rápido