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]

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]

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]

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]

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]

Resultado esperado: reload de dispatcher/drouting sem erro.
6. Validar antes de Produção¶
- Testar Classificação com números portado e não portado do CN alvo — conferir CN/regime.
- Shadow comparison (padrão do projeto para mudança de carrier routing):
mysql -u opensips -popensips iproute_sw < scripts/carrier_shadow_report.sql
- Chamada de teste real e conferência no CDR (rota usada = rota nova).

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.