Ir para o conteúdo

Roteiro: Criar e testar regra de dialplan

Perfil necessário: admin para criar/editar (viewer só consulta) Menus usados: Roteamento Risco: médio — regra com regex/prioridade errada reescreve números de produção ou sombreia regras automáticas; o reload esquecido deixa a memória do OpenSIPS velha Rollback: corrigir/excluir a regra na própria tela e Recarregar o módulo Dialplan; regras automáticas voltam ao estado do sistema reexecutando o sync de origem

Pré-requisitos

  • [ ] DPID de destino conhecido (cada DPID é um plano; chamada usa o DPID configurado na rota/perfil — confira no Testar Dialplan antes de criar)
  • [ ] Entender que entradas com marcadores em Atributos (_pf perfil de saída, _lpn normalização por perfil, _a auto-sincronizado) são gerenciadas pelo sistema: editar aqui pode ser sobrescrito a qualquer momento pelo sync — edite-as em Políticas de Saída
  • [ ] Caminho do reload aberto: Plataforma → Sistema → Reload OpenSIPS

Passo a passo

1. Abrir a página e filtrar pelo DPID

Caminho: Roteamento → Avançado → Dialplan

Página Dialplan com o botão Nova Regra destacado

  • Aviso no topo da tabela: entradas _pf/_lpn/_a são automáticas — não edite aqui.
  • Use o seletor Filtrar DPID (ou a busca por expressão) para isolar o plano que você vai mexer.
  • Colunas da listagem: DPID, Prio (prioridade), Op (REGEX/EXACT/PREFIX), Expressão, Substituição, Destino (endpoint #N/group #N quando os attrs definem), Rota (nome em route_name), Status (Ativo/Inativo), Atualizado.

2. Criar a regra

Clique: [Nova Regra]

Dialog Nova Regra do dialplan

Preencha:

Campo Obrig. Formato/exemplo Efeito
DPID * sim inteiro ≥ 0 (ex.: 0) plano de discagem ao qual a regra pertence
Prioridade sim (default 0) inteiro ≥ 0 menor prioridade avalia primeiro dentro do DPID
Tipo Match * sim REGEX (op 1), EXACT (op 2), PREFIX (op 3) como a expressão é comparada
Status sim Ativo (disabled=0) / Inativo (disabled=1) regra inativa não participa do match
Expressão Match * sim regex PCRE: ^0(55)?(\d{2})9?\d{4,5}$ · exato: 0119999999 · prefixo: 0300 padrão casado contra o número
Expressão Substituição não 55\2\3 etc. reescrita do número; \1..\9 referenciam grupos do match (o backend preenche a subst automaticamente quando há \d e guarda a expressão como subst)
Atributos não editor JSON: destination_type (endpoint/group), destination_id, route_name roteamento pós-normalização executado pelo motor de rotas

Clique: [Criar] (ou [Salvar] na edição). Regex inválida é recusada na criação/edição com 400 Regex inválida: ....

Resultado esperado: regra listada no DPID, ordenada por prioridade.

3. Testar em tempo real

Caminho: fim da própria página, card Testar Dialplan

Card Testar Dialplan com o botão Testar destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
DPID sim (default 0) inteiro ≥ 0 plano a simular
Número sim 0119999999 número B que você quer verificar

Clique: [Testar]

Resultado esperado: painel com Match: SIM/NÃO; quando casa, mostra Regra #id (expressão), Resultado (número já reescrito) e Attrs (JSON dos atributos da regra casada — destino/rota que o motor vai usar). O teste considera apenas regras Ativas do DPID, avaliadas por ordem de prioridade.

4. Recarregar o módulo Dialplan

Caminho: Plataforma → Sistema → Reload OpenSIPS Clique: [Recarregar] do cartão Dialplan

Resultado esperado: toast "Dialplan recarregado". Sem esse passo, o OpenSIPS segue usando as regras antigas em memória.

Validação

  • [ ] Visual: regra listada com status Ativo e prioridade correta no DPID
  • [ ] Funcional: Testar Dialplan com número real de produção dá o resultado esperado (match, reescrita e attrs); chamada SIPp/lab confirma o comportamento após o reload

Erros comuns

Sintoma Causa provável Correção
400 Regex inválida ao salvar expressão PCRE malformada corrigir a regex (teste primeiro no card Testar Dialplan com uma regra inativa)
Regra nova nunca casa prioridade maior que uma regra genérica anterior reordenar prioridade (menor primeiro) e reload
Teste dá Match: NÃO DPID errado ou regra Inativa conferir DPID e Status; testar de novo
Número reescrito errado em produção regex com grupo errado na substituição corrigir Expressão Substituição (\1..\9), recarregar e testar
Regra editada volta ao estado antigo entrada _pf/_lpn/_a gerenciada pelo sync editar em Políticas de Saída e rodar o sync
Mudança não tem efeito na chamada reload do módulo Dialplan esquecido Recarregar (Dialplan) na página Reload OpenSIPS

Tabela de referência rápida

Tipo Match (op) Comportamento Exemplo
REGEX (1) match PCRE com substituição por grupos ^0(\d{2})9(\d{4,5})$ → 55\1 9\2
EXACT (2) igualdade exata do número 0300
PREFIX (3) número começa com a expressão 0300 casa 03002020