Ir para o conteúdo

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)

Aba Como funciona do motor de carrier routing

Conteúdo da aba (fonte oficial do modelo mental — os roteiros da pasta complementam o "como fazer"):

  1. Fluxo completo de uma chamada de saída — as 8 etapas do INVITE, da identificação da origem à entrega:
  2. Identificação da origem (address/digest → linha/cliente)
  3. Normalização do número B (E.164 da plataforma)
  4. Classificação (LOC_FIX, LOC_MOB, LDN_FIX, VC2_MOB, VC3_MOB, LDI, EMG…)
  5. Consulta BDO (rn1_out, portado)
  6. Regra de perfil de linha (use_carrier_routing / route_to_endpoint / reject)
  7. Seleção de tronco no carrier routing (única query no plano publicado)
  8. Composição do R-URI (template com tokens → só dígitos)
  9. INVITE ao endpoint do tronco (falha → quarentena + próximo candidato; esgotado → contingência do perfil)

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

  11. 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).

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

  13. Tokens do template de entrega — tabela de substituição: __RN2__ (override da rota ou prefix do tronco), __RN1__ (BDO), __RN3__ (só portado, exige send_rn3=1), __CSP__, __CN__, __DEST_E164__, __DEST_NATIONAL__, __DEST_LOCAL__ — com exemplos renderizados (__RN2____DEST_E164__ → 1121125549984253301 etc.).

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