Ir para o conteúdo

Roteiro: Ajustar a política global de entrada e a normalização inbound

Perfil necessário: admin Menus usados: Comercial Risco: médio — a política global vale para toda chamada de entrada; uma regra de normalização errada altera o número chamado antes da resolução do DID e pode derrubar a entrega inbound inteira. Rollback: desabilitar ou excluir a regra de normalização (a própria tela recompila e recarrega o dialplan do OpenSIPS); voltar a Ação padrão de entrada para Permitir e o Código de rejeição para o valor anterior editando a política. O fallback padrão de E.164 BR volta a ser o único tratamento quando não houver regra cadastrada.

Pré-requisitos

  • [ ] Serviços no ar e admin acessível (http://<host>:5173, login admin).
  • [ ] Perfil admin (a edição da política exige admin; a leitura é de viewer).
  • [ ] Números de teste por cenário: entrada com +55 prefixado, sem prefixo, 0800 e DDD nu (ex.: +554932401000, 4932401000, 08001234567, 47991385477).
  • [ ] Comportamento desejado acordado: o que acontece quando a política ativa e quando não há rota para o DID chamado.

Passo a passo

1. Abrir a Política de Entrada

Caminho: Comercial → Políticas → Política de Entrada Clique: [Editar política]

Página Política de Entrada com o botão Editar política da política global destacado

A aba Política de Entrada mostra a política global da plataforma (singleton) em uma linha: Nome, Status, Ação padrão, Sem Rota (código + motivo) e Trace. Este é o comportamento-padrão de toda chamada inbound antes da resolução do destino final.

2. Ajustar a política global

Caminho: Comercial → Políticas → Política de Entrada → dialog Editar política de entrada Clique: [Salvar]

Preencha:

Campo Obrig. Formato/exemplo Efeito
Nome sim Inbound Global identificação da política (registro único)
Status sim Ativo / Inativo política vigente ou desligada
Descrição não texto livre contexto para o próximo operador
Ação padrão de entrada sim Permitir / Rejeitar veredito da entrada quando a política ativa
Ação sem rota sim Rejeitar o que fazer quando o DID não resolve destino
Código de rejeição sim inteiro 400–699, ex.: 404 código SIP devolvido ao caller
Motivo não texto curto, ex.: Inbound route unavailable reason da resposta SIP
Observabilidade sim Trace habilitado / Trace desabilitado nível de log por chamada inbound

Resultado esperado: toast "Política de entrada atualizada"; a tabela da aba passa a refletir os novos valores.

A mutação da política global não recompila dialplan: ela é lida do banco na hora da chamada. A cadeia de normalização (passo seguinte) é a peça que exige recarga.

3. Criar uma regra de normalização inbound

Caminho: Comercial → Políticas → Política de Entrada → aba Normalização Inbound Clique: [Nova Regra]

Aba Normalização Inbound com o botão Nova Regra destacado

Sem regra aplicável, o fallback padrão tenta converter o número chamado para o formato E.164 da plataforma (55..., sem +). As regras da tabela rodam por prioridade crescente antes desse fallback.

4. Preencher a regra

Caminho: dialog Nova regra inbound Clique: [Criar]

Dialog Nova regra inbound com os campos de match e transformação

Preencha:

Campo Obrig. Formato/exemplo Efeito
Nome * sim Entrada CSP 0xx a E164 identificação na lista
Prioridade sim inteiro ≥ 0 (default 10); menor = primeiro ordem de avaliação
Ativa sim Sim / Não vigência da regra
Tipo de match * sim Prefixo, Exato ou Regex como casar o número chamado
Prefixo a casar / Número exato / Regex de match * sim conforme o tipo, ex.: ^0(1[1-9]|21)9 valor casado
Transformação * sim Regex replace, Remover prefixo, Prefixar texto, Forçar E.164 da plataforma, Remover CSP do cliente o que fazer quando casa
Regex de substituição * / Prefixo a remover * / Texto a prefixar * quando a transformação exige ex.: padrão ^0(\d+)$ e replace 55$1 parâmetros da transformação
Parada sim Parar na regra / Continuar cadeia encerra ou segue para a próxima regra
Descrição não texto livre contexto da regra

Resultado esperado: toast "Regra inbound criada"; a regra aparece na tabela com Match, Transformação, Fluxo (Para/Continua) e Status (Ativa). A regra é compilada em dialplan e o OpenSIPS recarrega a partição dialplan automaticamente após salvar — o toast alerta se o dp_reload falhar ("Regra salva, mas dp_reload falhou"). Use as setas ↑/↓ da linha para reordenar prioridade (a troca também recompila e recarrega).

5. Testar a normalização inbound

Caminho: Comercial → Políticas → Política de Entrada → aba Normalização Inbound → painel Testar normalização inbound Clique: [Testar]

Painel Testar normalização inbound com o número chamado e o botão Testar destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Número chamado sim 55119991385477, 08001234567 número que o operador envia na entrada

Resultado esperado: o painel mostra Original → Final, Match (Sim/Não), Fallback (Aplicado/Não) e a lista de passos (#id Nome da regra, match/skip, ação e antes -> depois), terminando no Fallback quando nenhuma regra casa. O teste é leitura: não altera dados nem o runtime.

Validação

  • [ ] Visual: tabela da aba mostra a regra Ativa na posição de prioridade esperada; painel de teste exibe Original/Final e os passos aplicados.
  • [ ] Funcional: chamada SIPp do cenário coberto pela regra entra normalizada (CDR com o B na forma 55...) e recebe 200; um número fora de qualquer regra segue pelo fallback e também entrega.
  • [ ] Runtime: opensips-cli -x mi dp_reload dialplan já executado pelo backend (audit log registra compile + reload por mutação); regra desabilitada cessa de valer após o reload.

Erros comuns

Sintoma Causa provável Correção
Regra salva mas número entra sem normalizar regra Inativa, prioridade maior que outra que para antes, ou match que não casa o formato real conferir Status/prioridade; rodar o Testar com o número exato do operador
Toast "Regra salva, mas dp_reload falhou" OpenSIPS sem acesso MI/FIFO no host do backend verificar opensips-cli -x mi dp_reload dialplan e permissões de FIFO; recompilar depois de corrigir
Chamada legítima rejeitada com o código configurado Ação padrão de entrada em Rejeitar ou Ação sem rota ativa sem rota resolvida voltar ação para Permitir ou provisionar o DID destino
Número vira +55... com + e o destino não casa fallback produziu forma com + enquanto a entrega espera 55... sem + criar regra de normalização explícita para o formato de entrada do operador
Regra aplica e outra aplica de novo regra casada com Continuar cadeia seguida de outra que também casa ajustar Parada para Parar na regra quando o resultado final já é o desejado

Tabela de referência rápida

Transformação Parâmetro Exemplo BR
Regex replace padrão + substituição ^0(\d{2}9?\d{8})$ → 55$1
Remover prefixo prefixo literal 0
Prefixar texto texto literal 55
Forçar E.164 da plataforma — 47991385477 → 5547991385477
Remover CSP do cliente — 0XX (código de operadora) removido antes do match