7.1 Configurar Roteamento INVITE no Tokgate i30

Owned by Andrey Pereira
Last updated: 19 Jan, 2021
4 min read

A tabela de roteamento INVITE consiste em um conjunto de regras listadas sequencialmente, a ser aplicada exclusivamente em chamadas de entrada. Uma regra é uma linha de texto com seguinte formato:

DE_ONDE (Regra de origem) > PARA_ONDE (Vínculo de destino)

DE_ONDE (Regra de origem) > PARA_ONDE (Vínculo de destino)

A expressão DE_ONDE filtra detalhes da ligação que se apresentou ao sistema (INGRESS) e, uma vez atendido o filtro, aciona a expressão PARA_ONDE correspondente, com intuito de determinar o caminho de saída (EGRESS), assim como manipulações necessárias de parâmetros. Cada ligação que chega é comparada com cada expressão DE_ONDE e a primeira que é dada como atendida é obedecida, com instruções dadas por PARA_ONDE.

Como funciona o match na Tabela de Roteamento?

Para identificar a existência de regras compatíveis assertivas para cada ligação, o Tokgate i30 executa o processo de varredura na tabela da seguinte maneira:

  1. Para cada ligação que chega, as regras são inspecionadas uma a uma de forma sequencial iniciando na primeira regra da lista, procurando alguma “Regra de origem” (lado esquerdo) que faça match;

  2. Se encontrada uma regra que faça match, os dados da ligação são processados segundo o “Vínculo de destino”, eventualmente entregando a ligação para a porta VoIP indicada ou deduzida;

  3. Espaços e TAB são sempre ignorados;

  4. Se nenhuma regra fizer match, a ligação de entrada é encerrada sem sucesso;

  5. Se mais de uma regra atender, a primeira que achar, na sequência natural, é utilizada.

Para configurar o roteamento de INVITE, acesse o menu “Roteamento → Invite”. Clique no botão “Adicionar Regra” para adicionar uma nova regra na tabela. É necessário configurar as regras para identificar de onde a ligação está vindo e definir para onde ela vai, conforme descrito a seguir:

Dica | Remover regras pré-existentes

Não primeira configuração da Tabela de Roteamento, clique no botão “Remover tudo” para depois adicionar as regras conforme desejado.

Regra de origem

TO

(preenchimento opcional)

Este campo consiste em uma expressão regular a ser aplicada no número a discar. É utilizado para filtrar a chamada de entrada baseado no número a ser chamado (Identidade de B).

Aceita os seguintes símbolos:

  • *: identifica qualquer conjunto de caracteres para frente. Não pode haver mais nada neste campo após este caractere;

  • ?: identifica qualquer caractere;

  • {…}: identifica uma expressão que gerará match num único caractere dentre os enumerados entre as chaves;

Exemplos:

  1. 3471* - identifica qualquer sequência iniciada por 3471

  2. 347{1,3}* - identifica qualquer sequência iniciada por 3471 ou 3473

  3. 123? - identifica qualquer sequência de 4 dígitos que comece com 123

  4. {6,7}* - identifica qualquer sequência iniciada por 6 ou 7

  5. 31719500 - identifica somente o número 34719500

FROM

(preenchimento obrigatório)

 

Este campo filtra a chamada com base no peer (usuário) ou host de origem da chamada. Preencha quando um peer ou host específico devem ser referência para a regra.

Pode ser preenchido com:

  • Nenhum: preenchido como nenhum, a regra irá aceitar qualquer usuário ou host no campo FROM;

  • Peer: identifica o vínculo de origem da ligação com o peer correspondente (previamente cadastrado). Aplicável apenas em cenários de Portas VoIP em modo Cliente ou Servidor;

  • Host: identifica o host de origem como apresentado no campo FROM. Ao selecionar esta opção é necessário informar o endereço IP:PORTA do host . Aplicável apenas em cenários de Portas VoIP em modo SIP Trunk.

Interface

(preenchimento obrigatório)

Utilize este campo para filtrar o INVITE com base na porta de origem do mesmo. Selecione a porta de origem da ligação ou “Nenhuma” para que a regra considere ligações de qualquer porta.

Vínculo de destino

TO

(preenchimento opcional)

Preencha este campo caso queira modificar o número a ser discado antes de repassá-lo ao destino. Se preenchido, este campo irá modificar o número discado (campo TO), do contrário ele será repassado como está.

Este campo aceita as seguintes instruções:

  • *: identifica qualquer conjunto de caracteres para frente. Não pode haver mais nada neste campo após este caractere;

  • -: identifica que o caractere na posição correspondente será suprimido e não será repassado;

  • ?: identifica qualquer caractere;

  • {…}: identifica uma expressão que gerará inserção de um ou um conjunto de caracteres na posição corrente;

Exemplos:

  1. --?? - os dois primeiros caracteres devem ser suprimidos e os dois próximos mantidos.

  2. --4* - os dois primeiros caracteres serão suprimidos, o terceiro será forçado a assumir o valor 4 e os demais, se houver, serão transcritos;

  3. {34719}* - deve ser inserido o prefixo 34719 e os demais dígitos serão transcritos.

Usuário

(preenchimento obrigatório)

Preencha este campo para definir para qual usuário ou host a ligação deve ser encaminhada.

Pode ser preenchido com:

  • Nenhum: preenchido como nenhum, a ligação não será encaminhada para um usuário específico;

  • Peer: preenchido com um peer, a ligação será encaminhada para o peer correspondente (previamente cadastrado). Aplicável apenas em cenários de Portas VoIP em modo Cliente ou Servidor;

  • Host: encaminha a ligação para o host de destino configurado. Ao selecionar esta opção é necessário informar o endereço IP:PORTA do host . Aplicável apenas em cenários de Portas VoIP em modo SIP Trunk.

Interface

(preenchimento obrigatório)

Identificação da interface de destino para encaminhar a ligação. Se fornecido, tem prioridade sobre a interface que o usuário sugere usar.

Após preencher as regras, clique no botão “Aplicar” e em seguida clique em “Reload” para concluir a configuração.