Ir para o conteúdo

Roteiro: Dialplan — criar regra de reescrita e testar

Perfil necessário: admin Menus usados: Roteamento, Sistema Risco: alto (DPID errado altera destino de todo tráfego que consulta esse grupo) Rollback: desabilitar a regra (Status) e recarregar dialplan

Pré-requisitos

  • [ ] DPID alvo conhecido (qual fluxo do OpenSIPS consulta esse grupo)
  • [ ] Regex de match/substituição desenhada e casos de teste definidos

Passo a passo

1. Abrir o dialplan

Caminho: Roteamento → Avançado → Dialplan

Dialplan com botão Nova Regra destacado

Use o filtro DPID no topo para isolar o grupo que você vai alterar.

2. Criar a regra

Clique: [Nova Regra]

Preencha:

Campo Obrig. Formato/exemplo Efeito
DPID sim inteiro (grupo alvo) conjunto consultado pelo runtime
Prioridade não inteiro ordem de avaliação no DPID
Tipo Match sim regex/expressão conforme UI tipo de casamento
Expressão Match sim ^0(55\d{10,11})$ padrão do número de entrada
Expressão Substituição não 55\1 reescrita (capturas \1)
Status sim habilitado/desabilitado vigência
Atributos não pares chave/valor da UI extras consumidos pelo roteamento

Clique: [Criar]

Resultado esperado: regra listada no DPID na posição de prioridade correta.

3. Testar antes do reload

No cartão Testar Dialplan (rodapé):

Campo Obrig. Exemplo
DPID sim o mesmo do passo 2
Número sim 0551199999999

Clique: [Testar]

Resultado esperado: indica a regra casada e o resultado da substituição.

4. Recarregar dialplan

Caminho: Sistema → OpenSIPS Clique: [Recarregar todos os módulos] (ou reload individual de dialplan)

Reload

5. Validar

  • [ ] Teste do cartão reflete a nova regra
  • [ ] Chamada real com número do caso de teste gera CDR com destino correto
  • [ ] Casos negativos (que não devem casar) permanecem inalterados

Erros comuns

Sintoma Causa provável Correção
Regra nunca casa prioridade inferior a regra genérica anterior reordenar prioridade
Casou o errado regex sem âncora (^/$) ancorar a expressão
Dígito perdido na reescrita captura \1 faltante/malformada revisar grupos da regex
Mudança não faz efeito reload pendente Recarregar (dialplan)

Impacto operacional

  • Dialplan é hot path de roteamento: regra nova em DPID de produção altera tráfego imediatamente após o reload.
  • Sempre teste casos positivos e negativos antes do reload.