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, loginadmin). - [ ] Perfil
admin(a edição da política exige admin; a leitura é de viewer). - [ ] Números de teste por cenário: entrada com
+55prefixado, sem prefixo,0800e 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]

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]

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]

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]

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 dialplanjá 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 |