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

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)

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.