Roteiro: Provisionar perfil de saída com regras de destino e normalização do número B¶
Perfil necessário: admin (sync exige admin; leitura é viewer)
Menus usados: Comercial
Risco: alto — o perfil concentra a política de saída das linhas associadas a ele: regra de destino errada roteia para operadora/anúncio errado, e normalização errada corrompe o número B entregue.
Rollback: desabilitar a regra ou o perfil (Status Inativo), Recompilar o perfil para regenerar o dialplan; para desfazer a cadeia de normalização, desabilitar a regra de normalização e Recompilar na aba Normalização. O botão Sincronizar Tudo regenera o dialplan de todos os perfis ativos e recarrega o OpenSIPS ao final.
Pré-requisitos¶
- [ ] Perfil
adminpara criar perfil/regras e sincronizar. - [ ] Endpoints e/ou grupos de destino já cadastrados (o destino da regra referencia endpoint, grupo ou anúncio).
- [ ] Operadoras (RN1) já cadastradas, quando a regra casar por operadora de destino/origem.
- [ ] Anúncio existente em
Infraestrutura → Anúncios, se o destino for do tipo anúncio. - [ ] Número B de teste nos formatos que o cliente realmente envia (ex.:
049991385477,4932401000,08001234567).
Passo a passo¶
1. Abrir Políticas de Saída e criar o perfil¶
Caminho: Comercial → Políticas → Política de Saída
Clique: [Novo Perfil]

A tabela lista os perfis com contagem de Rotas do Perfil, Normalização, Tipos Autorizados, Classificação B e Status. A barra de ferramentas traz também Sincronizar Tudo (ver passo 4).
2. Preencher o perfil e salvar¶
Caminho: dialog Novo Perfil Clique: [Criar]

Preencha:
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Nome * | sim | Cliente PBX padrão |
identificação; único por perfil |
| Status | sim | Ativo / Inativo |
perfil disponível para atribuição às linhas |
| Descrição | não | texto livre | contexto |
| Tipos de chamada autorizados | não | cards: Fixo Local, Móvel Local, Fixo Nacional, VC2 Móvel, VC3 Móvel, Internacional, CNG, Serviço, Emergência |
guardrail antes do roteamento final; sem seleção = sem restrição |
| Classificação do número B | sim | Estrutural BR (única opção na v1) |
como o B é interpretado após a normalização (fixo/móvel/tollfree/serviço/internacional) |
| SUP não cadastrado (1XX curto) | sim | Rejeitar (404) / Encaminhar sem tradução (passthrough) |
rejeição segura ou bypass preservando o código discado (exige regra do perfil com tipo SUP e destino B exato; depende também do kill switch global em Sistema → Configuração) |
| Tratamento de bloqueio | sim | Áudio (via media-server) / Somente sinalização SIP |
chamada negada toca anúncio no FreeSWITCH ou recebe só o código/reason |
| Chamada a cobrar (collect call) | sim | Bloquear silenciosamente / Anunciar e encerrar / Aceitar com prompt (futuro) |
tratamento de chamadas a cobrar |
Resultado esperado: toast "Perfil criado"; o perfil aparece na tabela com 0 regra(s) de rota e normalização até você criar as regras.
3. Criar a regra de rota do perfil¶
Caminho: dialog Editar Perfil (botão de edição na linha do perfil) → seção Rotas do Perfil Clique: [Nova Regra]
As regras só aparecem no dialog de perfil já existente (edição). Ordenadas por prioridade — menor = primeiro. Destino B vazio = qualquer; tipos vazios = qualquer. Cada regra é compilada automaticamente no motor de roteamento ao salvar.Preencha (dialog Nova regra):
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Nome * | sim | Fixo local para endpoint regional |
identificação |
| Prioridade | sim | inteiro ≥ 0 (default 10) |
menor = primeiro |
| Ativa | sim | Sim / Não |
vigência |
| Correspondência do destino B | sim | Prefixo / Número exato |
use exato para SUP como 1056 ou 10314; exact compila ^valor$ e não captura códigos maiores |
| Número B exato / Prefixo B | opcional | ex.: 1056 ou 5549 (vazio = qualquer) |
condição sobre o B já classificado |
| Tipos de chamada | não | multiselect dos mesmos tipos do perfil (vazio = qualquer) | restringe a regra ao tipo classificado |
| Operadoras destino (RN1) | não | multiselect de operadoras | casa após BDO no destino; se RN1 destino for desconhecida, a regra é ignorada |
| Operadoras origem (RN1) | não | multiselect de operadoras | casa com RN1 da operadora do número A (tronco de entrada, CADUP ou BDO no A se habilitado); se desconhecida, a regra é ignorada |
| Ação * | sim | Rotear (destinos + fallback) / Usar Carrier Routing / Bloquear chamada |
destino da chamada casada |
| Códigos SIP de retry | quando ação = Rotear | multiselect (default 408, 500, 502, 503, 504) |
códigos que avançam o cascade para o próximo destino |
| Destinos (em ordem de prioridade) | quando ação = Rotear | ≥ 1 destino obrigatório | cascade; primeira entrega bem-sucedida encerra |
| Descrição | não | texto livre | contexto |
4. Adicionar destinos ao cascade¶
Caminho: dialog Nova regra (ação = Rotear) → tabela Destinos Clique: [Adicionar destino]
Preencha (dialog Novo destino):
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Prioridade | sim | inteiro ≥ 0 (default 10) |
menor = tentado primeiro |
| Tipo | sim | Endpoint / Grupo / Anúncio (SIP+áudio) |
natureza do destino |
| Destino * | sim | select de endpoints, grupos ou anúncios conforme o tipo | alvo do relay |
| Tipos de chamada (opcional) | não | multiselect (vazio = tentado para qualquer tipo) | restringe o destino na cascata |
| Remover do início / Remover do fim (B) | não | inteiro 0–32 | strip head/tail do B original antes do relay |
| Prefixo (ex: tech prefix rn2) / Sufixo (B) | não | texto | concatenação no B antes do relay |
| Remover do início/fim, Prefixo, Sufixo (A) | não | análogos ao B | manipulação do A (caller) no relay |
| Descrição | não | texto livre | contexto |
Resultado esperado: destino listado na tabela com Pr., rótulo (ep:.../grp:.../an:código), Tipos e colunas Manip. B/A mostrando -2h, +"30" etc. Anúncio é destino terminal: toca áudio e encerra a chamada (o cascade termina nele). Ao Criar/Salvar a regra, o backend recompila o dialplan do perfil e recarrega a partição dialplan; erro de compilação/reload volta como HTTP 409/502 com a mensagem "Regra salva mas compilação/reload falhou".
5. Sincronizar o dialplan dos perfis¶
Caminho: Comercial → Políticas → Política de Saída → aba Perfis de Saída
Clique: [Sincronizar Tudo]

Preencha: nada — a ação regenera as entradas de dialplan de todos os perfis ativos e recarrega o OpenSIPS uma única vez ao final.
Resultado esperado: bloco Sincronização concluída com X entrada(s) de dialplan gerada(s) em Y linha(s) (verde em sucesso; vermelho quando o reload falha). O mesmo efeito pontual existe no rodapé do dialog do perfil com o botão Sincronizar Dialplan.
6. Criar regra de normalização do número B¶
Caminho: Comercial → Políticas → Política de Saída → aba Normalização
Clique: [Nova Regra]

Preencha: selecione o Perfil de saída no seletor (a aba já abre com o primeiro perfil ativo). A normalização administrativa roda somente sobre o número B outbound; sem match, a chamada cai no fallback mínimo do OpenSIPS. O topo da aba tem também o botão [Recompilar], usado no passo 8.
7. Preencher a regra de normalização¶
Caminho: dialog Nova regra (normalização) Clique: [Criar]

Preencha:
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Nome * | sim | Tira 0 do DDD do cliente |
identificação |
| Prioridade | sim | inteiro ≥ 0 (default 10) |
ordem na cadeia |
| Ativa | sim | Sim / Não |
vigência |
| Tipo de match * | sim | Prefixo / Exato / Regex |
como casar o B |
| Prefixo a casar / Número exato / Regex de match * | sim | conforme o tipo | valor casado |
| Transformação * | sim | Regex replace, Remover prefixo, Prefixar texto, Forçar E.164 da plataforma, Remover CSP do cliente |
moldagem do B |
| Regex de substituição * / Prefixo a remover * / Texto a prefixar * | quando a transformação exige | ex.: padrão ^0(\d+)$, replace 55$1 |
parâmetros |
| Parada | sim | Parar na regra / Continuar cadeia |
encerra ou segue a cadeia |
| Descrição | não | texto livre | contexto |
Resultado esperado: toast "Regra criada"; regra na tabela com Pr., Match, Transformação, Fluxo e Ativa. As setas ↑/↓ trocam prioridade entre regras adjacentes.
8. Recompilar a cadeia e testar a normalização¶
Caminho: Comercial → Políticas → Política de Saída → aba Normalização
Clique: [Recompilar] e depois [Testar]

Preencha (painel Testar normalização):
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Número B | sim | 049991385477 |
número no formato que o cliente envia |
Resultado esperado: Recompilar gera as entradas de dialplan do perfil (toast N entrada(s) geradas) e recarrega o OpenSIPS; se houver regra inválida, o toast vem como aviso com a contagem. Testar mostra Original → Final, Match (Sim/Não) e os passos #id regra com match/skip e antes -> depois:

Use Recompilar após editar a cadeia para garantir que o dialplan gerado reflete a lista atual.
Validação¶
- [ ] Visual: perfis e regras listados com Status correto; painel de teste com Original/Final e passos esperados; bloco Sincronização concluída sem erro de reload.
- [ ] Funcional: chamada SIPp com a linha do perfil sai com o B na forma final esperada no Request-URI do carrier (conferir SIP flow/CDR) e classe/tipo coerentes com a regra casada.
- [ ] Runtime:
opensips-cli -x mi dp_reload dialplanreflete as entradas novas; audit log registra compile/sync por operação.
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| "Regra salva mas compilação/reload falhou" (409/502) | regra inválida ou OpenSIPS sem acesso MI | ler errors na resposta, corrigir a regra e Recompilar; conferir MI do OpenSIPS |
| Chamada sai com B errado | cadeia de normalização casando regra de maior prioridade ou Continuar cadeia encadeando transformações |
rodar Testar com o número real e ajustar prioridade/Parada |
| Regra nunca casa | RN1 de destino/origem desconhecida naquele B (a regra é ignorada por design) | confirmar dados CADUP/BDO do destino ou remover o filtro de operadoras |
| SUP 1056 roteia código maior com mesmo início | modo Prefixo em vez de Número exato |
trocar para exato e informar o código completo com tipo Serviço |
| Perfil inativo mas linhas ainda roteiam | linhas ainda apontando o perfil com status anterior | atribuir outro perfil às linhas ou reativar; Sincronizar Tudo |
| Anúncio não toca | anúncio desabilitado ou media-server indisponível | conferir Infraestrutura → Anúncios e estado do FreeSWITCH |