Ir para o conteúdo

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 admin para 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]

Página Políticas de Saída com o botão Novo Perfil destacado na aba Perfis de Saída

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]

Dialog Novo Perfil com permissão de saída e políticas do perfil

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]

Aba Perfis de Saída com o botão Sincronizar Tudo destacado

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]

Aba Normalização com o perfil selecionado e o botão Nova Regra destacado

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]

Dialog Nova regra de normalização outbound com match e transformação

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]

Aba Normalização com o botão Recompilar destacado acima da tabela de regras do perfil

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:

Painel Testar normalização com número B e botão Testar destacado

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 dialplan reflete 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