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 (
_pfperfil de saída,_lpnnormalização por perfil,_aauto-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

- Aviso no topo da tabela: entradas
_pf/_lpn/_asã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 #Nquando os attrs definem), Rota (nome emroute_name), Status (Ativo/Inativo), Atualizado.
2. Criar a regra¶
Clique: [Nova Regra]

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

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 |