Ir para o conteúdo

Roteiro: Cadastrar operadora de saída com tronco e rotas

Perfil necessário: admin Menus usados: Roteamento, Sistema Risco: alto (rota/tronco errado afeta todo tráfego de saída do CN) Rollback: desabilitar rotas novas e/ou colocar tronco em quarantine; recarregar

Pré-requisitos

  • [ ] Dados do carrier: host/porta SIP, codecs aceitos, limites contratados (CPS/canais)
  • [ ] Formato de CLI acordado (wire format) e particularidades de headers
  • [ ] Janela de aplicação das rotas (sempre/portado/LDN etc.)

Passo a passo

1. Criar a operadora

Caminho: Roteamento → Operadoras e Troncos → aba Operadoras Clique: [Nova Operadora]

Aba Operadoras com botão Nova Operadora destacado

Preencha: nome da operadora e dados de referência (contato/homologação).

Resultado esperado: operadora criada e listada na aba.

2. Criar o tronco SIP

Caminho: Roteamento → Operadoras e Troncos → aba Troncos Clique: [Novo Tronco]

Aba Troncos com botão Novo Tronco destacado

Preencha (campos principais):

Campo Obrig. Formato/exemplo Efeito
Operadora sim operadora do passo 1 dono do tronco
Host/Porta SIP sim gw1.carrier:5060 destino de sinalização
Codecs sim lista permitida negociação SDP
Limites CPS/canais sim inteiros proteção e contrato
CLI wire format sim E.164/nacional/etc. formato do CLI entregue
Status sim in_service recém-homologado pode iniciar em quarantine

Resultado esperado: tronco criado, status visível na listagem.

3. Criar as rotas por operadora

Caminho: Roteamento → Operadoras e Troncos → aba Rotas por Operadora Clique: [Nova Rota]

Aba Rotas com botão Nova Rota destacado

Preencha (campos principais):

Campo Obrig. Formato/exemplo Efeito
Operadora destino sim operadora alvo para onde a chamada sai
Prioridade sim inteiro (menor precede) ordem de casamento
Operadoras Destino (RN1) não seleção de CNs restrição por área
Portabilidade sim Sempre/Só portado/Só LDN/Só saída/Só entrada janela de aplicação por portabilidade
Status ativo sim booleano habilitação da rota

Resultado esperado: rota listada na ordem de prioridade; repetir para cobrir os CNs desejados.

4. Criar política de headers (se a operadora exigir)

Caminho: Roteamento → Operadoras e Troncos → aba Headers Clique: [Nova Header Policy]

Aba Headers com botão Nova Header Policy destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Operadora sim operadora alvo dono da política
Nome do Header sim ex. P-COLP header a manipular
Prioridade sim inteiro ordem de aplicação

Resultado esperado: política listada; chamadas para essa operadora passam a incluir o header.

5. Recarregar OpenSIPS

Caminho: Sistema → OpenSIPS Clique: [Recarregar todos os módulos]

Reload com botão destacado

Resultado esperado: reload de dispatcher/drouting sem erro.

6. Validar antes de Produção

  1. Testar Classificação com números portado e não portado do CN alvo — conferir CN/regime.
  2. Shadow comparison (padrão do projeto para mudança de carrier routing):
mysql -u opensips -popensips iproute_sw < scripts/carrier_shadow_report.sql
  1. Chamada de teste real e conferência no CDR (rota usada = rota nova).

Classifier Tester

Validação

  • [ ] Operadora, tronco e rotas visíveis nas abas
  • [ ] Shadow report sem divergência inesperada
  • [ ] Chamada real com 200 e CDR apontando a rota nova
  • [ ] CLI recebido no destino no formato acordado

Erros comuns

Sintoma Causa provável Correção
Rota nunca casada prioridade coberta por rota anterior mais genérica reordenar prioridades
Chamadas caem para rota de baixo tronco em quarantine esquecido mudar status para in_service
488/415 no EGRESS codecs do tronco incompatíveis ajustar lista de codecs
CLI rejeitado pelo carrier wire format divergente ajustar CLI wire format do tronco
Rota não aplica reload não executado Recarregar todos os módulos

Impacto operacional

  • Mudança de rota altera destino de todo tráfego casado — sempre shadow antes.
  • Tronco em quarentena desvia tráfego silenciosamente; monitore a aba Troncos.
  • Header policy errada pode fazer o carrier rejeitar (403/488) — testar com chamada real.