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.