SW - Manual do Sistema


Casos Práticos - Principais Procedimentos

Casos Práticos - Principais Procedimentos

WEB - PCP - Como cadastrar a API da revenda ( API v3 )

Como cadastrar uma API na Revenda!

Passo 01:
Clique em CADASTROS e selecione Revendas.

image.png

Passo 02:
Clique no botão API

image.png

Passo 03:
Preencha o modal com as informações a baixo:
1- Nome do seu revendedor
2- Email do seu revendedor
3- Senha ( Salve a senha em um local de sua confiança, será necessaria para logar na api)
4- IP do seu revendedor
Ao final, clique em Salvar.

image.png

image.png

Passo 04:
Clique novamente no botão API para visualizar suas credenciais de acesso a API.

image.png

Passo 05:
Agora seu revendedor pode enviar uma requisição POST para o IP_DO_SEU_DBS/oauth/token com o seguinte JSON:

{
    "grant_type": "password",
    "client_id": "19",
    "client_secret": "5PFpsmuAA0li5yvrB24ux88x3XYyq0W75pKhgFZ",
    "username": "meu_nome@aqui.com.br",
    "password": "sua_senha_aqui",
    "scope": ""
}

Passo 06:
A documentação da api da revenda estará disponivel no endereço: IP_DO_SEU_DBS/api/documentation#/

image.png

 

Lembre-se: É necessário configurar seu sistema antes de utilizar a API. Por favor, solicite a configuração através do nosso canal de atendimento.

Casos Práticos - Principais Procedimentos

Como utilizar o Relatório Spoofing da Anatel

Como Usar o Relatório Spoofing da Anatel:

Assista ao vídeo abaixo e aprenda a configurar e visualizar o Relatório Spoofing da Anatel, conforme solicitado no Despacho 262. 

Vou te guiar passo a passo para acessar, interpretar e utilizar essas informações de forma eficiente. Confira! 

***O Relatório encontra-se disponível nas versões 40.6 e 42.3 ou superiores***

PCP - Painel de Controle Principal

PCP - Painel de Controle Principal

Status

Palavras-chave

status, servidores, monitoramento, uptime, uso de memória, uso de disco, firewall, troubleshooting

Objetivo

O módulo Status do Softswitch SPX permite que o administrador monitore, em tempo real, a saúde e o desempenho dos servidores que compõem a topologia da solução.

Conteúdo

O módulo de Status organiza e apresenta, para cada servidor da infraestrutura, um conjunto de indicadores essenciais para a operação e manutenção do sistema. Cada servidor é exibido em um bloco individual, onde são destacados os principais parâmetros de desempenho e disponibilidade, como:

image.png

Ao clicar sobre cada ícone, o sistema exibe informações detalhadas do recurso selecionado, incluindo:

A possibilidade de consulta direta dessas métricas é especialmente útil para diagnóstico e troubleshooting, permitindo identificar rapidamente indisponibilidades, gargalos de performance ou bloqueios de rede que possam impactar o registro e funcionamento do sistema.

 

Códigos de Cor para Indicadores

Além da apresentação dos indicadores, o módulo de Status utiliza sinalização por cores para facilitar a identificação visual de alertas e falhas:

Esse recurso visual permite ao administrador identificar rapidamente o estado de cada componente, priorizando ações corretivas de acordo com a criticidade do alerta.


FAQ – Perguntas Frequentes

1. Para que serve a tela de Status?
A tela de Status permite ao administrador acompanhar, em tempo real, a saúde dos servidores que compõem a infraestrutura do Softswitch.

2. Quais informações posso visualizar nessa tela?
É possível verificar o estado do banco de dados, carga de processamento (load), uso de memória, uso de disco, status do firewall e número de conexões ativas.

3. O que acontece quando clico nos ícones dos servidores?
Ao clicar em cada ícone, são exibidas informações detalhadas, como uptime do servidor, valores exatos de utilização de memória, espaço em disco, carga de processamento e regras aplicadas no firewall.

4. Como funciona a sinalização por cores?
O sistema utiliza cores para indicar o estado de cada serviço:

5. É possível verificar regras e bloqueios do firewall?
Sim. Clicando no ícone de firewall, o administrador pode visualizar todas as regras aplicadas, incluindo IPs bloqueados, o que facilita o diagnóstico de falhas relacionadas a registros ou conexões.

6. Os dados são atualizados em tempo real?
Os valores exibidos são atualizados de acordo com a coleta do sistema, sendo possível verificar o horário exato da última atualização em cada janela de detalhes.

PCP - Painel de Controle Principal

Cadastro / Clientes

Palavras-chave

clientes, cadastro, contatos, circuitos (conta SIP), faturas, consolidação, busca

Resumo / Objetivo

O módulo de Cadastro de Clientes centraliza todas as informações relacionadas a clientes da plataforma. Além de armazenar dados cadastrais e fiscais, ele permite gerenciar contatos técnicos e administrativos, bem como vincular circuitos. Esse vínculo é essencial para a organização da operação e para a consolidação financeira.

Conteúdo

A página Cadastro de Clientes é o ponto central para o gerenciamento das informações de cada cliente. Nela, o administrador pode cadastrar informações técnicas e administrativa de cada cliente, como:

image.png

Contatos

Cada cliente pode ter múltiplos contatos cadastrados, permitindo centralizar informações como:

O cadastro de múltiplos contatos permite ao time técnico localizar rapidamente os responsáveis técnicos ou administrativos de cada cliente, facilitando comunicações de caráter técnico, financeiro, administrativo, etc.

Circuitos 

Na plataforma, cada circuito precisa obrigatoriamente estar vinculado a um cliente. Essa relação é fundamental porque possibilita:

Ao clicar no botão Circuitos, na página de cadastro de clientes, o sistema direciona automaticamente para a página de circuitos, exibindo apenas aqueles que estão vinculados ao cliente selecionado na página de cadastro de clientes.

image.png

O vínculo entre circuito > cliente garante a consolidação de faturas. Embora cada circuito gere suas próprias faturas, no Painel de Controle do Cliente, o sistema exibe tanto as faturas individuais quanto o valor total somado de todas elas, oferecendo uma visão clara da situação financeira do cliente e de todas as faturas dos seus circuitos.

image.png

FAQ – Perguntas Frequentes

1. Posso ter mais de um circuito por cliente?
Sim. E todos ficam agrupados na visão do cliente.

2. O vínculo do circuito é obrigatório?
Sim. Sem vínculo, o circuito não entra na consolidação de faturas e dificulta o suporte.

3. Posso alterar o cliente de um circuito depois?
Sim. Edite o circuito e selecione o novo cliente; o histórico de faturas permanece no circuito e a consolidação futura passa a somar no novo cliente.

4. Como vejo o total devido do cliente?
Acesse o cliente; a área financeira exibe cada fatura por circuito e o total consolidado.

5. Há limite de contatos por cliente?
Não. Cadastre quantos forem necessários para as áreas envolvidas.

PCP - Painel de Controle Principal

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.

image.png

Abaixo, detalhamos todos os campos da interface:

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.

image.png

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:

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

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.

image.png

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

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.

edição-circuito.png

Identificação de cliente

Configurações básicas

Faturamento

Configuração Técnica

Gestão Web

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.

image.png

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?

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

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?

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:

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

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:

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:

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.

PCP - Painel de Controle Principal

Cadastro / Circuitos / Trace

Palavras-chave

trace, troubleshooting, roteamento, trunks, SIP, rota personalizada, buffer, completamento de chamada, diagnóstico

Resumo / Objetivo

O Trace é a ferramenta de troubleshooting do sistema, permitindo analisar em detalhe o percurso de uma chamada realizada em um circuito. Através dessa tela, o administrador consegue verificar:

Conteúdo

image.png

FAQ – Perguntas Frequentes

1. O que acontece quando aparece “Rota personalizada encontrada”?
A plataforma aplicou uma rota configurada para o cliente, com múltiplas regras de roteamento. Esse ponto é crucial para entender casos de falha de completamento.

2. Por que alguns tipos de ligação aparecem em “Liberado: LC, LDN, VCI…”?
Porque cada circuito possui permissões específicas de completamento. Esses indicadores mostram quais categorias de chamada estão liberadas.

3. O “Tempo Total de Chamada” é diferente do “Tempo Total de Ligação”?
Sim. O primeiro considera o tempo de ringing antes do atendimento; o segundo, o tempo efetivo da conversação.

4. Se a chamada não saiu pelo primeiro trunk listado no buffer, o que significa?
Que a plataforma tentou o trunk inicial, mas este falhou. Automaticamente, a chamada seguiu para o próximo trunk da sequência até ser completada ou falhar.

PCP - Painel de Controle Principal

Cadastro / Circuitos / DID

Palavras-chave

DID, DDR, portabilidade, canais, tarifação reversa, siga-me, bloqueio de entrada, chamadas a cobrar, número portado, faixa sequencial

Resumo / Objetivo

Esta seção reúne as configurações relacionadas a números de entrada na plataforma:

Com esses recursos, o administrador pode gerenciar a forma como os números são recebidos, distribuídos e tarifados dentro da plataforma.

Objetivo

O DID é um número único que pode ser associado ao circuito para o recebimento e completamento de ligações.

image.png

Abaixo, detalhamos todos os campos da interface:

Enviar DID: Se o cliente possui o número (48) 3121-0110 e está configurado como Enviar DID = 10, a chamada enviada ao destino conterá CN + número completo. Caso fosse Enviar DID = 8, seriam enviados apenas os últimos dígitos (31210110).

Tarifação Reversa: A isenção só ocorre entre números internos da plataforma. Para chamadas externas (ex.: celular), a cobrança é mantida normalmente.

A tarifação reversa para números CNG (0300, 0500, 0800) acontece de maneira automática pela plataforma. 

DDR

O DDR é utilizado quando o cliente possui faixas sequenciais de números, evitando o cadastro individual de cada DID. O cadastro da faixa é realizado informando a cidade, o tamanho do DDR e o dígito final, e a plataforma gera automaticamente a sequência de números (se disponível).

A configuração de um DDR possui parâmetros mais simples do que o DID individual, permitindo ajustes de:

Portabilidade

A plataforma permite agendar a ativação de números portados. Essa funcionalidade não realiza a solicitação de portabilidade junto ao orgão competente. O pedido deve ser feito pelo sistema de solicitação de portabilidade, que informará a data prevista para a portabilidade.

Com essa data em mãos, é possível cadastrar o número na plataforma para que ele seja automaticamente habilitado no circuito do cliente no dia da portabilidade.

A cobrança de mensalidade somente se inicia a partir da ativação do primeiro DID no circuito. O simples agendamento do número portado não gera cobrança antecipada.



FAQ – Perguntas Frequentes

1. Qual a diferença entre DID e DDR?

2. O que acontece se eu configurar menos canais do que a demanda de chamadas recebidas?
Chamadas acima do limite configurado serão recusadas automaticamente pela plataforma.

3. Quando devo usar tarifação reversa?
A tarifação reversa é indicada para números que recebem chamadas e cujo custo deve ser assumido pelo destino (ex.: números 0800).

4. O bloqueio de entrada pode ser usado em DDR?
Não. O recurso de bloqueio de entrada por prefixo está disponível apenas para DIDs individuais.

5. O que significa a opção “Aceita ACB”?
Indica se o número pode receber chamadas a cobrar. Se ativado, a plataforma permite o recebimento desse tipo de ligação.

6. Posso desviar chamadas recebidas em um DID para outro número?
Sim. Basta ativar o recurso Siga-me, que encaminha todas as chamadas recebidas para o número configurado.

PCP - Painel de Controle Principal

Cadastro / Circuitos / Fatura


Palavras‑chave

fatura, franquia, refaturar, tarifação, CSV, PDF, histórico de faturas, detalhamento de chamadas, tempo tarifado

Resumo / Objetivo

A página Faturas consolida e detalha todo o consumo do circuito no mês de referência. Nela o administrador confere totais por tipo de ligação, uso de franquias, serviços adicionais, números contratados (DIDs) e o histórico completo de chamadas no mês referente. Também é possível exportar os dados e refaturar uma fatura em aberto quando houver alteração de valores de tarifação.

Conteúdo

A página de fatura apresenta o histórico completo das ligações realizadas no mês referencia e os valores de tarifação aplicados.  Abaixo, detalhamos todos os campos da interface:

faturas.png

A fatura apresenta também um resumo de todos os DID vinculados ao circuito do cliente e os valores de mensalidades aplicados.

 

Histórico de chamadas (detalhamento)

A fatura apresenta um detalhamento completo das chamadas que compõem a fatura. As chamadas são separadas por grupo/tipo de ligação. 

Refaturar

O botão de refaturamento permite recalcular o valor de tarifação das ligações da fatura em aberto. Esta opção é útil para casos onde ocorrerem alteração nos valores de tarifação das chamadas que precisam ser recalculados.

A opção de refaturamento é aplicável somente nas chamadas da fatura em aberto. Para recalcular valores de faturas fechadas consulte o time de suporte. 

FAQ – Perguntas Frequentes

1. Por que vejo valores “R$ 0,00” em ligações?
Porque a chamada foi coberta por franquia ou porque o cliente tem gratuidade configurada para aquele tipo de ligação.

2. “Refaturar” altera faturas antigas?
Não. O refaturamento atua apenas sobre a fatura em aberto do circuito.

3. Mudei a tarifação (preços/regras). O que devo fazer?
Clique em Refaturar para recalcular o mês corrente com as novas condições de tarifação.

4. O que significa o campo “Disponível” em Franquias?
É o saldo de minutos que ainda pode ser consumido naquela franquia no mês de referência.

5. Qual a diferença entre “Tempo Real” e “Tarifado”?
Tempo Real é a duração efetiva da chamada. Tempo Tarifado é o tempo considerado para cobrança segundo as regras do plano (mínimos, arredondamentos, franquia), sendo a base de cálculo do valor da ligação.

6. Posso baixar a fatura e os detalhes das ligações?
Sim. Use Download PDF para o documento formal e Download CSV para os registros detalhados (conciliação e análises).

PCP - Painel de Controle Principal

Cadastro / Revendas

 

Palavras-chave

revendas, whitelabel, cadastro, gestão, clientes, circuitos, DID, faturas, API

Resumo / Objetivo

A página Revendas permite a gestão de clientes que utilizam o software no modelo whitelabel, oferecendo a eles um acesso exclusivo e simplificado para administrar seus próprios circuitos, DIDs e faturas. Diferente do painel principal, as revendas não possuem todos os campos de configuração disponíveis, garantindo controle centralizado pela plataforma e maior segurança.

Conteúdo

A tela inicial de Revendas apresenta a lista de todas as revendas cadastradas, exibindo informações essenciais para acompanhamento:

image.png

API

A tela de configurar API permite gerar e gerenciar as credenciais utilizadas pela revenda para integrar sistemas externos via API do produto. Essas credenciais garantem segurança e controle sobre as requisições realizadas, permitindo automação de processos como criação de circuitos, consulta de faturas, gerenciamento de DIDs, entre outros.

DID

A página de DIDs da Revenda permite ao administrador visualizar e gerenciar os números disponíveis para cada revenda. Nesta tela é possível identificar quais DIDs estão vinculados a circuitos, quais permanecem livres para uso e quais configurações estão associadas a cada número.

Faturas

A página de Faturas da Revenda apresenta em detalhes todas as chamadas realizadas pelos circuitos vinculados à revenda. Essa tela é essencial para o controle financeiro e para a conferência de consumo, permitindo ao administrador e ao revendedor acompanhar de forma transparente os custos gerados.

No topo da tela, são exibidos indicadores agregados:

Cada linha da tabela representa uma chamada realizada, com os seguintes campos:

Acessar Revenda

Ao clicar neste botão, o administrador será direcionado para a plataforma do cliente revendedor. Através desta, ele poderá gerenciar e realizar configurações em todas as funcionalidades disponíveis ao cliente revendedor.

FAQ - Perguntas Frequentes

1. O que é uma revenda dentro da plataforma?
É um cliente que utiliza o sistema no modelo whitelabel, com painel próprio para gerenciar seus circuitos, DIDs e faturas.

2. Como funciona o saldo da revenda?
O saldo representa os créditos disponíveis para consumo em chamadas. No modelo pré-pago, a revenda deve manter saldo positivo para permitir tráfego de ligações de seus clientes.

3. Quais as diferenças de configuração entre o painel principal e o painel da revenda?
O painel principal possui configurações avançadas de circuito, tarifação, codecs, ACL, planos, etc. Já o painel da revenda possui apenas funções básicas, focadas em gestão de  circuitos e faturamento.

4. Posso criar circuitos diretamente dentro da revenda?
Sim. Cada revenda pode cadastrar seus próprios circuitos, dentro das permissões liberadas pelo administrador principal.

PCP - Painel de Controle Principal

Planos / Planos Circuitos

Palavras‑chave

planos, tarifação, prefixo, franquia, LC, LDN, VC1, VC2, VC3, duplicar, cadastro, faturas

Resumo / Objetivo

A página Planos concentra as regras de preço e franquia que serão aplicadas aos circuitos. Cada plano define o valor de cada ligação de acordo com o seu tipo e o que está incluso (franquias), permitindo padronizar ofertas por perfil (PF, PJ, Ilimitado, etc.) e manter o faturamento coerente entre clientes.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

Alterar um plano impacta a tarifação a partir daquele momento. Para recalcular uma fatura em aberto, use o recurso de refaturamento na página de faturas do circuito.

 

Franquia

A página Franquia permite cadastrar pacotes de minutos que serão incluídos no plano escolhido. Esses pacotes definem o consumo incluso antes da tarifação variável e podem ser direcionados a categorias específicas de chamadas (LC, LDN, VC1, VC2, VC3).

Abaixo, detalhamos todos os campos da interface:

 

Prefixo

A página Prefixos é responsável por armazenar os prefixos de tarifação utilizados nas chamadas internacionais. Sempre que uma ligação for realizada utilizando 00 + código do país + número do destino, a plataforma consulta os prefixos cadastrados para identificar corretamente o país de destino e aplicar a tarifa de venda e cadência de tarifação correspondente.

 

Página de Edição de Plano

A tela de Edição de Plano é utilizada para configurar ou alterar as regras de um plano de telefonia dentro da plataforma. Nesta página, o administrador pode definir valores de mensalidade, tarifas de ligação, cadências de tarifação, além de ativar ou desativar serviços adicionais (SVA – Serviços de Valor Agregado) para cada plano. Essas configurações são fundamentais, pois impactam diretamente na forma como os clientes serão tarifados e nos recursos disponíveis para cada plano.

Abaixo, detalhamos todos os campos da interface:

Configurações Gerais

O valor do campo Mensalidade funciona como sugestão automática sempre que um DID for vinculado a um circuito associado ao plano. Esse valor não é fixo: o administrador pode alterá-lo no momento do cadastro do DID, de acordo com a necessidade do cliente.


Tarifação

Serviços de Valor Agregado (SVA)


Cadência

O campo Cadência define a forma como a tarifação da chamada será calculada, considerando tempo gratuito inicial, tempo mínimo tarifado e incrementos de cobrança.

O formato segue o padrão:
[Tempo gratuito] / [Tempo mínimo] / [Incremento]

Exemplo prático: em uma cadência 3/30/6, os valores significam:

Para entender melhor o funcionamento da cadência, recomendamos assistir ao nosso vídeo explicativo disponível no youtube.

 

FAQ – Perguntas Frequentes

1. O que acontece se eu alterar um plano já existente?
Ao alterar um plano, a tarifação é atualizada imediatamente e passa a valer para todas as chamadas futuras. Se houver faturas em aberto, é necessário utilizar o recurso de refaturamento para recalcular os valores.

2. Como funcionam as franquias de minutos?
As franquias são pacotes de minutos incluídos no plano. Elas são consumidas primeiro, e apenas após seu término é aplicada a tarifação variável definida no plano.

3. O que é a Mensalidade do plano?
A mensalidade é um valor sugestivo aplicado automaticamente quando um DID é vinculado a um circuito associado ao plano. Esse valor pode ser ajustado pelo administrador no momento do cadastro, caso seja necessário.

4. O que significa “Cadência” na tarifação?
A cadência define como será calculado o tempo das chamadas.
Exemplo: 3/30/6 → os primeiros 3 segundos são gratuitos; se ultrapassar, será cobrado no mínimo 30 segundos; depois disso, a cobrança segue em blocos de 6 segundos.

5. Como funcionam os prefixos?
A tabela de prefixos identifica chamadas internacionais. Quando o usuário disca 00 + código do país + número, a plataforma consulta o prefixo cadastrado para aplicar a tarifa correta.

6. É possível oferecer ligações gratuitas entre clientes?
Sim. Através das opções Intragrupo LC Gratuita e Intragrupo Gratuita, é possível configurar chamadas sem custo entre clientes da plataforma, locais ou de qualquer região.

PCP - Painel de Controle Principal

Planos / Planos Revenda


Palavras-chave

planos, revenda, tarifação, prefixo, valores, cadência, fixo, móvel

Objetivo

A página Planos de Revenda permite ao administrador criar planos de tarifação aplicados sobre as chamadas realizadas pelos circuitos da revenda.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

Prefixo

A página Prefixos é responsável por armazenar os prefixos de tarifação utilizados nas chamadas internacionais. Sempre que uma ligação for realizada utilizando 00 + código do país + número do destino, a plataforma consulta os prefixos cadastrados para identificar corretamente o país de destino e aplicar a tarifa de venda e cadência de tarifação correspondente.

 

Edição de Plano de Revenda

Ao clicar em Editar, será exibida a tela de configuração, onde o administrador poderá ajustar os seguintes campos:

Cadência

O campo Cadência define a forma como a tarifação da chamada será calculada, considerando tempo gratuito inicial, tempo mínimo tarifado e incrementos de cobrança.

O formato segue o padrão:
[Tempo gratuito] / [Tempo mínimo] / [Incremento]

Exemplo prático: em uma cadência 3/30/6, os valores significam:

Para entender melhor o funcionamento da cadência, recomendamos assistir ao nosso vídeo explicativo disponível no youtube.

 

FAQ – Perguntas Frequentes

1. Qual a diferença entre Plano de Revenda e Plano de Circuito?
O Plano de Revenda define os valores que serão aplicados às chamadas da própria revenda. Já o Plano de Circuito é criado para aplicar a tarifação das chamadas realizadas diretamente pelo circuito.

2. Posso criar múltiplos planos de revenda?
Sim. É possível cadastrar diferentes planos de revenda e ativar apenas os que forem necessários.

3. Alterar um plano de revenda afeta a tarifação dos circuitos da revenda?
Não diretamente. O impacto é apenas na tarifação da revenda. Os clientes finais continuam seguindo as regras dos planos de circuito criados pelo revendedor.

4. Como funciona a cadência no plano de revenda?
A cadência segue o mesmo padrão dos planos de circuito (ex.: 3/30/6 → 3 segundos gratuitos, mínimo de 30 segundos e incrementos de 6 segundos).

5. Planos de revenda permitem franquias ou serviços adicionais?
Não. Diferentemente dos planos de circuito, os planos de revenda têm apenas configurações básicas de tarifação (fixo, móvel e cadência).

PCP - Painel de Controle Principal

Planos / Planos Internacionais

 

Palavras-chave

Planos internacionais, tarifação, chamadas DDI, prefixos, tarifas, cadência

 

Objetivo

A página de Planos Internacionais, detalha os planos de tarifação para chamadas internacionais e como aplicar as tarifas específicas de cada país com base em seus prefixos.

 

Conteúdo

image.png

 

A página de Planos Internacionais permite configurar o comportamento de tarifação de chamadas internacionais. Ao cadastrar um plano, devem ser definidos os seguintes parâmetros:

Após cadastrar o plano, é possível acessar a seção de Tarifas para definir os valores aplicáveis de acordo com o prefixo do destino.

 

Tarifas Internacionais (DDI)

image.png

Na tela de tarifas, cada prefixo de país é listado com sua respectiva tarifa:

As tarifas podem ser cadastradas individualmente ou em lote, garantindo flexibilidade na atualização das tabelas.

A tarifação de chamadas internacionais é acionada a partir de rotas personalizadas que contenham o prefixo de discagem iniciado em "00".

 

FAQ - Perguntas Frequentes

1. O que acontece se não cadastrar tarifas para um prefixo específico?
Chamadas para aquele prefixo não serão tarifadas corretamente e poderão gerar valores zerados no faturamento.

2. É possível aplicar diferentes cadências para cada prefixo?
Não. A cadência é definida no nível do plano e será aplicada a todos os prefixos vinculados a ele.

3. O valor mínimo é aplicado mesmo em chamadas curtas?
Sim. Mesmo que a chamada dure apenas alguns segundos, o sistema sempre aplicará o valor mínimo configurado no plano.

4. Posso exportar a tabela de tarifas?
Sim. O sistema permite exportar as tarifas em CSV ou PDF diretamente da tela de tarifas internacionais.

PCP - Painel de Controle Principal

Gerenciamento / Áudios e Músicas

Palavras-chave

áudio, música, gravações, tronco de saída, mensagem, aviso, cadastro

Objetivo

A página Áudios e Músicas permite cadastrar e gerenciar arquivos de áudio que podem ser utilizados em diferentes funcionalidades da plataforma. No momento, o uso está restrito à configuração de troncos de saída, onde é possível definir um áudio para ser reproduzido antes da chamada ser completada.

Conteúdo

A página apresenta uma listagem com todos os áudios cadastrados e permite ações de upload, reprodução e exclusão.

image.png


Abaixo, detalhamos todos os campos da interface:

Exemplo de utilização: caso o cliente disque apenas CN + Número, sem o prefixo 0, é possível configurar na regra de saída que reproduza um áudio orientando o usuário a discar corretamente o número.

 

FAQ – Perguntas Frequentes

1. Quais formatos de áudio são aceitos?
Atualmente, os áudios devem estar em formato .mp3 para garantir compatibilidade com a plataforma.

2. Onde os áudios podem ser utilizados?
Neste momento, apenas na configuração de troncos de saída, para reproduzir mensagens antes do completamento da chamada. Futuramente, mais funcionalidades poderão integrar o uso de áudios.

3. É possível editar um áudio já enviado?
Não. Para alterar um áudio, é necessário excluir o arquivo atual e cadastrar uma nova versão.

4. Existe limite de tamanho para os arquivos?
Sim. Recomenda-se utilizar arquivos otimizados e curtos, para não impactar o tempo de resposta da chamada.

5. Posso reutilizar o mesmo áudio em diferentes troncos?
Sim. Um único áudio cadastrado pode ser associado a múltiplos troncos de saída ou regras de discagem.

PCP - Painel de Controle Principal

Gerenciamento / Blacklist

Palavras-chave

blacklist, bloqueio de chamadas, entrada, origem, destino, circuito, bloqueio de números, filtro de chamadas

Objetivo

A função Blacklist permite bloquear chamadas de entrada, seja de forma geral ou vinculadas a um circuito específico. Com ela, é possível evitar que determinados números ou padrões façam ligações indesejadas para o sistema.

Conteúdo

A página de Blacklist apresenta os números bloqueados e permite gerenciar as regras de bloqueio.

image.png

 

Abaixo, detalhamos todos os campos da interface:

Dica: Na criação de regras, é possível utilizar o caractere curinga "X" para bloquear faixas de números.

 

FAQ – Perguntas Frequentes

1. Posso bloquear um número específico?
Sim. Basta cadastrar o número completo em “Origem” ou “Destino”.

2. Posso bloquear apenas em um circuito?
Sim. Utilize a opção Novo Circuito e selecione o circuito desejado.

3. Consigo cadastrar vários números de uma vez?
Sim. Através da opção Importar CSV é possível inserir uma lista completa de bloqueios.

4. O bloqueio é aplicado em chamadas de saída também?
Não. A Blacklist atua apenas em chamadas de entrada.

5. É possível usar curingas no bloqueio?
Sim. O caractere X pode ser usado para bloquear faixas de números semelhantes.

PCP - Painel de Controle Principal

Gerenciamento / Consulta Números

Palavras-chave

números portados, portabilidade, operadora, ABR Telecom, nSAPN, consulta

Objetivo

A página Consulta Números permite que o usuário administrador consulte a origem e a situação de um número telefônico, verificando se ele foi portado ou não, além de outras informações técnicas relevantes, como operadora, localidade e prefixo.

Conteúdo

image.png

A consulta pode ser feita digitando um número específico ou carregando um arquivo em lote (.csv). O resultado apresenta uma tabela com os seguintes campos:

As informações exibidas nesta página não são de responsabilidade da SaperX. Elas são retiradas diretamente do painel nSAPN da ABR Telecom e disponibilizadas na plataforma apenas para facilitar a consulta.

FAQ – Perguntas Frequentes

1. As informações apresentadas são responsabilidade da SaperX?
Não. Elas são obtidas diretamente do nSAPN da ABR Telecom. A SaperX apenas disponibiliza a consulta integrada.

2. Como sei se um número é portado?
Na coluna Portado aparecerá “Sim” junto da data de portabilidade. Caso contrário, será exibido “Não”.

3. O que significa a coluna Operadora?
Ela mostra a operadora de origem do número e, se for portado, também a operadora atual (ex.: TIM → Vivo).

4. O que acontece se o número não for encontrado?
A consulta retornará nenhum resultado.

5. Posso consultar vários números ao mesmo tempo?
Sim. Utilize a opção de importação em lote via CSV.

PCP - Painel de Controle Principal

Gerenciamento / DETRAF POI

Palavras-chave

POI, Detraf, Ponto de Interconexão, SIP Trunk, RN2, Tarifas, PIS/Cofins, ICMS, EOT, TU-RL, TU-COM, VU-M, Softswitch SPX.

Objetivo

A página de DETRAF POI permitir o cadastro e a gestão completa dos pontos de interconexão (POI) utilizados para geração do relatório DETRAF. Aqui são definidos os vínculos entre SIP Trunks, EOT, e suas rotas (RN2), essenciais para o controle de tarifação, impostos e repasse de custos entre operadoras.

Conteúdo

image.png


Abaixo, detalhamos todos os campos da interface:

RN2:

O botão RN2 abre a tela de gerenciamento dos Route Number 2, códigos que identificam os tipos de chamada que trafegaram pelo tronco SIP vinculado ao POI. Esses códigos são fundamentais para a geração correta do relatório DETRAF, pois:

A criação e manutenção dos RN2 é feita em Gerenciamento > SIP Trunks. Embora não exista um padrão obrigatório, a SaperX recomenda um formato para facilitar o controle e a futura expansão.

Estrutura sugerida de um RN2 – Exemplo: 48010101

Esse padrão garante organização e rastreabilidade, tornando a cobrança e o roteamento mais confiáveis.

Tarifas:

As tarifas cadastradas nesta tela representam os valores repassados pela operadora interconectada e são fundamentais para o cálculo das cobranças do DETRAF.

Outro ponto relevante é que a tarifa considerada será sempre a mais vigente. Isso garante que os valores utilizados estejam atualizados e condizentes com o período em análise.

Não remova tarifas antigas; se necessário, apenas desative para manter histórico de auditoria.

FAQ - Perguntas Frequentes

1. Para que serve o POI no DETRAF?
Ele define o ponto de interconexão usado no cálculo e conferência do tráfego mensal entre redes.

2. Preciso preencher todos os campos?
Sim, especialmente PIS/Cofins, EOT, CN e tarifas, pois são obrigatórios para o relatório DETRAF.

3. Posso alterar tarifas antigas?
Não delete; desative para manter histórico e garantir rastreabilidade em auditorias.

4. Como relacionar RN2?
Clique em RN2 na coluna Ações para vincular as rotas SIP ao POI.

PCP - Painel de Controle Principal

Gerenciamento / DETRAF Cobrança

Palavras-chave

Detraf, Cobrança, EOT, Faturamento, CSV, Contestação, Relatório financeiro.

Objetivo

A página de DETRAF Cobrança apresentar a visão geral, onde são consolidadas e disponibilizadas as cobranças mensais geradas a partir do tráfego de chamadas entre operadoras. Nesta área é possível acompanhar os valores devidos, detalhar cada cobrança, exportar os dados e garantir que as informações utilizadas no envio do DETRAF estejam corretas.

Conteúdo

image.png

 

A tela principal exibe uma listagem por EOT (Estação de Origem e Terminação) e mostra para cada operadora o valor apurado no período selecionado. É possível filtrar pelo mês de referência e pesquisar por nome da operadora.

 

image.png

Ao clicar na folha, é carregada a página de detalhes com todas as informações de cobrança: Credora, Devedora, Período de Referência e de Tráfego, POI, Tipo e Descritor de chamada, Quantidade de Chamadas, Duração, Tarifa, Valor Líquido, PIS/COFINS, ICMS e Valor Bruto.

Esses dados alimentam o processo formal de envio do DETRAF Cobrança à operadora credora até o 5º dia útil de cada mês, com possibilidade de contestação em até 90 dias.

 

FAQ - Perguntas Frequentes

01. Quando a cobrança é enviada?
Até o 5º dia útil de cada mês, referente ao período anterior.

02. É possível contestar?
Sim, em até 90 dias após o envio.

03. Para que serve o download CSV?
Permite revisar e arquivar o relatório detalhado de chamadas e valores cobrados.

04. O que é o arquivo de batimento?
É uma exportação usada para conferência entre as partes envolvidas no processo de cobrança.

PCP - Painel de Controle Principal

Gerenciamento / DETRAF Cobrança Logs

 

Palavras-chave

Detraf, Logs, Bilhetagem, Tarifação, Conferência, CADUP, NSAPN, BDO

 

Objetivo

A página de Detraf Cobrança Logs tem como objetivo registrar todas as chamadas processadas durante a cobrança e conferência do DETRAF, apresentando de forma clara se cada bilhete foi tarifado ou não, bem como os motivos de eventuais falhas de tarifação.

 

Conteúdo

image.png


Abaixo, detalhamos todos os campos da interface:

 

As chamadas podem não ser tarifadas por diversos motivos, sendo os mais comuns:

 

FAQ - Perguntas Frequentes

1. O que significa uma chamada não tarifada?
Significa que a ligação foi processada, mas não gerou bilhete válido para cobrança DETRAF, normalmente por falha de cadastro ou inconsistência no número.

2. Onde devo verificar se o número está correto?
Os números devem ser conferidos nas tabelas de referência em consulta número.

3. Posso ajustar manualmente uma chamada não tarifada?
Não. O ideal é corrigir a origem do problema (número mal formatado ou ausência em base de referência) para que o sistema processe corretamente nas próximas cobranças.

PCP - Painel de Controle Principal

Gerenciamento / DETRAF Conferência

Palavras-chave

DETRAF Conferência, batimento de valores, contestação de cobrança, CDR, validação de tributos, comparativo operadoras.

Objetivo

A tela de DETRAF Conferência permite a conferência detalhada das cobranças DETRAF recebidas de outras operadoras, possibilitando o batimento de valores e a contestação quando houver divergências. A página exibe os totais por EOT e permite abrir o detalhamento completo para comparar chamadas, duração, tarifas e tributos já incluídos.

Conteúdo

image.png

A tela inicial do DETRAF Batimento apresenta um resumo mensal por EOT, exibindo o valor total a ser conferido por operadora. Aqui o usuário identifica rapidamente quais operadoras geraram cobranças e o montante total de cada uma, servindo como ponto de partida para a conferência.

image.png

Ao clicar no ícone de ação de uma operadora, abre-se o detalhamento das cobranças. Nele é possível analisar cada chamada que compõe o valor total, com dados de período de tráfego, quantidade de ligações, duração, tarifas aplicadas e tributos (Pis/Cofins e ICMS). Essa visão permite o batimento preciso com os registros internos e, se necessário, contestar diferenças.

Abaixo, detalhamos todos os campos da interface:

 

FAQ - Perguntas Frequentes

1. Para que serve o batimento do DETRAF Conferência?
Serve para comparar os valores cobrados pela operadora credora com os registros de tráfego próprios, permitindo contestar divergências.

2. Como confirmar se os tributos estão corretos?
No detalhamento, Pis/Cofins e ICMS já são calculados e incluídos no Total, facilitando a conferência.

3. Posso importar arquivos externos?
Sim. O botão Importar Arquivo permite enviar um CDR da operadora para checagem automática.

4. O que fazer se houver diferenças nos valores?
Use o relatório detalhado para identificar o EOT, exporte os dados e solicite à operadora credora o CDR para análise e contestação.

PCP - Painel de Controle Principal

Gerenciamento / DETRAF Conferência logs

 

Palavras-chave

Detraf, conferência, logs, batimento, chamadas, tarifação, CDR

 

Objetivo

O relatório Detraf Conferência Logs apresenta em detalhe todas as chamadas utilizadas no processo de conferência (batimento) do DETRAF. Ele permite analisar cada ligação processada, identificando o motivo de tarifação ou de eventuais falhas, garantindo a conferência correta dos valores cobrados pelas operadoras.

 

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. Qual a diferença entre os logs de Cobrança e de Conferência?
Os de Cobrança acompanham a geração de bilhetes para faturamento; os de Conferência registram as chamadas analisadas no batimento de valores enviados pelas operadoras.

2. Por que uma chamada pode aparecer como “não tarifada”?
Motivos comuns incluem números de origem ou destino (TN_A/TN_B) mal formatados ou não encontrados em bases como CADUP, NSAPN ou BDO.

3. É possível exportar esses dados?
Sim, basta aplicar os filtros desejados e utilizar a opção de exportação em CSV para análise detalhada.

4. Posso pesquisar por número específico?
Sim. Utilize o campo de busca para localizar chamadas por origem, destino ou ID do bilhete.

PCP - Painel de Controle Principal

Gerenciamento / DID Livres

Palavras-chave

did, números, gerenciamento, livre, circuito, ddr, venda, revenda, stfc, acb

Objetivo

A página DID Livres permite que o administrador visualize todos os números disponíveis para vinculação a circuitos, podendo configurá-los individualmente ou em lote. Além disso, possibilita liberar para venda, reservar para DDR, habilitar chamadas a cobrar e gerenciar vínculos de forma simples e centralizada.

Conteúdo

image.png

A tela apresenta a lista de DIDs cadastrados com as seguintes informações:

Ações Disponíveis

Na parte superior da tela, estão os botões de gerenciamento:

Edição de DID

Ao editar um número, é possível configurar os seguintes campos:

FAQ – Perguntas Frequentes

1. O que significa um DID estar liberado para venda?
Significa que o número está disponível para ser vinculado a um circuito.

2. Posso liberar vários DIDs ao mesmo tempo?
Sim. O botão Liberar Venda em Lote permite selecionar múltiplos DIDs e liberar todos de uma só vez.

3. O que é um número reservado para DDR?
É um número exclusivo para Discagem Direta a Ramal (DDR), sendo vinculado a um circuito específico para esse fim.

4. Posso exportar a lista de DIDs?
A exportação pode ser feita através do botão Download CSV.

PCP - Painel de Controle Principal

Gerenciamento / DID Vinculados

 

Palavras-chave

did, números, gerenciamento, vinculado, circuito, ddr, venda, revenda, stfc, acb

 

Objetivo

A página de DID Vinculados exibi e gerenciar todos os DIDs que já estão vinculados a circuitos na plataforma. Essa página centraliza o acompanhamento dos números em uso, permitindo ao administrador visualizar detalhes de cada DID, identificar seu circuito associado e aplicar ações de manutenção ou ajustes quando necessário.

 

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

Edição de DID

Ao editar um DID, a tela apresenta as seguintes opções:

O número de destino deve seguir as regras de discagem do tronco de saída. Por exemplo, para redirecionar a um celular de longa distância, utilize o formato 0 + DDD + número.

 

FAQ – Perguntas Frequentes

1. Qual a diferença entre DID Vinculados e DID Livres?
DIDs Livres não têm circuito associado, enquanto os Vinculados já estão em uso em um circuito ativo.

2. Posso exportar todos os DIDs vinculados de uma vez?
Sim. Use o botão Download CSV para gerar um arquivo com todos os registros atuais.

3. Posso ativar ou desativar chamadas a cobrar?
Sim. Na edição do DID, utilize a opção Aceita ACB para habilitar ou desabilitar chamadas a cobrar.

PCP - Painel de Controle Principal

Gerenciamento / Firewall

Palavras-chave

firewall, bloqueio, ip, regra, porta, udp, sip, rtp, segurança, desbloqueio

Objetivo

A página Firewall permite que o administrador visualize, crie e gerencie regras de acesso de rede nos servidores da plataforma. É possível configurar portas, protocolos, IPs de origem e ainda acompanhar os IPs que foram bloqueados automaticamente pelo sistema de proteção.

Conteúdo

image.png

Regras de Firewall

A página de firewall lista todas as regras configuradas nos servidores.

Lista de IPs Bloqueados

 O menu de IPs bloqueados lista todos os IPs bloqueados pelos serviços de segurança na plataforma. Os módulos de segurança consultam periodicamente tentativas de acessos sem sucesso nos serviços da plataforma. Quando identifica padrões inconsistentes, realiza o bloqueio automático impedindo que novas tentativas sejam realizadas.

Por padrão, os endereços IPs são bloqueados após 4 tentativas de autenticação sem sucesso no período de 6 horas. Após bloqueado, o endereço IP é liberado automaticamente depois de 24 horas.

 

FAQ – Perguntas Frequentes

1. O que acontece quando um IP é bloqueado?
O tráfego do IP é interrompido, impedindo que o mesmo acesse os servidores até ser manualmente desbloqueado.

2. Posso liberar portas específicas além das já existentes?
Sim, ao criar uma nova regra é possível definir exatamente quais portas UDP/TCP devem ser liberadas.

3. É possível desbloquear todos os IPs de uma vez só?
Sim, utilizando o botão Desbloquear Todos IPs disponível na seção Lista de IPs Bloqueados.

4. O que significa o campo Source?
O campo Source define a origem do tráfego que será permitido ou bloqueado (pode ser um país, um range de IP ou um IP específico).

PCP - Painel de Controle Principal

Gerenciamento / Integrações

 

Palavras-chave

Integrações, Relatórios, Exportação CSV, CDR, Faturas, SaperX.

 

Objetivo

A página de Integrações permite que o administrador exporte relatórios unificados de ligações e faturas para integração com sistemas externos, facilitando análises, conciliações e importação de dados.

 

Conteúdo

image.png

 

A página Integrações do Softswitch SaperX possibilita a geração de arquivos no formato CSV, prontos para importação em ERPs, CRMs ou plataformas de bilhetagem.

 

Estão disponíveis duas opções principais:

Relatório de Ligações

 

Relatório de Faturas

 

FAQ - Perguntas Frequentes

1. Posso gerar relatórios diários?
Sim. Basta selecionar a mesma data em “Data Inicial” e “Data Final”.

2. O arquivo CSV inclui detalhes de cada chamada?
Sim, o relatório de ligações contém todos os campos do CDR, como origem, destino, duração e tarifação.

3. É possível integrar automaticamente com outro sistema?
Sim. Como o formato é CSV, pode ser consumido por rotinas de importação ou scripts de automação em sistemas de terceiros.

PCP - Painel de Controle Principal

Gerenciamento / Layout PDF

Palavras-chave

layout, logo, favicon, capa, rodapé, identidade visual, personalização, imagens, design

Objetivo

A página Layout permite que o administrador personalize a identidade visual da plataforma, configurando logos, ícones e imagens que serão exibidos na interface e em documentos gerados pelo sistema (como faturas).

Conteúdo

image.png

Nesta página, é possível enviar e gerenciar os seguintes elementos visuais:

image.png

image.png

image.png

image.png

FAQ – Perguntas Frequentes

1. Qual a importância do favicon?
O favicon é o pequeno ícone exibido na aba do navegador, ajudando na identificação visual rápida da plataforma.

2. O que acontece se eu não enviar um logo?
Caso não seja enviado um logo, o sistema pode utilizar um padrão definido ou exibir a área correspondente em branco.

3. Posso enviar imagens em qualquer tamanho?
Não. É recomendado utilizar as dimensões indicadas (16x16 px, 120x40 px, 968x160 px) para garantir o ajuste correto no layout.

4. As alterações aparecem imediatamente após salvar?
Sim. Assim que a opção Salvar é acionada, as imagens são aplicadas e já podem ser visualizadas na interface e nos documentos.

PCP - Painel de Controle Principal

Gerenciamento / Manipulação de A e B

Palavras-chave

manipulação, regex, número A, número B, chamadas, circuitos

Resumo / Objetivo

A tela de Manipulação de A e B permitir a criação de regras para ajustar automaticamente o número de origem (A) ou de destino (B) em chamadas de entrada e saída. Essas manipulações facilitam a padronização dos números e a compatibilidade com rotas e operadoras.

Conteúdo

image.png

 

A tela Manipulação de A e B permite cadastrar regras de transformação dos números.

Exemplo: adicionar automaticamente o código do país “+55” a todos os números nacionais.

Habilitação por circuito

image.png

A aplicação das manipulações é configurada individualmente em cada circuito. Para habilitar, devemos:

  1. Abrir a edição de um circuito.

  2. Na seção Manipulações de A e B, ative conforme necessário: 

    • Manipular A – Entrada / Saída

    • Manipular B – Entrada / Saída

  3. Ao habilitar, selecione a regra cadastrada previamente no menu Manipulação de A e B e salve as configurações do circuito.

Somente os circuitos com a manipulação habilitada executarão a transformação configurada.

FAQ – Perguntas Frequentes

1. Posso criar várias regras de manipulação?
Sim. Cadastre quantas regras forem necessárias, cada uma com sua expressão regular e formato de saída.

2. Onde habilito a manipulação para um circuito específico?
Na edição do circuito, na seção Manipulações de A e B, ativando a opção desejada (Entrada ou Saída).

3. A manipulação afeta todos os circuitos?
Não. Ela só é aplicada aos circuitos em que for habilitada manualmente.

4. Posso testar uma expressão regular antes de usar?
Recomenda-se validar a regex externamente antes de aplicar, para garantir que o padrão funcione conforme esperado.

PCP - Painel de Controle Principal

Gerenciamento / Portabilidade

 

Palavras-chave

Portabilidade, Port IN, Port OUT, Devolver Número, migração de linhas, SaperX.

Objetivo

O módulo de Portabilidade do Softswitch  permite solicitar, acompanhar e gerenciar a migração de números telefônicos entre operadoras diretamente pelo sistema.

Conteúdo

image.png

O módulo de Portabilidade automatiza todo o processo de migração de números. A partir deste painel é possível:

Cada aba apresenta uma lista detalhada com ID, status, número, cidade, operadora doadora, cliente, CPF/CNPJ, data de portabilidade e ações de edição/visualização.

Port IN

Tela para cadastrar e acompanhar solicitações de portabilidade de números que virão para a base da empresa.

Port OUT

Apresenta as solicitações de portabilidade em que outras operadoras solicitaram a saída de um número.

Devolver Número

Utilizado quando um número precisa ser devolvido à operadora de origem, encerrando seu vínculo com a operadora.

FAQ - Perguntas Frequentes

01. Posso acompanhar o andamento de uma portabilidade em tempo real?
Sim. O status é atualizado automaticamente na coluna Status de cada solicitação.

02. Como iniciar uma nova portabilidade de entrada?
Na aba Port IN, clique em Nova portabilidade e preencha as informações solicitadas.

03. É possível cancelar uma solicitação em andamento?
Sim, enquanto o status permitir, utilize o ícone de edição/exclusão na coluna Ações.

04. O que significa “Devolver Número”?
Significa liberar o número e devolvê-lo à operadora de origem, encerrando seu vínculo com a operadora atual.

PCP - Painel de Controle Principal

Gerenciamento / Rotas Personalizadas

Palavras-chave

rotas personalizadas, regras de roteamento, chamadas, troncos SIP, bilhetagem, E.164, prefixos, central, DETRAF, RN3

Objetivo

A página Rotas Personalizadas permite configurar as regras de roteamento utilizadas para completar chamadas. Com ela, o administrador pode definir o padrão de discagem aceito, para quais troncos as ligações serão encaminhadas, aplicar regras de conversão de números e organizar de forma flexível o fluxo das chamadas dentro da plataforma.

Conteúdo

image.png

A tela apresenta a lista de rotas já cadastradas com as seguintes informações:

Regras de Roteamento

As Regras de Roteamento permitem configurar como as chamadas serão direcionadas dentro de uma rota personalizada. O administrador pode definir padrões de discagem, associar chamadas a troncos específicos, aplicar prioridades e definir regras de fallback, garantindo maior controle e flexibilidade no encaminhamento das ligações.

image.png

A tela apresenta a lista de regras já cadastradas para a rota selecionada, exibindo as seguintes informações:


Edição das regras de roteamento

Ao editar uma regra de roteamento, existem diversas opções configuráveis. Abaixo, detalhamos todos os campos da interface:

Troncos SIP nas Regras de Roteamento

Após definir a regra de roteamento, o próximo passo é indicar os troncos SIP que serão utilizados para completar as chamadas que corresponderem ao padrão configurado.

image.png

A tela apresenta a lista de troncos já associados à regra, com as seguintes informações:

Edição de Tronco SIP

Ao editar ou adicionar um tronco à regra, é possível configurar os seguintes campos:

Troncos Local Network

image.png

O tronco Local Network é utilizado nas regras de saída para rotear chamadas entre números que estão cadastrados na própria plataforma, sem passar por uma operadora externa.
Quando configurado como primeira opção em rotas locais ou LDN, o sistema verifica se o número de destino pertence a algum cliente interno antes de tentar outros troncos.

Exemplo de uso
Se o cliente A, com o número (48) 3131-0110, liga para o cliente B, com o número (48) 3121-0111, e ambos estão na plataforma, a regra com tronco Local Network encaminhará a chamada internamente. Somente se o destino não for encontrado entre os clientes cadastrados é que a chamada seguirá para o próximo tronco configurado (geralmente um tronco de operadora).

 

FAQ – Perguntas Frequentes

1. Qual a diferença entre rota personalizada e regra de roteamento?
A rota personalizada é o conjunto geral que organiza as chamadas dentro da plataforma. Já as regras de roteamento são as condições específicas que determinam como cada chamada será tratada dentro dessa rota.

2. O que é o campo Prefixo Discado em uma regra?
É o padrão de discagem necessário para que a regra seja acionada. Por exemplo, configurar 0800XXXXXXX fará com que todas as chamadas para números 0800 utilizem aquela regra.

3. Como funciona o Prefixo do Número A?
Esse campo aplica a regra de acordo com o número de origem. Se for configurado como 11, todas as chamadas originadas de DDD 11 seguirão essa regra.

4. Para que serve o campo Forçar Bilhetagem?
Ele define qual tipo de tarifação será aplicada na chamada (LC, LDI, LDN, VC1, VC2, VC3 ou Automático).

5. Posso definir prioridades entre diferentes troncos na mesma regra?
Sim. O campo Peso estabelece a prioridade. Troncos com peso menor têm preferência no roteamento da chamada.

6. O que acontece se eu ativar o uso do RN3?
A opção adiciona automaticamente a marcação Route Number 3 (060) em chamadas destinadas a números portados, garantindo compatibilidade no encaminhamento.

7. Qual a utilidade do DETRAF?
O DETRAF permite ativar a coleta de dados de tráfego e tarifação, facilitando auditoria e relatórios detalhados de uso.

8. Se eu excluir um tronco de uma regra, ele será removido da plataforma?
Não. Apenas a associação do tronco com aquela regra será excluída. O tronco continuará disponível para uso em outras rotas.

9. É possível duplicar uma rota já configurada?
Sim. A função de duplicar gera uma cópia idêntica da rota, agilizando a criação de rotas semelhantes.

10. O que acontece se eu excluir uma rota personalizada?
Todas as regras e troncos vinculados a ela também serão removidos. Essa ação é definitiva e não pode ser desfeita.

PCP - Painel de Controle Principal

Gerenciamento / Servidores

Palavras-chave

servidores, topologia, ip, core, database, gerência, registro, sip

Objetivo

A página Servidores permite cadastrar e gerenciar os servidores que fazem parte da topologia do produto. Esses servidores podem ter diferentes funções, como CORE que é o servidor onde de fato as chamadas acontecem ou DATABASE, utilizado para armazenar e consultar informações/configurações. Os servidores cadastrados são utilizados em diversas áreas do sistema, como na página de Status, que exibe estatísticas de hardware, e em funções que permitem criar regras para servidores específicos, como regras de roteamento e regras de firewall.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Para que servem os servidores cadastrados?
Eles definem a topologia do cliente no sistema e são utilizados para exibir estatísticas na página de Status, além de permitir a criação de regras específicas em roteamento e firewall.

2. Posso cadastrar mais de um IP para o mesmo servidor?
Sim, é possível incluir IPs adicionais que podem ser usados para gerência, registro SIP ou outros acessos.

3. O que acontece se eu excluir um servidor?
O servidor é removido da topologia e deixa de ser exibido em páginas de monitoramento e nas regras que dependiam dele. A ação é irreversível.

PCP - Painel de Controle Principal

Gerenciamento / Sip Trunks

Palavras-chave

sip, trunks, troncos, operadoras, registro, ponto a ponto, interconexão, comunicação, roteamento, voip, autenticação

Objetivo

A página SIP Trunks permite cadastrar e gerenciar os troncos SIP que fazem a comunicação da plataforma com as operadoras. Através dessa configuração, é possível estabelecer a interconexão para entrada e saída de chamadas, utilizando dois modelos principais:

Conteúdo

image.png

A tela apresenta a lista de troncos cadastrados com as seguintes informações:

Custo

O menu de custo permite adicionar o valor das tarifas cobradas pela operadora para completar chamadas. Estes valores serão utilizados para apresentar o lucro em cada ligação através do relatório de ligações por Sip Trunks.

RN2

O menu de RN2 permite cadastrar os Route Number 2 ou TechPrefix utilizados para identificar os tipos de ligações recebidas/enviadas para as operadoras com interconexão STFC. Estas marcações são utilizadas para identificar o tipo de chamada completada e aplicar as tarifas de DETRAF corretas de acordo com o tipo da ligação.

Edição do Sip Trunk

A tela de edição de tronco SIP permite configurar todos os parâmetros necessários para o funcionamento do tronco junto à operadora.

image.png

FAQ – Perguntas Frequentes

1. Qual a diferença entre tronco por registro e tronco ponto a ponto?

2. Para que serve a opção de Suprimir (out) e Suprimir (in)?

3. O que acontece se eu desativar um tronco?
O tronco ficará cadastrado, mas não será mais utilizado para receber/completar chamadas.

4. Como funciona o campo Tech Prefix (out)?
O Tech Prefix (out) adiciona um prefixo técnico antes do número, usado em algumas operadoras para identificar a rota ou o contrato.

5. O que é o campo RN2?
O RN2 é a marcação de identificação de chamadas. É um recurso utilizado para identificar as chamadas por tipo durante a classificação de bilhetagem do DETRAF.

PCP - Painel de Controle Principal

Gerenciamento / Variáveis de Sistema

 

Palavras-chave

Variáveis de ambiente, parâmetros globais, configuração de e-mail, bina, autenticação proxy, SaperX.

 

Objetivo

A página de Variaveis dePermitir que o administrador defina parâmetros que controlam o comportamento global do Softswitch SaperX, garantindo que recursos como envio de e-mail, criação de circuitos e portabilidade funcionem conforme a política da operadora.

 

Conteúdo

image.png

A página Variáveis de Sistema concentra ajustes avançados que influenciam o funcionamento de todo o ambiente. Cada variável representa um parâmetro global e deve ser alterada com cautela.


A seguir descrevemos as variáveis disponíveis para configuração:

 

FAQ - Perguntas Frequentes

1. Preciso reiniciar o servidor após alterar uma variável?
Não. As alterações são aplicadas em tempo real.

2. Posso usar qualquer porta SMTP?
Sim, desde que compatível com o servidor de e-mail e liberada no firewall.

3. O que acontece se mudar as variáveis de portabilidade?
Pode comprometer o funcionamento das solicitações de Port IN/OUT. Alterações só devem ser feitas mediante orientação oficial do suporte.

PCP - Painel de Controle Principal

Ligações / CDR

 

Palavras-chave

cdr, call detail record, registros de chamadas, histórico, bilhetagem, tarifação, exportar csv

 

Objetivo

A página CDR (Call Detail Record) apresenta o histórico das ligações processadas pela plataforma. Permite filtrar, visualizar e exportar os registros para auditoria, faturamento e controle operacional.

 

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Posso exportar os registros?
Sim. Use Download CSV para exportar os dados filtrados.

2. Qual a diferença entre Tempo Total e Tempo Tarifado?
Tempo Total é a duração completa; Tempo Tarifado é o tempo usado para cobrança.

3. Consigo buscar chamadas de um número específico?
Sim. Combine os filtros e a busca por Origem ou Destino.

4. Por que alguns campos aparecem vazios (ex.: IP Origem)?
Nem todos os cenários fornecem todas as variáveis (ex.: rotas internas ou operadoras que não enviam IP/CID).

5. Para que servem os códigos EOT_A/EOT_B?
São classificações de origem/destino utilizadas para tarifação, relatórios e regras de roteamento.

PCP - Painel de Controle Principal

Ligações / Ligações em tempo real

Palavras-chave

tempo real, ligações ativas, monitoramento, supervisão, canais SIP, codecs, status da chamada, origem, destino, auditoria ao vivo

Objetivo

O painel de Ligações em Tempo Real permite acompanhar, de forma instantânea, todas as chamadas que estão em andamento na plataforma. É uma ferramenta voltada para supervisão e controle operacional, ajudando a identificar congestionamentos, falhas de rota ou comportamentos anormais no tráfego.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

FAQ - Perguntas frequentes

1. Qual a diferença entre o CDR e o painel em tempo real?
O CDR mostra o histórico completo de todas as ligações. O painel em tempo real mostra apenas chamadas ativas no momento da consulta.

2. É possível saber quando uma ligação foi finalizada?
Não neste painel. Após a finalização, a chamada deixa a tela de tempo real e passa a compor o CDR.

3. O que significa “Codec alaw > g729”?
Indica que a origem usa alaw, mas a rota de saída converteu para g729, permitindo adaptação entre diferentes operadoras.

PCP - Painel de Controle Principal

Faturas Fechadas / Circuitos

Palavras-chave

faturas, faturamento, relatórios financeiros, cobrança, PDF, download em lote, mensalidade, ligações, SVA, totalizador, referência, ciclo de cobrança

Objetivo

A página de Faturas Fechadas centraliza as informações financeiras consolidadas dos clientes em um determinado mês de referência. Nela, é possível visualizar os valores de todas as faturas já encerradas no período, consultar totais por cliente ou por circuito, além de gerar relatórios em PDF de forma individual ou em lote.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

Totalizadores

No rodapé da página, a plataforma apresenta os valores totais consolidados do período, separados em:

FAQ - Perguntas frequentes

1. As faturas exibidas podem ser editadas?
Não. Faturas fechadas já foram consolidadas e não permitem alteração.

2. Posso exportar todas as faturas de uma vez?
Sim. A função Download em Lote permite agrupar múltiplos PDFs em um único pacote para clientes que possuem vários circuitos.

3. O que significa SVA?
São Serviços de Valor Adicionado, como funcionalidades extras, números especiais ou recursos adicionais contratados pelo cliente.

4. Como funciona a referência da fatura?
A referência indica o mês e ano de competência da cobrança, por exemplo, “09/2025” corresponde a setembro de 2025.

5. O total exibido na tela é confiável para conferência contábil?
Sim. O totalizador mostra a soma exata de todas as faturas fechadas no período selecionado.

PCP - Painel de Controle Principal

Faturas Fechadas / Revendas

Palavras-chave

faturas revenda, billing, revendedores, DID, saldo diário, faturamento indireto, referência, relatório financeiro

Objetivo

A página de Faturas Fechadas de Revendas consolida as informações de faturamento referentes aos revendedores cadastrados na plataforma. Diferente das faturas de clientes finais, aqui a visão é voltada para o controle de revendas e seus DIDs associados, permitindo acompanhar de forma centralizada a quantidade de recursos utilizados e o saldo gerado no período.

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface:

FAQ - Perguntas Frequentes

1. Qual a diferença entre a fatura de cliente final e a de revenda?
A fatura de cliente final mostra valores de chamadas, mensalidades e serviços. Já a fatura de revenda foca na quantidade de DIDs e saldo faturado das ligações dos circuitos da revenda para cada parceiro.

2. Posso verificar quais DIDs compõem o valor da fatura?
Sim. A coluna Lista DIDs disponibiliza a relação detalhada dos números vinculados à revenda.

3. O saldo exibido já é o valor final da cobrança?
Sim. O campo Saldo do dia (R$) corresponde ao total consolidado para a revenda naquele período.

4. Consigo baixar a fatura individual em PDF?
Não. Nesta página, o formato de exportação disponível é CSV, para relatórios consolidados e integração.

5. Posso comparar diferentes meses?
Sim. Alterando o campo Referência, é possível navegar entre períodos distintos e comparar a evolução do faturamento das revendas.

PCP - Painel de Controle Principal

Dashboard / Chamadas

Palavras-chave

dashboard, chamadas, estatísticas, SIP trunk, clientes, mapa de ligações, top estados, monitoramento, tráfego

Objetivo

A Dashboard de Chamadas tem como objetivo apresentar uma visão consolidada e em tempo real do tráfego de ligações da plataforma. Ela permite que o operador visualize os principais clientes, SIP trunks em uso, a distribuição geográfica das chamadas e a evolução diária do tráfego. Essa visão centralizada facilita a identificação de padrões de consumo, gargalos de rede e análise estratégica da utilização dos recursos.

Conteúdo

image.png

TOP Clientes

Ranking dos clientes que mais realizaram chamadas no período.

TOP SIP Trunks

Exibe os troncos SIP com maior volume de tráfego.

Mapa de Ligações

Representação geográfica do destino das chamadas no território nacional.

FAQ - Perguntas Frequentes

1. O que significa o ranking de TOP Clientes?
Representa os clientes que mais consumiram recursos de chamadas no período, ordenados pelo volume total de ligações.

2. É possível identificar gargalos de SIP Trunks pela dashboard?
Sim. O ranking de TOP SIP Trunks mostra quais troncos concentram mais tráfego, facilitando o monitoramento de uso e planejamento de capacidade.

3. O mapa de ligações mostra chamadas internacionais?
Não. O mapa exibe apenas a distribuição de chamadas nacionais, segmentadas por estados brasileiros.

4. O gráfico diário mostra chamadas em tempo real?
O gráfico representa o volume de chamadas processadas no dia corrente, atualizado em intervalos periódicos pelo sistema.

5. Posso exportar os dados da dashboard?
Não diretamente. Para análises detalhadas, deve-se utilizar os relatórios de chamadas (CDR) disponíveis no menu Ligações.

PCP - Painel de Controle Principal

Dashboard / Geral


Palavras-chave

dashboard geral, monitoramento, ligações, estatísticas, circuitos, DIDs, status, mapa de ligações, indicadores

Objetivo

A Dashboard Geral apresenta uma visão consolidada da operação da plataforma, reunindo os principais indicadores de desempenho e status dos recursos. Seu objetivo é fornecer, de forma centralizada, uma visão quantitativa e qualitativa sobre chamadas, circuitos, DIDs e distribuição geográfica das ligações, permitindo o acompanhamento em tempo real e a rápida identificação de falhas ou gargalos.

Conteúdo

image.png

Indicadores superiores (KPI’s principais)

Chamadas (por status)

Distribuição de chamadas em quatro categorias:

Ligações Processadas – Gráfico Diário

Exibe a linha do tempo do volume de ligações de entrada e saída ao longo do dia.

Circuitos

Painel de status de recursos, mostrando

Mapa de Ligações

Representação geográfica das chamadas com destaque para os estados com maior participação.

Top Estados

Percentual de tráfego de ligações originadas ou recebidas em cada estado.

Números no Fim

Lista de números disponíveis por cidade para alocação, agrupados por quantidade.

FAQ - Perguntas Frequentes

1. O que significa a métrica “Horas em Conversação”?
Representa a soma do tempo de todas as chamadas atendidas, permitindo avaliar a intensidade do tráfego no período.

2. Os circuitos “Offline” indicam falha no serviço?
Não necessariamente. Um circuito pode estar offline por motivos de manutenção, configuração ou ausência de tráfego no momento.

3. As chamadas inválidas aparecem no relatório detalhado de CDR?
Sim. Chamadas inválidas ficam registradas no CDR e podem ser analisadas pelo motivo de falha associado.

4. Posso comparar os estados no mapa com períodos diferentes?
Sim. Alterando o campo de referência (data), é possível avaliar a variação de participação dos estados em períodos distintos.

5. A seção “Números no Fim” mostra todos os DIDs disponíveis?
Sim, agrupa os números did por cidade e quantidade disponível. Por exemplo se Pelotas/ RS e São José/SC possuírem apenas dois números disponíveis, serão apresentados na sessão "Livres: 2".

PCP - Painel de Controle Principal

Relatórios / ANATEL - Spoofing Mensal

Palavras-chave

spoofing, chamadas irregulares, ANATEL, relatório mensal, CSV, auditoria, ligações inválidas, interconexão, prestadoras, compliance

Objetivo

O relatório de Spoofing tem como finalidade identificar e consolidar chamadas classificadas como irregulares de acordo com as regras definidas pela ANATEL.

Essa funcionalidade auxilia as operadoras e provedores a:

Conteúdo

image.png

 

Na plataforma, o relatório está dividido em duas visões principais:

 

FAQ – Perguntas Frequentes

1. Qual a diferença entre o relatório sintético e o relatório analítico?
O relatório sintético apresenta apenas os vínculos de operadoras, POIs, SIP Trunks e rotas, de forma consolidada. Já o relatório analítico, disponível para exportação em CSV, detalha as chamadas suspeitas (com números, datas e durações).

2. Esse relatório atende às exigências da ANATEL?
Sim. O relatório é estruturado de acordo com as regras de reporte de chamadas suspeitas de spoofing exigidas pela ANATEL.

3. É possível exportar o relatório em PDF?
Não. Atualmente a exportação é realizada somente em CSV (separado por quinzena).

4. Posso acompanhar as chamadas em tempo real?
Não. O relatório é consolidado por período, devendo ser consultado após o fechamento de cada quinzena/mês.

5. O que devo fazer ao identificar chamadas irregulares?
As informações devem ser analisadas internamente e, quando aplicável, enviadas à ANATEL conforme a regulamentação vigente.

PCP - Painel de Controle Principal

Relatórios / ASR e ACD

Palavras-chave

ASR, ACD, Answer Seizure Ratio, Average Call Duration, qualidade de chamadas, indicadores de performance, troncos, análise VoIP

Objetivo

O relatório ASR e ACD fornece indicadores essenciais para avaliação da qualidade das chamadas processadas na plataforma. Essas métricas ajudam a mensurar a efetividade das rotas de terminação, a performance de troncos SIP e o comportamento do tráfego, permitindo identificar problemas técnicos, rotas de baixa qualidade ou até tentativas de fraude.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface. Cada linha corresponde a um tronco SIP utilizado no período selecionado. As colunas apresentam:

ASR (Answer Seizure Ratio):
ACD (Average Call Duration):

Interpretação dos Indicadores

FAQ – Perguntas Frequentes

1. Posso comparar a performance de diferentes troncos SIP?
Sim, o relatório já organiza os resultados por tronco, permitindo identificar quais fornecedores apresentam melhor desempenho.

2. Qual é um valor de ASR considerado bom?
Em geral, valores acima de 50% já indicam rotas razoáveis. Operadoras de qualidade costumam apresentar 70% ou mais.

3. E quanto ao ACD?
O ACD varia de acordo com o perfil de chamadas. Para tráfego residencial, a média costuma ser maior. Já para campanhas automáticas (robocalls), o ACD tende a ser menor.

4. Como exportar os dados para análise externa?
Basta clicar no botão Download CSV para gerar o arquivo.

PCP - Painel de Controle Principal

Relatórios / Auditoria

Palavras-chave

Auditoria, registros de ações, logs de sistema, histórico de acessos, controle de usuários, segurança, rastreabilidade, SPX.

Objetivo

O relatório de Auditoria registra todas as ações executadas por usuários dentro da plataforma. Ele tem como finalidade garantir segurança, rastreabilidade e transparência, permitindo identificar quem fez o quê, quando e em qual módulo.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface.

FAQ – Perguntas Frequentes

01. Qual a utilidade do relatório de auditoria?
Ele garante rastreabilidade, permitindo verificar todas as ações feitas pelos usuários na plataforma.

02. Posso saber quem alterou um circuito ou rota personalizada?
Sim, cada ação de Update ou Insert traz o nome do usuário, data e detalhes da modificação.

03. O relatório registra falhas de login?
Não, os eventos de login (não-sucedidos) não são registrados como Notice.

04. Consigo exportar os registros?
Atualmente, o relatório é consultado diretamente na tela, mas pode ser integrado/exportado dependendo da configuração administrativa.

PCP - Painel de Controle Principal

Relatórios / Circuitos Inativos

Palavras-chave

circuitos, inatividade, chamadas, DID, plano, última ligação, monitoramento, relatório de utilização

Objetivo

O relatório de Circuitos Inativos tem como objetivo exibir a atividade de chamadas em cada circuito cadastrado na plataforma. Essa visão permite acompanhar o uso real de cada circuito e identificar de maneira rápida circuitos com inatividade, ajudando no controle e na análise de uso.

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface.


FAQ - Perguntas Frequentes

1. O relatório mostra apenas circuitos que estão offline?
Não. O relatório exibe todos os circuitos cadastrados e destaca a última atividade de chamadas (recebida e efetuada), permitindo identificar períodos sem uso.

2. Qual a diferença entre “Última Ligação Recebida” e “Última Ligação Efetuada”?

3. Posso verificar se um circuito está realmente inativo?
Sim. Caso as datas de última ligação recebida e efetuada estejam muito distantes, o circuito pode estar inativo.

4. Os DIDs exibidos são todos os vinculados ao circuito?
Sim. A lista apresentada mostra todos os números associados ao circuito consultado.

5. É possível exportar o relatório para análise externa?
Sim. Basta utilizar a opção Download CSV para obter os dados completos e tratá-los em planilhas.

PCP - Painel de Controle Principal

Relatórios / Circuitos, Planos e DID


Palavras-chave

circuitos, planos, DID, cidade, estado, revenda, vínculos, situação, filtros avançados

Objetivo

O relatório de Circuitos, Planos e DID tem como objetivo apresentar uma visão detalhada da relação entre os circuitos cadastrados, seus planos associados e os DIDs vinculados. 

Diferente do relatório de circuitos inativos, este relatório não agrupa os DIDs em um único registro, exibindo cada vínculo individualmente, juntamente com a cidade/estado de origem do número e a informação sobre a revenda responsável.

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface.

FAQ - Perguntas Frequentes

1. Qual a diferença principal em relação ao relatório de Circuitos Inativos?
Este relatório apresenta cada DID individualmente, com a cidade/estado e vínculo de revenda, enquanto o de Circuitos Inativos foca no histórico de chamadas e atividade do circuito.

2. É possível localizar DIDs que ainda não foram vinculados a um circuito?
Sim. Basta selecionar a opção Mostrar DID → Sem vínculo.

3. Para que serve o filtro de Situação?
Ele permite identificar rapidamente quais circuitos estão ativos, bloqueados totalmente ou com bloqueio parcial.

4. Posso analisar todos os circuitos de uma única revenda?
Sim. O filtro de Revenda retorna todos os circuitos e DIDs pertencentes àquela revenda específica.

5. O relatório mostra apenas circuitos ativos?
Não. Através do filtro de Situação, é possível consultar tanto circuitos ativos quanto bloqueados.

PCP - Painel de Controle Principal

Relatórios / Clientes

Palavras-chave

clientes, cadastro, CPF, CNPJ, circuitos, agrupamento, faturas, consulta

Objetivo

O relatório de Clientes tem como objetivo apresentar de forma rápida e organizada todos os clientes cadastrados na plataforma. Os clientes funcionam como agrupadores de informações, permitindo vincular múltiplos circuitos a um mesmo titular, facilitando consultas, emissão de faturas e filtros em relatórios.

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. Para que serve o cadastro de clientes?
O cadastro organiza e agrupa os circuitos vinculados a cada titular, permitindo gestão unificada e simplificada.

2. Posso ter mais de um circuito associado ao mesmo cliente?
Sim. O cliente pode possuir vários circuitos vinculados, sendo todos identificados pelo mesmo CPF/CNPJ.

3. Este relatório exibe informações financeiras, como faturas?
Não. Ele apresenta apenas a listagem de clientes e seus documentos. As faturas podem ser acessadas em relatórios específicos.

PCP - Painel de Controle Principal

Relatórios / Consumo por minutagem

Palavras-chave

minutagem, consumo, faturamento, custo, lucro, categorias de ligação, tarifação, revenda

Objetivo

O relatório de Consumo por Minutagem tem como objetivo consolidar as informações de tempo de uso, custos e lucros das chamadas realizadas na plataforma.

Com base nas tarifas cadastradas nos troncos SIP, o sistema calcula automaticamente o valor gasto e o valor arrecadado, permitindo a análise do desempenho financeiro das ligações por categoria.

Para que os valores de custo e lucro sejam corretamente calculados, é necessário que o administrador configure previamente os valores cobrados pelas operadoras no completamento das chamadas, dentro da seção de custos dos SIP Trunks.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. O que significam as categorias (CNG, LC, LDN, VC1, VC2, VC3)?
Elas representam os diferentes tipos de ligação configurados na plataforma, como chamadas locais, longa distância, LDI, etc.

2. O relatório considera apenas ligações faturáveis?
Sim. Os cálculos de custo e lucro são baseados nas tarifas cadastradas e aplicadas somente às chamadas concluídas.

3. Posso exportar os dados desse relatório?
Sim. Assim como em outros relatórios, existe a opção de exportar o conteúdo em formato CSV.

4. Qual a diferença entre Custo e Lucro?

PCP - Painel de Controle Principal

Relatórios / Consumo por Plano

Palavras-chave

planos, consumo, tarifação, tempo, categorias, franquia, chamadas, análise

Objetivo

O relatório de Consumo por Plano tem como objetivo apresentar de forma consolidada o tempo de utilização das chamadas vinculadas a cada plano cadastrado na plataforma.

Esse relatório é fundamental para acompanhar o desempenho e o nível de utilização dos diferentes planos contratados, permitindo verificar o consumo por categoria de chamada (ex.: local, longa distância, emergencial, VC1, VC2, VC3).

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Esse relatório apresenta valores financeiros?
Não. O relatório de consumo por plano é focado exclusivamente em exibir o tempo total das chamadas realizadas por categoria, sem cálculos de custo ou lucro.

2. Qual a utilidade prática desse relatório?
Ele permite que administradores identifiquem os planos mais utilizados e em quais categorias de ligação ocorre maior consumo, auxiliando na análise de performance e dimensionamento de franquias.

3. Posso filtrar apenas um plano específico?
Sim. Basta selecionar o plano desejado no campo Planos e clicar em Pesquisar.

4. É possível exportar os resultados?
Sim. O relatório pode ser exportado em formato CSV para análise externa.

PCP - Painel de Controle Principal

Relatórios / DID livres por cidade

Palavras-chave

DID, numeração, disponibilidade, cidade, estoque, telefones, cadastro

Objetivo

O relatório de DIDs Livres por Cidade tem como objetivo apresentar, de forma simples e direta, a quantidade de números DID disponíveis para uso em cada localidade cadastrada na plataforma.

Essa funcionalidade permite ao administrador ou revenda visualizar rapidamente o estoque de DIDs, facilitando o gerenciamento de numeração e a distribuição conforme a demanda de cada cidade.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Esse relatório mostra os DIDs já atribuídos?
Não. Ele apresenta apenas o número total de DIDs cadastrados e quantos ainda estão livres, ou seja, disponíveis para uso.

2. Posso verificar quais clientes já utilizam os DIDs?
Não diretamente neste relatório. Para identificar o cliente que está utilizando um DID, é necessário consultar os relatórios de Circuitos, Planos e DID ou os cadastros específicos de DIDs.

3. O relatório é atualizado automaticamente?
Sim. Sempre que um DID for atribuído ou liberado, a informação será atualizada na listagem.

4. É possível exportar a listagem de DIDs livres?
Sim. Basta clicar em Download CSV para gerar um arquivo com todos os dados do relatório.

PCP - Painel de Controle Principal

Relatórios / DID cadastrado por período

Palavras-chave

DID, cadastro, período, criação, vínculo, circuito, revenda, histórico

Objetivo

O relatório de DIDs Cadastrados por Período tem como objetivo apresentar todos os números cadastrados na plataforma dentro de um intervalo de tempo definido.

Além de mostrar a data de criação, também informa quando o DID foi vinculado a um circuito, permitindo acompanhar o ciclo de utilização da numeração e facilitar o controle histórico dos recursos.

Conteúdo

image.png


Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. Qual a diferença entre filtrar por data de criação e data de vínculo?

2. Um DID pode aparecer duas vezes no relatório?
Não. Cada DID é exibido apenas uma vez, mostrando tanto a data de criação quanto a de vínculo, se houver.

3. Como saber se um DID continua livre?
Caso o campo Data de Vínculo esteja em branco, significa que o DID ainda não foi associado a nenhum circuito.

4. Posso exportar o histórico completo de DIDs cadastrados?
Sim. Através da opção Download CSV, é possível gerar relatórios completos com base nos filtros aplicados.

PCP - Painel de Controle Principal

Relatórios / Dinâmicos

Palavras-chave

relatórios, dinâmicos, personalização, módulos, campos, circuitos

Objetivo

O relatório Relatórios Dinâmicos permite a criação de consultas personalizadas a partir dos módulos disponíveis na plataforma. Seu principal objetivo é dar flexibilidade ao administrador, permitindo selecionar os campos que deseja visualizar e gerar relatórios sob medida, de acordo com a necessidade de análise.

Conteúdo

image.png

Na tela de criação/edição de relatórios dinâmicos, o usuário pode:

Após salvar a configuração, o relatório pode ser consultado a qualquer momento. Os dados são apresentados em formato de lista, permitindo exportação em CSV.

Exemplo:
Na imagem abaixo, foi configurado um relatório dinâmico utilizando o módulo de Circuitos, selecionando os campos Status, Nome e Circuito.

image.png

FAQ – Perguntas Frequentes

1. Qual a diferença entre os relatórios dinâmicos e os relatórios fixos?

2. É possível gerar relatórios dinâmicos de qualquer módulo da plataforma?
Sim, desde que o módulo esteja habilitado para uso nos relatórios dinâmicos.

3. Posso exportar os resultados de um relatório dinâmico?
Sim. Assim como nos relatórios fixos, os resultados podem ser exportados em CSV.

4. O relatório dinâmico salva as configurações criadas?
Sim. Uma vez configurado e salvo, ele pode ser consultado novamente sem necessidade de refazer a configuração.

5. É possível editar um relatório dinâmico já existente?
Sim. O administrador pode editar ou excluir relatórios dinâmicos a qualquer momento.

PCP - Painel de Controle Principal

Relatórios / Geral de Valores

 

Palavras-chave

valores, chamadas, custo, revenda, lucro, conversação, relatórios

 

Objetivo

O relatório Geral de Valores tem como objetivo consolidar as informações de uso da plataforma em um período definido.
Ele apresenta o total de chamadas realizadas, o tempo em conversação, além dos valores de custo (compra), revenda e lucro obtido nas chamadas.

Para que os valores de custo e lucro sejam corretamente calculados, é necessário que o administrador configure previamente os valores cobrados pelas operadoras na aba de custos dos SIP Trunks.

 

Conteúdo

image.png

 

FAQ – Perguntas Frequentes

1. Qual a diferença entre “Tempo em Total” e “Tempo em Conversação”?

2. Por que o relatório mostra “0,00” em valores de custo?
Isso ocorre quando os custos das operadoras não estão cadastrados na configuração dos SIP Trunks.

3. O valor do cliente já considera as regras de planos e tarifas configuradas?
Sim, os cálculos são feitos com base nos planos e tarifas aplicadas ao cliente.

4. É possível exportar este relatório?
Sim, assim como nos demais relatórios, os dados podem ser exportados em formato CSV.

PCP - Painel de Controle Principal

Relatórios / Geral de Valores Detalhado

 

Palavras-chave

valores, chamadas, custo, revenda, lucro, cliente, circuito, plano, DID

 

Objetivo

O relatório Geral de Valores Detalhado apresenta todas as chamadas realizadas em um circuito, a partir de cada DID vinculado.

Através dele, é possível visualizar:

Este relatório é ideal para acompanhar a rentabilidade de cada DID dentro de um circuito e identificar pontos de maior ou menor margem de lucro.

O correto funcionamento depende da configuração dos custos de operadora nos SIP Trunks. Caso não estejam cadastrados, os valores de custo serão exibidos como “0,00”.

 

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. Qual a diferença entre o relatório Geral de Valores e o Geral de Valores Detalhado?

2. Por que alguns valores aparecem zerados?
Isso ocorre quando não há custo cadastrado no SIP Trunk ou quando não há tarifa aplicada.

3. É possível identificar o lucro por cliente neste relatório?
Sim. O campo Valor do Cliente representa o lucro em cada DID/circuito.

4. Como exportar o relatório detalhado?
O relatório pode ser exportado em formato CSV, permitindo análise em planilhas externas.

PCP - Painel de Controle Principal

Relatórios / Ligações

 

Palavras-chave

ligações, chamadas, circuito, origem, destino, duração, valor, detalhamento

 

Objetivo

O relatório Ligações tem como objetivo detalhar todas as chamadas realizadas pelos circuitos em um período definido, apresentando informações como origem, destino, tipo, duração, horários de início e fim, além do valor cobrado pela operadora.

 

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. O que significa "Tipo de ligação"?
É a classificação da chamada conforme a tarifação (VC1, VC2, VC3, Local, etc.).

2. Por que algumas ligações aparecem com valor 0,00?
Isso ocorre quando não há tarifação aplicada.

3. Qual a diferença entre "Mês de referência" e o período de data/hora?
O mês de referência está ligado ao ciclo de faturamento, enquanto as datas exibem o momento exato de início e fim da chamada.

4. Como exportar os dados do relatório?
Utilize o botão Download CSV para baixar todas as chamadas listadas, respeitando os filtros aplicados.

PCP - Painel de Controle Principal

Relatórios / Ligações por Operadora

 

Palavras-chave

ligações, operadora, quantitativo, tráfego, porcentagem

 

Objetivo

O relatório Ligações por Operadora tem como objetivo apresentar a distribuição quantitativa das chamadas realizadas dentro de um período definido, classificando os dados por operadora. Além do número total de ligações, o relatório detalha a quantidade por tipo (fixo e móvel, entrante e sainte) e calcula a representatividade percentual de cada operadora no tráfego geral.

 

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Este relatório mostra valores financeiros?
Não. Ele exibe apenas a quantidade de chamadas processadas por cada operadora, segmentadas por tipo e percentual.

2. É possível identificar a origem e destino das ligações neste relatório?
Não. Para este detalhamento utilize o relatório de Ligações.

3. Para que serve a informação de percentual (%)?
Serve para medir a representatividade de cada operadora dentro do tráfego geral, permitindo identificar as mais utilizadas no período.

PCP - Painel de Controle Principal

Relatórios / Ligações Por Sip Trunks

 

Palavras-chave

ligações, SIP trunk, tronco, origem, destino, custo, revenda, lucro

 

Objetivo

O relatório Ligações por SIP Trunks tem como objetivo apresentar um detalhamento completo das chamadas de saída, destacando o tronco SIP efetivo que completou cada ligação. Além do registro técnico, o relatório evidencia os valores de custo, revenda e lucro por chamada, permitindo a análise financeira individualizada de cada ligação.

 

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Esse relatório mostra apenas chamadas de saída?
Sim, o foco é no detalhamento das chamadas originadas (saída), indicando o tronco efetivo utilizado.

2. Posso usar este relatório para comparar troncos?
Sim, pois cada ligação é associada ao tronco que a completou, facilitando a análise de desempenho por rota.

3. Qual a diferença em relação ao relatório de ligações por operadora?
O relatório por operadora mostra o volume consolidado de chamadas, enquanto o de SIP Trunks detalha cada ligação individualmente, com foco técnico e financeiro.

PCP - Painel de Controle Principal

Relatórios / Minutagem SIP Trunks

Palavras-chave

minutagem, SIP trunk, tempo de ligação, entrada, saída, total

Objetivo

O relatório Minutagem por SIP Trunks apresenta o total de tempo de ligações de entrada e de saída agrupadas por cada tronco SIP. Ele permite acompanhar a utilização de cada tronco, oferecendo uma visão consolidada da minutagem diária e facilitando o gerenciamento de capacidade e custos de tráfego.

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. Este relatório mostra a quantidade de ligações?
Não, ele foca apenas na minutagem (tempo total) de cada tronco, não no número de chamadas.

2. Posso usar este relatório para planejamento de capacidade?
Sim, a consolidação da minutagem por tronco ajuda a identificar quais troncos estão mais demandados, permitindo ajustes de rota e ampliação de capacidade.

3. Há distinção entre ligações tarifadas ou não?
Não, o objetivo é exibir apenas a duração total das chamadas, independentemente de tarifação.

PCP - Painel de Controle Principal

Relatórios / Ocupação de Canais

 

Palavras-chave

canais, ocupação, tráfego, tronco SIP, circuito, pico, monitoramento

 

Objetivo

O relatório Ocupação de Canais tem como objetivo apresentar, em formato gráfico, a quantidade de canais utilizados simultaneamente em um período selecionado. Ele permite identificar horários de pico, avaliar a capacidade dos troncos SIP e circuitos e apoiar decisões de expansão ou ajustes de infraestrutura.

 

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Este relatório mostra chamadas individuais?
Não. Ele apresenta apenas o número de canais simultaneamente ocupados, sem detalhar cada chamada.

2. Posso filtrar por tronco SIP ou circuito específico?
Sim. Os filtros de Tronco SIP e Circuito permitem analisar o uso de recursos de forma segmentada.

3. Como utilizar essas informações para planejamento?
O relatório auxilia a identificar horários de maior tráfego e possíveis gargalos, servindo de base para ampliar troncos ou ajustar a capacidade de canais.

PCP - Painel de Controle Principal

Relatórios / Rentabilidade por Circuitos

Palavras-chave

circuito, cliente, rentabilidade, custo, lucro, chamadas, tempo, mensalidade

Objetivo

O relatório Rentabilidade por Circuitos apresenta, de forma detalhada, a rentabilidade de cada circuito em um período definido. Ele permite avaliar a performance financeira individual, mostrando quantidade de chamadas, tempo total, valores faturados, custos e o lucro obtido, auxiliando na análise de viabilidade e gestão comercial.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. Posso filtrar por cliente ou status do circuito?
Sim, é possível filtrar por cliente, por status (Ativo, Bloqueio Parcial, Bloqueio Total, Cancelado) e por datas específicas.

2. O relatório considera apenas ligações ativas?
Ele contabiliza todas as chamadas efetivamente realizadas e faturadas dentro do período selecionado.

3. Como utilizar este relatório para decisões comerciais?
Com ele, é possível identificar circuitos mais lucrativos ou com baixa utilização, facilitando ajustes de preços, promoções ou desligamentos estratégicos.

PCP - Painel de Controle Principal

Relatórios / Rentabilidade por Revenda

Palavras-chave

revenda, rentabilidade, custo, lucro, ligações, valor total, média, faturamento

Objetivo

O relatório Rentabilidade por Revenda apresenta um panorama financeiro das operações de cada revendedor em um período determinado. Ele consolida dados de chamadas, valores faturados, custos e lucro, permitindo avaliar o desempenho de cada revenda, identificar oportunidades de crescimento e apoiar a tomada de decisões estratégicas.

Conteúdo

image.png

Abaixo, detalhamos todos os campos da interface:

FAQ – Perguntas Frequentes

1. Posso filtrar o relatório por revenda específica ou por período?
Sim, é possível selecionar datas e escolher uma revenda específica para análise.

2. O relatório considera apenas ligações faturadas?
Sim, são contabilizadas apenas as chamadas que geraram valor dentro do período escolhido.

3. Como este relatório ajuda na gestão comercial?
Ele permite comparar o desempenho financeiro de cada revenda, comparando valores e entendendo quais revendas foram mais lucrativas dentro do período selecionado.

PCP - Painel de Controle Principal

Relatórios / Rentabilidade por SIP Trunks

 

Palavras-chave

rentabilidade, SIP trunk, ligações, custo, revenda, lucro, faturamento

 

Objetivo

O relatório Rentabilidade por SIP Trunks apresenta a análise financeira de cada tronco SIP, exibindo o total de chamadas, tempo de conversação, valores de revenda, custo e lucro. Ele permite avaliar a lucratividade de cada tronco SIP individualmente, facilitando o controle de desempenho, a identificação de gargalos e a definição de estratégias de tarifação ou roteamento.

 

Conteúdo

image.png

 

Abaixo, detalhamos os campos exibidos na interface:

 

FAQ – Perguntas Frequentes

1. Posso filtrar por um tronco SIP específico?
Sim, é possível selecionar um ou mais troncos SIP e definir o período desejado.

2. O relatório considera apenas chamadas faturadas?
Sim, apenas chamadas concluídas e contabilizadas financeiramente entram na apuração.

3. Como esse relatório auxilia a gestão?
Ele permite acompanhar a rentabilidade de cada tronco SIP, ajudando na negociação de tarifas e no ajuste de rotas para melhorar margens de lucro.

PCP - Painel de Controle Principal

Relatórios / Resumo por Tipo

 

Palavras-chave

resumo, tipo de ligação, plano, circuito, consumo, faturamento

 

Objetivo

O relatório Resumo por Tipo consolida o tempo de uso e a distribuição das chamadas de cada circuito, agrupadas por tipo de ligação e plano contratado. Ele fornece uma visão global do consumo por categoria (ex.: locais, longa distância, internacional, serviços e variações de tarifa), permitindo analisar o perfil de uso, validar cobranças e auxiliar no planejamento de custos e pacotes de minutos.

 

Conteúdo

image.png

 

Abaixo, detalhamos os campos exibidos na interface:

A linha Total no rodapé soma o tempo de uso de todas as categorias para facilitar a análise global.

 

FAQ – Perguntas Frequentes

1. Posso filtrar por revenda ou referência de fatura?
Sim. O relatório permite selecionar o mês de referência e a revenda desejada para gerar o resumo filtrado.

2. Esse relatório mostra valores financeiros?
Não. Ele foca em tempo e distribuição das chamadas. A parte de custos e faturamento está em relatórios de rentabilidade.

3. Para que serve a divisão por VC1, VC2 e VC3?
Essas colunas ajudam a identificar o volume de chamadas móveis conforme a tarifação por região, útil para análise de planos móveis e acordos de interconexão.

PCP - Painel de Controle Principal

Relatórios / Revenda

 

Palavras-chave

revenda, tempo de utilização, custo, circuito, cliente

 

Objetivo

O relatório Revendas apresenta, de forma consolidada, o tempo de utilização e o custo de cada circuito associado a uma revenda específica. Ele possibilita acompanhar o consumo diário ou por período, facilitando o controle financeiro, a conferência de valores e a análise de uso por circuito dentro de cada revenda.

 

Conteúdo

image.png


Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Posso filtrar por datas específicas?
Sim. Selecione Data Inicial e Data Final para obter o consumo e o custo apenas no intervalo desejado.

2. É possível ver mais de uma revenda ao mesmo tempo?
Sim. No filtro de revenda, seleciona todas para buscar todos os circuitos vinculados a todas as revendas.

3. Posso exportar os dados para controle financeiro?
Sim. Utilize o botão Download CSV para exportar todas as informações e integrá-las a planilhas ou sistemas de faturamento.

PCP - Painel de Controle Principal

Relatórios / Rotas Personalizadas

 

Palavras-chave

Rotas personalizadas, análise de chamadas, tipos de tarifação, LC, LDN, VC1, VC2/VC3, LDI, Softswitch SPX.

 

Objetivo

O relatório de Rotas Personalizadas permite que o administrador visualize e analise, por rota personalizada, a quantidade de chamadas realizadas e atendidas, segmentadas por tipo de tarifação, facilitando o controle de uso e a verificação do desempenho de cada rota.

 

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface:

 

FAQ - Perguntas Frequentes

1. Este relatório mostra a duração das chamadas?
Não. Ele exibe apenas a quantidade de chamadas realizadas e atendidas, separadas por tipo de tarifação.

2. O que significa “Rota Personalizada”?
É uma regra de roteamento criada pelo administrador para direcionar chamadas por critérios específicos (ex.: operadora, custo, região).

3. Posso ver várias rotas ao mesmo tempo?
Sim. Basta deixar o filtro “Rota Personalizada” em Todas.

4. Como salvar os dados para análise externa?
Clique em Download CSV para baixar o arquivo e abrir em planilhas ou sistemas de BI.

PCP - Painel de Controle Principal

Relatórios / Status dos Circuitos

 

Palavras-chave

circuito, status, cliente, bloqueio, ativo, revenda

 

Objetivo

O relatório Status dos Circuitos apresenta uma lista completa de todos os circuitos de uma revenda, exibindo a situação de cada um. Ele é utilizado para verificar rapidamente quais circuitos estão ativos, bloqueados ou excluídos, facilitando o gerenciamento de clientes e a tomada de ações operacionais.

 

Conteúdo

image.png

 

Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Posso exportar os dados?
Sim. Use o botão Download CSV para salvar todas as informações em planilha.

2. É possível filtrar por situação específica?
Sim. Escolha a opção desejada (Ativo, Bloqueado, Excluído) no campo Situação antes de pesquisar.

3. O que acontece quando um circuito é excluído?
Ele permanece listado para histórico, mas não pode mais ser utilizado para ligações.

PCP - Painel de Controle Principal

Relatórios / Tipo de Chamada

 

Palavras-chave

tipo de chamada, SIP trunk, duração, quantidade de ligações, custo, lucro, tarifação.

 

Objetivo

O relatório Tipo de Chamada apresenta um panorama detalhado das ligações agrupadas por categoria, permitindo acompanhar duração total, quantidade de chamadas, custo e lucro de cada tipo. Dessa forma, é possível analisar o desempenho e a rentabilidade de cada modalidade de chamada.

 

Conteúdo

image.png


Abaixo, detalhamos todos os campos da interface:

 

FAQ – Perguntas Frequentes

1. Esse relatório considera todos os troncos SIP?
Sim, é possível selecionar um tronco específico ou visualizar o consolidado de todos.

2. O que significam as siglas LC, LDN, VC1, VC2 e VC3?
Representam as categorias de tarifação: Local, Longa Distância Nacional e faixas de chamadas móveis (VC1, VC2, VC3), além de outros tipos como CNG (chamadas de cõdigo não geográfico) e EMERG (emergência).

3. Posso comparar custo e lucro por tipo de chamada?
Sim. O relatório mostra, para cada tipo, o total de custo e lucro, facilitando a análise de rentabilidade.

PCP - Painel de Controle Principal

Relatórios / STFC SGQ

 

Palavras-chave

STFC, SGQ, Anatel, qualidade, indicadores, minutos, códigos de acesso, telefonia fixa.

 

Resumo / Objetivo

O relatório STFC SGQ  exibe os indicadores exigidos pela Anatel para aferir a qualidade do Serviço Telefônico Fixo Comutado (STFC). Ele consolida dados como quantidade de códigos de acesso, tempo de ligação por tipo de serviço (local, LDN, LDI, etc.) e outros indicadores relacionados à prestação do serviço fixo. O objetivo é fornecer transparência e permitir que operadoras verifiquem se estão alinhadas às metas de qualidade regulatória.

 

Conteúdo

image.png

 

 

Contexto Regulatório (o que é SGQ)

O relatório STFC SGQ refere-se ao Sistema de Gestão da Qualidade ou aos Indicadores de Qualidade do serviço regulados pela Anatel para o STFC. A Anatel exige que prestadoras do STFC divulguem mensalmente os indicadores de desempenho de qualidade (minutos, códigos de acesso, etc) conforme regulamentos aplicáveis. Serviços e Informações do Brasil.

 

FAQ – Perguntas Frequentes

1. Para que serve este relatório?
Para demonstrar o cumprimento dos indicadores de qualidade do STFC exigidos pela Anatel, como códigos de acesso ativos e volumes de tráfego por categoria.

2. Com que periodicidade ele é gerado?
Mensalmente. O usuário seleciona o período (mês/ano) para visualizar ou exportar os dados correspondentes.

3. O que significa “Código SGQ designado”?
Refere-se ao número de códigos de acesso de STFC que foram formalmente atribuídos ou ativados em um período, conforme exigência regulatória.

4. O valor de minutos cursados local / LDN / LDI refere-se ao que exatamente?
Refere-se ao total de minutos trafegados em chamadas de diferentes tipos:
  • Local: chamadas dentro da mesma área local de STFC.
  • LDN: longa distância nacional entre áreas locais diferentes.
  • LDI: ligações internacionais.

PCC - Painel de Controle do Cliente

PCC - Painel de Controle do Cliente

Consultar Fatura

Palavras-chave

faturas, cliente, histórico, pagamentos, siga-me, ACB, painel do assinante

Objetivo

A página Faturas é o portal onde o cliente acessa suas informações de cobrança. Ela permite visualizar a fatura atual, acompanhar o histórico de meses anteriores, baixar arquivos em PDF e ativar funções adicionais de gerenciamento de chamadas.

Conteúdo

faturas.png

Abaixo, detalhamos todos os campos da interface:

Blacklist

A Blacklist permite ao cliente cadastrar números específicos para bloqueio de chamadas de entrada, evitando contatos indesejados ou não autorizados.

 

Números

O menu Números possibilita ao cliente gerenciar seus números DID vinculados, com a opção de habilitar e configurar funções individualmente para cada número:

O número de destino precisa seguir os padrões de discagem das regras de saída do circuito do cliente.

 

Login

As credenciais de login da plataforma são definidas nas configurações do circuito.

Nas opções de Gestão Web de cada circuito, o administrador pode habilitar e controlar quais funcionalidades estarão disponíveis para o cliente no painel de faturas, permitindo o gerenciamento das configurações diretamente pelo usuário final.

 

image.png

image.png

 

 

FAQ – Perguntas Frequentes

1. Posso baixar todas as faturas em um único arquivo?
Não, cada fatura deve ser baixada individualmente em PDF.

2. O gráfico mensal mostra valores ou quantidade de ligações?
Ele exibe a quantidade de ligações por tipo, facilitando o acompanhamento de consumo.

3. É possível alterar as credenciais de login?
Sim, utilize a opção de alteração de senha disponível após o login ou entre em contato com o suporte da operadora.

4. Essas funções extras geram custo adicional?
Depende do plano contratado. Em caso de dúvida, consulte sua operadora.

Console

Console

Acesso via console

Palavras-chave

Console, SSH, terminal, comandos, administração, rede, diagnóstico, SaperX.

 

Objetivo

Fornecer uma visão geral do acesso à console SSH personalizada da SaperX e apresentar os comandos disponíveis para administração, diagnóstico e monitoramento do sistema.

Conteúdo

image.png

 

Acesso e Autenticação

O acesso ao Console SaperX é feito por SSH e utiliza um terminal personalizado.

Por questões de segurança, a conta de administrador é destinada apenas a operações avançadas e não deve ser compartilhada.
Para ter acesso, solicite ao time de suporte as credenciais e a porta de conexão.

 

Navegação de Diretórios e Comandos

A navegação dentro do Console SaperX é feita por comandos simples, semelhantes a um menu em árvore:

network

A sessão Network do Console SaperX reúne comandos para diagnóstico e monitoramento de rede, permitindo verificar conectividade, interfaces, rotas e realizar testes.

Para consultar rapidamente os comandos disponíveis dentro de Network, basta digitar ?.

 

firewall

A sessão Firewall do Console SaperX reúne comandos para gerenciamento do firewall e do serviço Fail2ban, permitindo iniciar, parar, recarregar e visualizar o status da proteção.

Para consultar rapidamente os comandos disponíveis dentro de firewall, basta digitar ?.

serverstatus

A sessão serverstatus do Console SaperX exibe informações em tempo real sobre o desempenho e a saúde do servidor, permitindo monitorar componentes essenciais do sistema.

Comandos disponíveis:

Para consultar rapidamente os comandos disponíveis dentro de serverstatus, basta digitar ?.

sip

A sessão sip do Console SaperX concentra comandos para monitorar e diagnosticar o funcionamento do protocolo SIP, permitindo visualizar registros, peers, chamadas e fluxos em tempo real.

Comandos disponíveis:

Para consultar rapidamente os comandos disponíveis dentro de sip, basta digitar ?.

Outros comandos a console



FAQ – Perguntas Frequentes

1. O que é o Console SaperX?
É um terminal SSH personalizado que permite executar comandos de administração, diagnóstico e monitoramento diretamente no servidor SaperX.

2. Como obtenho acesso ao Console SaperX?
O acesso de administrador é desabilitado por padrão. Solicite ao time de suporte SaperX a liberação e as credenciais necessárias, incluindo usuário, senha e porta de conexão.

3. Quais são os comandos básicos de navegação?

4. Para que serve a sessão network?
Permite diagnosticar a rede: testar conectividade (ping, pingcount), exibir rotas (routeshow), ver interfaces (ifconfig) e rastrear rotas (traceroute).

5. O que posso fazer na sessão firewall?
Gerenciar o firewall e o Fail2ban: iniciar/parar, recarregar regras, exibir regras ativas ou resetar bloqueios.

6. Como monitorar o status do servidor em tempo real?
Use a sessão serverstatus para ver CPU (load), memória, uso de disco, uptime, status do MySQL e do Asterisk.

7. Quais comandos ajudam a acompanhar chamadas SIP?
Na sessão sip é possível listar registros e peers, ver chamadas em tempo real (realtime), capturar tráfego (sipdump) e analisar fluxos com sngrep, sngreprtp e sngrepfull.

8. Posso verificar a versão do sistema?
Sim. O comando version exibe a versão atual do software SaperX em execução.

9. Como desligar ou cancelar o desligamento do servidor?

10. Como encerrar a sessão do Console?
Digite exit em qualquer nível para retornar ou encerrar completamente a conexão SSH.

Painel Opera

Painel Opera

Produtos


Palavras-chave

portal opera, produtos, acesso ao sistema, seleção de produto, login, identificação do cliente, código de acesso, ip de origem

 

Objetivo

A página Produtos é o ponto inicial de acesso ao Portal Opera. Sua função é permitir que o administrador selecione qual produto estará utilizando dentro do ambiente, além de exibir informações importantes de identificação do cliente para suporte e segurança.

 

Conteúdo

Ao realizar o login no Portal Opera, o usuário é automaticamente direcionado para a página de Produtos. Essa tela apresenta de forma simples e objetiva todos os produtos disponíveis para aquele usuário, permitindo o acesso ao ambiente desejado com apenas um clique.

image.png


Cada cartão exibido na tela representa um produto habilitado, como por exemplo:

Ao clicar sobre um dos produtos, o usuário será redirecionado para o painel de controle principal correspondente, já autenticado e com suas permissões aplicadas.

 

Estrutura da Página

Menu Lateral
No lado esquerdo da tela está localizado o menu principal do Portal Opera, com acesso às seguintes funcionalidades:

 

Código de Acesso do Produto

Abaixo do botão Sair, no canto inferior esquerdo da tela, são exibidas informações importantes de identificação do cliente:

image.png

O Código de Acesso é um identificador único do cliente e deve ser informado sempre que um atendimento for iniciado através dos canais oficiais de suporte, como:

Esse código é utilizado para validar a identidade do cliente e proteger contra tentativas de fraude ou acesso não autorizado, garantindo maior segurança no atendimento.

FAQ – Perguntas Frequentes

1. Para que serve a tela de Produtos?
Ela permite selecionar qual produto o administrador deseja acessar dentro do Portal Opera.

2. Posso ter acesso a mais de um produto?
Sim. A quantidade de produtos exibidos depende das permissões e contratos associados ao usuário.

3. Onde encontro o código de acesso para suporte?
O código de acesso fica localizado abaixo do botão Sair, no canto inferior esquerdo da tela.

4. Por que o código de acesso é solicitado pelo suporte?
Ele serve para identificar o cliente e garantir a segurança do atendimento, evitando fraudes.

5. O IP exibido na tela tem alguma função?
Sim. O IP indica a origem da conexão do cliente e auxilia em validações de segurança e auditoria.

Painel Opera

Chamados

 

Palavras-chave

chamados, suporte técnico, atendimento, solicitações, melhorias, incidentes, interações, sla, prioridade, status

 

Objetivo

A funcionalidade Chamados permite que o administrador registre, acompanhe e interaja com solicitações junto ao time de suporte da SaperX. Por meio dela, é possível centralizar incidentes, dúvidas, solicitações técnicas e pedidos de melhoria relacionados aos produtos contratados.

 

Conteúdo

A página de Chamados apresenta uma visão geral de todas as solicitações abertas pelo cliente, permitindo acompanhar o andamento, status, responsável e histórico de interações.

image.png

Nesta tela, o usuário pode:

 

Lista de Chamados

A lista de chamados exibe todas as solicitações registradas no portal, organizadas em formato de tabela.

 

Detalhes do Chamado

Ao clicar sobre um chamado da lista, o usuário é direcionado para a tela de detalhamento, onde é possível acompanhar todas as informações e interações relacionadas à solicitação.

image.png

 

No topo da tela são exibidos os principais dados do chamado:

 

A seção Últimas Interações exibe todo o histórico de comunicação entre o cliente e a equipe da SaperX. Cada interação contém:

 

FAQ – Perguntas Frequentes

1. Posso abrir um chamado para qualquer produto?
Sim. O chamado deve ser vinculado a um dos produtos disponíveis para o seu usuário.

2. O que significa quando o chamado está como “Encaminhado”?
Indica que o chamado foi direcionado para outra equipe, como Desenvolvimento, para análise mais aprofundada.

3. Chamados de melhoria são atendidos da mesma forma que incidentes?
Não necessariamente. Chamados classificados como melhoria passam por um processo de análise, aprovação e priorização antes de serem incorporados ao roadmap.

4. Consigo acompanhar todo o histórico do chamado?
Sim. Todas as interações ficam registradas na seção de interações do chamado.

5. Posso responder a um chamado já aberto?
Sim. Utilize a opção Nova Interação para continuar a comunicação dentro do chamado.

Painel Opera

Relatórios / Posições

 

Palavras-chave

relatórios, posições, ramais, circuitos, pabx, softswitch, quantidade de posições, capacidade do sistema

 

Objetivo

O relatório de Posições tem como objetivo apresentar a quantidade total de posições cadastradas na plataforma, permitindo ao administrador acompanhar de forma simples a capacidade configurada no sistema.

 

Conteúdo

A página de Relatórios – Posições apresenta um gráfico simples que demonstra a evolução da quantidade de posições cadastradas ao longo do período selecionado.

image.png

 

Esse relatório é utilizado principalmente para:

 

Gráfico de Posições

O gráfico exibe a quantidade total de posições cadastradas por dia dentro do período selecionado.

FAQ – Perguntas Frequentes

1. O que são posições neste relatório?
Posições representam os recursos cadastrados no sistema, sendo ramais para PABX ou circuitos para Softswitch.

2. Este relatório mostra chamadas ou consumo?
Não. O relatório de posições mostra apenas a quantidade total de posições cadastradas, sem informações de tráfego.

3. Posso alterar o período de visualização?
Sim. Basta selecionar o mês desejado no filtro de período e clicar em Filtrar.

4. Por que o valor aparece igual em todos os dias?
Isso ocorre quando não houve alteração na quantidade de ramais ou circuitos durante o período selecionado.

5. Este relatório impacta faturamento?
O relatório é informativo. A relação com faturamento depende do modelo de contrato firmado com o cliente.

Painel Opera

Relatórios / Chamados

 

Palavras-chave

relatórios, chamados, tickets, suporte, chamados abertos, produtos, atendimento, indicadores

 

Objetivo

O Relatório de Chamados tem como objetivo apresentar a quantidade de chamados abertos, agrupados por produto, permitindo ao administrador acompanhar o volume de solicitações relacionadas a cada ambiente contratado.

Esse relatório auxilia na análise de demanda de suporte e no acompanhamento da utilização dos serviços por produto.

 

Conteúdo

A página de Relatórios – Chamados apresenta um gráfico simples que demonstra a quantidade de chamados abertos para cada produto dentro do período selecionado.

image.png

 

Este relatório é indicado para:

 

FAQ – Perguntas Frequentes

1. O que este relatório contabiliza?
Ele contabiliza a quantidade de chamados abertos, agrupados por produto.

2. O relatório considera chamados fechados?
Não. O relatório apresenta apenas chamados abertos no período selecionado.

3. Posso visualizar os chamados individualmente a partir deste relatório?
Não diretamente. Para visualizar os detalhes dos chamados, utilize a funcionalidade Chamados no menu principal.

4. É possível alterar o período do relatório?
Sim. Basta selecionar o mês desejado no filtro de período e clicar em Filtrar.

5. Este relatório substitui a lista de chamados?
Não. Ele é um relatório gerencial e não substitui a listagem detalhada de chamados.