Roteiro: Usar a aba "Como funciona" do motor de carrier routing¶
Perfil necessário: admin ou viewer (conteúdo informativo) Menus usados: Roteamento Risco: baixo (aba apenas informativa) Rollback: não aplicável — nenhuma mutação
O que tem na aba¶
Caminho: Roteamento → Operadoras e Troncos → aba Como funciona
Clique: [Como funciona] (última tab do topo da página)

Conteúdo da aba (fonte oficial do modelo mental — os roteiros da pasta complementam o "como fazer"):
- Fluxo completo de uma chamada de saída — as 8 etapas do INVITE, da identificação da origem à entrega:
- Identificação da origem (address/digest → linha/cliente)
- Normalização do número B (E.164 da plataforma)
- Classificação (
LOC_FIX,LOC_MOB,LDN_FIX,VC2_MOB,VC3_MOB,LDI,EMG…) - Consulta BDO (
rn1_out,portado) - Regra de perfil de linha (
use_carrier_routing/route_to_endpoint/reject) - Seleção de tronco no carrier routing (única query no plano publicado)
- Composição do R-URI (template com tokens → só dígitos)
-
INVITE ao endpoint do tronco (falha → quarentena + próximo candidato; esgotado → contingência do perfil)
-
Diagrama da seleção de tronco (etapa 6) — filtros da rota, ordenação de candidatos (① match_rn1 exato antes de NULL, ② primary antes de fallback, ③ prioridade da rota, ④ posição/peso do tronco, ⑤ falhas consecutivas →
LIMIT 1) e o desvio de contingência. -
Modelo de cadastro atual — tabela conceito/onde/papel: Rota por Operadora (aba principal), Operadora (aba Operadoras), Tronco (aba Troncos), Cobertura gerenciada (gerada pela rota, não cadastrada à mão) e Plano publicado (
routing_plan_*, snapshot do OpenSIPS). -
RN1, operadora e tronco — como usar Operadoras Destino (RN1), troncos da rota (máx. 2 operadoras), Tipos de Ligação, RN2 Override e Códigos SIP para failover.
-
Tokens do template de entrega — tabela de substituição:
__RN2__(override da rota ou prefix do tronco),__RN1__(BDO),__RN3__(só portado, exigesend_rn3=1),__CSP__,__CN__,__DEST_E164__,__DEST_NATIONAL__,__DEST_LOCAL__— com exemplos renderizados (__RN2____DEST_E164__→1121125549984253301etc.). -
Como configurar uma rota — receita de 4 passos: operadoras (RN1 correto) → troncos (endpoint +
rn2_prefix+ template) → rota única (tipos, filtros, operadoras destino, troncos) → Publicar plano (sem publicar, as chamadas continuam no último plano).
Aviso da própria aba: se a rota filtrar operadora destino e a BDO retornar outro RN1, a chamada não usará aqueles troncos. Para rota coringa, deixe Operadoras Destino (RN1) vazio.
Validação¶
- [ ] Aba abre sem erro e as seções acima estão presentes
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Aba em branco | JS não carregou (build dev parado) | recarregar a página; conferir npm run dev no frontend |
| Conteúdo divergente do comportamento real | fonte do projeto mudou sem atualizar os roteiros | abrir issue atualizando docs/admin-ui/guides/carrier-*.md junto da view |