Cadastro / Circuitos

Palavras-chave

circuitos, SIP, cadastro, contas, clientes, tarifação, faturas, DID, CDR

Resumo / Objetivo

A página Circuitos concentra a gestão das contas SIP vinculadas aos clientes do sistema. Cada circuito representa uma conta que será utilizada para tráfego de chamadas e tarifação, permitindo o acompanhamento detalhado de uso, faturamento e status operacional. A interface apresenta uma visão consolidada de todos os circuitos cadastrados, facilitando a administração e garantindo agilidade no acesso às principais ações.

Conteúdo

A página de Circuitos apresenta todos os circuitos cadastrados no sistema, exibindo informações essenciais para acompanhamento técnico e administrativo.

Abaixo, detalhamos todos os campos da interface:

• Circuito: Número do circuito (conta SIP) para registro.
• Nome: Nome de identificação do cliente vinculado ao circuito.
• Plano Nacional: Indica o plano de tarifação aplicado ao circuito.
• Central: Mostra em qual central (Core Server) o circuito está registrado.
• Saldo: Exibe o saldo de ligações disponível.
  • Em planos pré pago: É o valor de saldo disponível para realizar ligações.
  • Em planos controle/pós pago: É o valor de saldo utilizado no completamento das ligações.
• IP: Endereço IP da origem do registro.
• Status: Exibe o status do circuito (online/offline) e a latência em milissegundos.

Saldo

A tela de Histórico de Crédito permite o gerenciamento do saldo dos circuitos configurados com plano de tarifação pré-pago. O saldo registrado será consumido conforme o cliente realiza ligações, garantindo que apenas chamadas com crédito disponível possam ser completadas.

O campo de Saldo Atual exibe o valor disponível no momento, servindo de referência para novas operações. Na área de Ajuste de Saldo, o administrador pode inserir valores em duas modalidades:

• Crédito → valores positivos adicionados ao saldo, liberando recursos para o cliente realizar ligações.

• Débito → valores negativos, que reduzem o saldo disponível ou podem até gerar saldo negativo.

Todos os lançamentos ficam registrados na tabela de histórico, que apresenta:

• Data: Data do cadastro do saldo.

• Saldo anterior ao crédito: Valor do saldo no momento da operação.

• Valor creditado: Valor creditado ou subtraído na operação.

• Observação: Usuário que realizou a operação.

Esse registro detalhado garante rastreabilidade e transparência em todas as movimentações de saldo realizadas nos circuitos.

Status SIP

A tela de Status SIP permite acompanhar o histórico de registros SIP de cada circuito nos últimos 30 dias. Essa funcionalidade é essencial para monitorar a disponibilidade e rastrear a origem dos registros de um cliente.

Ao acessar um circuito, o sistema exibe informações detalhadas como:

• Data e hora do registro – momento em que o circuito se autenticou na plataforma;

• Contact (IP de origem e porta) – endereço utilizado para o registro, útil para identificar a rede de origem;

• User Agent – software ou dispositivo utilizado para o registro (ex.: Asterisk, softphone, ATA, Telefone IP, etc);

• Último Online / Último Offline – histórico de conectividade do circuito;

• Status atual – indica se o circuito está Online ou Offline.

Como a plataforma suporta múltiplos registros por circuito, caso o cliente utilize diferentes dispositivos (por exemplo, um softphone e um Telefone IP simultaneamente), todos os IPs e user agents são armazenados no histórico.

Configurações de circuito

A seguir estão descritas todos os parâmetros de configurações encontrados na edição de um circuito. Estes parâmetros definem configurações técnicas, de faturamento e permissões dos circuitos na plataforma.

Identificação de cliente

• Criar Novo Cliente: Quando habilitado, permite criar e um novo cliente e vincular o circuito direto da edição do circuito.
• Cliente: Cliente ao qual o circuito está vinculado.

Configurações básicas

• Status: Define o status de operação do circuito.
  • Ativado - O circuito está em operação;
  • Bloqueio Parcial - O circuito está apto para receber chamadas porém não completa ligações.
  • Bloqueio Total - O circuito não recebe nem realiza ligações;
  • Cancelado - O circuito está fora de operação;
• Nome do Circuito: Nome de identificação do cliente vinculado ao circuito.
• Circuito: Número da conta SIP/IAX utilizada para registro do circuito.
• Senha: Senha para registro do circuito.
• Plano de Discagem: Rota personalizada que contém as regras de discagem utilizadas para complemento de chamadas.
• LC/LDN/LDI/VC1/VC2/VC3: Permite habilitar ou desabilitar o completamento de chamadas e acordo com seu tipo.
• Bina: Quando habilitado, encaminha o número de origem para o circuito de destino da ligação.
• CallerID-A: quando habilitado, determina o tipo de tratamento será feito no número de A em ligações de saída.
  • Totalmente Aberto - A responsabilidade de encaminhar o número DID que deve binar no destino é do cliente.
  • DID; Piloto - Espera-se que o cliente envie um DID que esteja vinculado a este circuito. Caso contrário, a plataforma utilizará o menor número (Piloto) como número de A.
  • DID; Hangup - Espera-se que o cliente envie um DID que esteja vinculado a este circuito. Caso contrário, a plataforma desligará (Hangup) a chamada.
• ERP-ID Contrato: Campo opcional para inserir o ID de identificação do cliente de um sistema ERP.
• Circuito Transbordo: Permite transbordar a chamada para outro circuito de acordo com um determinado tipo de evento.
• Transbordar quando: Eventos que definem quando um transbordo de circuito será aplicado.

Faturamento

• Consumo mínimo: Determina ao circuito um consumo mínimo. O valor definido neste campo será o valor total da fatura caso a soma do valor de ligações + valor da mensalidade seja menor.
• Dia de fechamento: Define o dia de fechamento das faturas.
• Cobrança: Tipo de cobrança que será aplicado ao circuito:
  • Pré-pago: O circuito necessita de um valor creditado no campo saldo para completar ligações.
  • Pós-pago: O circuito poderá completar ligações à vontade, pagando o valor final após o fechamento da fatura.
  • Controle: O circuito poderá consumir em ligações apenas o valor cadastrado no campo Valor Controle. Se o circuito possuir um plano com franquia, o valor controle será utilizado somente após o consumo total da franquia.
• Limite Extra: Determina ao circuito um valor extra para completamento de ligações após o consumo do valor controle.
• Layout Fatura: Determina o layout da apresentação de informações da fatura.
  
  • STFC - Fatura no padrão exigido pela Anatel, contendo 02 casas decimais. Ideal para a telefonia do Brasil.
  • Atacado - Fatura com 05 casas decimais. Ideal para atendimento de grandes clientes de telefonia.
• Plano: Determina o plano de tarifação das ligações do circuito.
•  Plano Internacional: Determina o plano de tarifação das ligações internacionais do circuito.
• Alerta de Saldo: Quando habilitado, encaminha um e-mail de notificação após o circuito atingir determinado valor em ligações.
• Moeda: Determina a moeda de cobrança das ligações.
• Arredondamento: Efetua um arredondamento nos milissegundos da chamada para o segundo mais próximo.

Configuração Técnica

• Protocolo: Determina a tecnologia utilizada no circuito.
• Canais Simultâneos IN: Determina a quantidade de canais suportados no circuito nas chamadas de entrada.
• Canais Simultâneos OUT: Determina a quantidade de canais suportados no circuito nas chamadas de saída.
• Canais Simultâneos Total: Determina a quantidade de canais suportados no circuito nas chamadas de entrada e saída.
• Contatos: Quantidade de registros simultâneos permitidos ao circuito.
• DTMF: Determina a tecnoligia DTMF utilizada na configuração do circuito.
• Forcar CLI: Permite definir o valor do número de A nas ligações de saída. Quando configurado, sobrepõe qualquer função que define o número de A nas ligações de saída.
• CODEC: Permite selecionar os CODECS padrão na configuração do circuito.
• Insecure: Utilizado em configurações de apontamento IP to IP. A configuração isenta o circuito de informar usuário e senha nas sinalizações de INVITE.
• Range Liberada (ACL): Define o endereço IP ou range de IPs permitidos para registro do circuito.
• IP/DNS Host: Define o endereço IP de origem das sinalizações SIP.
• Port: Porta de destino das sinalizações SIP onde o circuito está configurado.
•  TechPrefix: Utilizado nas chamadas de saída, o TechPrefix define uma TAG que deve ser informada antes do número de B em ligações de saída.
• Qualify: Habilita a plataforma a realizar o monitoramento dos circuitos registrados.

Gestão Web

• Senha Web: Senha de acesso do painel de faturas do circuito.
• Habilitar ACB: Permite ao cliente configurar o recebimento de chamadas ACB através do painel de faturas.
• Habilitar Blacklist:  Permite ao cliente inserir/remover números na blacklist através do painel de faturas.
• Habilitar Siga-me: Permite ao cliente configurar a função de siga-me através do painel de faturas.

Filtros

Por padrão, a lista de circuitos apresenta apenas circuitos ativos na plataforma. A opção de filtros permite listar os circuitos bloqueados ou cancelados na plataforma.

Configurar Fatura

As opções de configurar fatura permitem selecionar os campos que serão apresentados na fatura dos clientes.

FAQ – Perguntas frequentes

1. Qual a diferença entre os tipos de status do circuito?

• Ativado: Circuito em operação, apto a originar e receber chamadas.

• Bloqueio Parcial: Apenas recebe chamadas, não pode originar.

• Bloqueio Total: Não recebe nem origina chamadas.

• Cancelado: Circuito fora de operação, sem uso.

2. Como funciona o saldo em diferentes tipos de cobrança?

• Pré-pago: É necessário crédito disponível no saldo para completar chamadas.

• Pós-pago: As chamadas são completadas livremente, sendo cobradas na fatura no fechamento.

• Controle: O circuito consome apenas o valor definido no campo Valor Controle. Caso tenha franquia, o controle é aplicado após o consumo total da franquia.

3. O que acontece se o circuito atingir o limite de canais simultâneos configurados?
Chamadas adicionais não serão completadas.

4. Qual a função do “Consumo Mínimo”?
Garante uma fatura mínima. Se o consumo total + mensalidade for inferior ao consumo mínimo configurado, a fatura será emitida pelo valor do consumo mínimo.

5. Quando usar STFC e quando usar Atacado no layout de fatura?

• STFC: Formato exigido pela Anatel, com duas casas decimais (uso comum no Brasil).

• Atacado: Fatura com até cinco casas decimais, voltada para clientes de atacado e operadoras.

6. O que é o CallerID-A e quais são os modos disponíveis?
Define como o número de origem (A) será tratado em chamadas de saída:

• Totalmente Aberto: O cliente define qual número será exibido.

• DID; Piloto: Exige que o cliente envie um DID válido. Caso contrário, a plataforma utiliza o menor número (Piloto).

• DID; Hangup: Exige um DID válido. Caso contrário, a chamada é encerrada automaticamente.

7. Qual a diferença entre Canais IN, OUT e Total?

• IN: Limite de canais para chamadas de entrada.

• OUT: Limite de canais para chamadas de saída.

• Total: Soma de canais de entrada e saída permitidos.

8. Para que serve o campo “Circuito Transbordo”?
Permite redirecionar chamadas para outro circuito em casos específicos (ex.: ocupado, offline, congestionado).

9. O que significa a opção Forçar CLI?
Define manualmente o número de origem (A) em chamadas de saída, sobrepondo qualquer configuração enviada pelo cliente.

10. Como funciona o Histórico de Crédito?
Mostra todas as movimentações de saldo do circuito, incluindo créditos e débitos. Cada lançamento registra: data, saldo anterior, valor creditado/debitado e o usuário responsável.

11. O que é o Status SIP e qual sua utilidade?
Apresenta o histórico de registros SIP do circuito nos últimos 30 dias. Útil para:

• Identificar IPs de origem e portas utilizadas.

• Rastrear User Agents (softphone, ATA, PABX, etc.).

• Acompanhar disponibilidade (último online/offline).

12. O que acontece se eu habilitar “Habilitar Blacklist”, “Siga-me” ou “ACB”?
Essas opções permitem ao cliente final autogerenciar essas funções diretamente no painel de faturas:

• Blacklist: Bloqueio de números indesejados.

• Siga-me: Desvio de chamadas para outro destino.

• ACB: Aceitar chamadas a cobrar.

13. Como funcionam os filtros da página de Circuitos?
Por padrão, são exibidos apenas circuitos ativos. O filtro permite visualizar também circuitos bloqueados ou cancelados.