Central de Ajuda Quaza Provedores

Telefonia (PT)

Telefonia — Quaza

A Telefonia do Quaza concentra a gestão dos serviços de voz que você vende aos seus clientes: a conexão com a operadora (gateway), os planos de voz com minutos e tarifas, os números de telefone (DID), os usuários de telefonia fixa/VoIP, os cartões SIM e usuários móveis (MVNO), e o faturamento das chamadas. Esta página é o guia operacional do módulo para o operador e o técnico do provedor.

Nesta wiki:

Quando usar a Telefonia (e quando NÃO)

Use a Telefonia quando...	NÃO é o lugar quando...
O provedor revende voz fixa/VoIP (ramais, números DID) ou linha móvel (chip MVNO) e precisa cobrar as chamadas pelo Quaza.	Você quer apenas consultar saldo e chamadas de uma plataforma VoIP externa (MOR) sem operar a tarifação no Quaza — veja VoIP.Mor .
Você precisa cadastrar planos de voz, importar números e usuários da operadora e gerar a cobrança mensal das chamadas.	Você quer configurar blocos de IP, perfis de acesso ou os detalhes técnicos de rede — veja Rede .
Você gerencia o ciclo de um chip móvel: ativar, trocar plano/número, bloquear, cancelar e portabilidade.	O cliente não tem serviço de voz contratado — então nada aqui se aplica a ele.

Telefonia fixa/VoIP x móvel (MVNO). O módulo atende dois mundos. Na telefonia fixa/VoIP você trabalha com números (DID), usuários e o extrato de chamadas (CDR). Na telefonia móvel (MVNO) você trabalha com cartões SIM, usuários móveis e números móveis. Qual aparece depende do gateway que você escolher no Integrador.

Passo a passo — do gateway ao primeiro número ativo

Sequência mínima para colocar a telefonia fixa/VoIP em funcionamento. Cada passo abre uma tela do menu Telefonia.

1	Cadastre o Integrador. Escolha a operadora (gateway), informe os dados de conexão (endereço, usuário e senha) e os parâmetros de cobrança. É a ponte entre o Quaza e a operadora.
2	Importe os planos. Na tela Plano, clique em Importar Planos e selecione o integrador. Os planos vêm prontos da operadora; você só ajusta valor e serviço.
3	Importe os grupos (quando a operadora usa grupos). Na tela Grupo, clique em Importar Grupos.
4	Importe os números. Na tela Número, clique em Importar Números. São os números (DID) disponíveis na operadora para distribuir aos clientes.
5	Cadastre o usuário. Na tela Usuário, clique em Adicionar usuário, escolha o integrador, vincule o cliente/contrato e defina usuário, senha, plano e grupo.
6	Vincule um número ao usuário. Ainda dentro do usuário, adicione um número disponível da cidade. O número passa a pertencer àquele usuário.
7	As chamadas entram sozinhas. O sistema importa o extrato de chamadas (CDR) da operadora periodicamente. Você acompanha em Extrato CDR.
8	Fature. No fim do ciclo (dia de corte/faturamento do integrador) o sistema gera o Faturamento por usuário; você confere e gera a venda para o contrato.

Para telefonia móvel (MVNO) o caminho muda a partir do passo 4: em vez de Número/Usuário fixos, você importa Cartão SIM, cadastra Usuário (MVNO) e ativa o chip. Detalhes na seção Cartão SIM, Usuário e Número (MVNO) .

Fluxo geral — da chamada ao faturamento

Da disponibilização na operadora até a cobrança no contrato. Os passos 5 e 6 acontecem manualmente (botão Importar) ou por tarefa automática.

Glossário

Termo	O que significa
Gateway	A operadora/plataforma de voz com a qual o Quaza se integra (por exemplo Tip, Magnus Billing, SaperX, Summit na voz fixa; Bora, Brazmóvel, Gertel, Tá Telecom, DryTelecom na telefonia móvel). Cada Integrador usa um gateway.
Integrador	O cadastro no Quaza que guarda os dados de conexão com um gateway e as regras de cobrança daquela operadora.
DID / Número	O número de telefone que o provedor distribui ao cliente. Vem da operadora e é vinculado a um usuário.
Usuário (telefonia)	O ramal/conta de voz de um cliente. Liga o número, o plano e o contrato. Na voz fixa tem usuário e senha; na MVNO está ligado ao chip.
Plano de telefonia	A franquia de minutos e as tarifas por tipo de chamada que regem quanto o cliente paga.
CDR (Extrato de chamadas)	O registro detalhado de cada chamada (origem, destino, duração, valor). É a base do faturamento.
MVNO	Operadora móvel virtual. É a telefonia móvel (chip/SIM) que o provedor revende usando a rede de uma operadora real.
Cartão SIM	O chip móvel. Tem um ICCID e percorre estados como Disponível, Ativo, Bloqueado e Cancelado.
ICCID	O número único impresso no chip que o identifica na operadora.
Portabilidade	Trazer um número de outra operadora para o chip ativado aqui, mantendo o número do cliente.
Grupo de telefonia	Um agrupamento de usuários na operadora (por exemplo equipe comercial, suporte). Importado da operadora.
DDI / DDD	Código do país (DDI, ex. 55) e código de área (DDD) usados na numeração. Ficam no Integrador.
LC, LDN, LDI, VC1, VC2, VC3	Tipos de chamada usados nas franquias e tarifas: LC = local, LDN = longa distância nacional, LDI = internacional, VC1/VC2/VC3 = chamadas para móvel (local, regional, nacional).
Cadência	Como a chamada é cobrada por tempo, no formato início/intervalo (ex. 3/30/6). Vem da operadora.

Configuração e pré-requisitos

Antes de cadastrar usuários e números, prepare a base. Cada item abaixo é um pré-requisito do passo a passo.

Acesso à operadoraTelefonia → Integrador

Você precisa dos dados de conexão que a operadora fornece (endereço, usuário e senha de integração). Sem eles o Quaza não consegue importar planos, números nem chamadas.

Serviço no contratoCadastro do serviço cobrado no contrato

O Integrador pede um Serviço padrão e cada plano pode apontar um Serviço. É o item que aparece na cobrança do cliente. Defina-o antes de gerar vendas.

Contrato do clienteCliente → Contrato

O usuário de telefonia se vincula a um cliente e a um contrato. O cliente precisa ter contrato ativo para receber a cobrança das chamadas.

Forma de pagamento e tipo de vendaFinanceiro

Para gerar a venda do faturamento, o sistema pede um tipo de venda e uma forma de pagamento já cadastrados e ativos.

Integrador — a conexão com a operadora

É o primeiro cadastro do módulo. Define com qual operadora o Quaza fala e como cobra. Tudo (planos, números, usuários, chamadas) pertence a um integrador.

Telefonia → Integrador

Listagem de integradores: cada linha e uma operadora com seu gateway (aqui, Tip para voz fixa e Brazmovel para movel) e a licenca padrao.

Campos principais

Campo	Para que serve
Descrição	Um nome amigável para identificar a integração (ex. "VoIP Principal", "MVNO Brazmóvel").
Gateway	A operadora/plataforma. A escolha aqui decide se esta integração é de voz fixa ou móvel e quais campos de conexão aparecem.
Situação	Ativa ou desativa a integração.
Código do País (DDI) / Código de Área (DDD)	Numeração usada pela operadora. O DDI já vem preenchido como 55.
Licença Padrão	O tipo de licença de voz aplicado por padrão (definido pela operadora).
Serviço padrão	O serviço do contrato usado na cobrança quando o plano não indica outro.
Dia de corte / Dia de Faturamento	Quando o ciclo fecha e quando a cobrança é gerada.
Valor de Faturamento / Gerar cobranças	Valor base e se o faturamento deve gerar cobrança automática no financeiro.
Dados de conexão (endereço, usuário, senha)	As credenciais da operadora. Variam conforme o gateway escolhido — o formulário mostra só o que aquele gateway usa. As senhas ficam ocultas.

Testar conexão. Ao editar um integrador que usa conexão por API ou por transferência de arquivos, aparecem botões para Testar conexão. Use-os para confirmar que as credenciais estão corretas antes de importar qualquer coisa.

Plano de telefonia — minutos e tarifas

O plano define a franquia de minutos e a tarifa por tipo de chamada. Os planos vêm da operadora: você os importa e depois ajusta valor e serviço — não se cria um plano do zero.

Telefonia → Plano

Listagem de planos importados, com a operadora (Integrador) de origem e se o plano e ilimitado.

O que você edita no plano

Campo	Significado
Descrição	Nome do plano (vem da operadora; em alguns gateways pode ser ajustado).
Ilimitado	Indica se o plano não tem limite de minutos.
Valor padrão	O valor base do plano usado na cobrança.
Serviço	O item do contrato que vai aparecer na cobrança do cliente.
Minutos Franquia (LC, LDN, LDI, VC1, VC2, VC3)	Quantos minutos de cada tipo de chamada estão inclusos no plano.
Tarifa (LC, LDN, LDI, VC1, VC2, VC3)	Quanto custa o minuto excedente de cada tipo.
Cadência (LC, LDN, ...)	Como o tempo é cobrado (ex. 3/30/6). Vem da operadora.
Chamadas a cobrar	Define se as chamadas geram cobrança.

Para importar planos: na listagem clique em Importar Planos, escolha o integrador e confirme. Os planos aparecem na lista; depois abra cada um para ajustar valor e serviço.

Número (DID) e Usuário — telefonia fixa/VoIP

Para gateways de voz fixa/VoIP você trabalha com dois cadastros que andam juntos: o Número (o telefone) e o Usuário (a conta de voz do cliente). Importe os números, cadastre o usuário e vincule um número a ele.

Número

Telefonia → Número

Listagem de numeros (DID): cada numero pertence a um integrador e fica livre ate ser vinculado a um usuario/cliente.

Os números são importados da operadora (botão Importar Números). Para cada número você vê o integrador, o número em si, a cidade, se está portado ou reservado e a data de liberação. O número só passa a ser cobrado quando vinculado a um usuário.

Usuário

Telefonia → Usuário

Listagem de usuarios de voz fixa: cada um liga o cliente/contrato, o(s) numero(s) e o plano.

Ao adicionar um usuário você escolhe o integrador, vincula o cliente e o contrato, define usuário e senha (há um botão para gerar senha aleatória) e escolhe o plano e o grupo. A aba Informações traz opções de bilhetagem e bloqueios por tipo de chamada (cobrar, identificação de chamadas, bloquear LC/LDN/LDI/VC1/VC2/VC3). Depois de salvar, dentro do usuário você vincula um número disponível da cidade do cliente.

Importar usuários existentes. Se os usuários já existem na operadora, use Importar Usuários na listagem em vez de cadastrar um a um.

Cartão SIM, Usuário e Número (MVNO) — telefonia móvel

Para gateways móveis (MVNO) o fluxo muda: em vez de número fixo + usuário, você gerencia cartões SIM, usuários móveis e números móveis. O coração da operação é o Cartão SIM e seus estados.

Cartão SIM

Telefonia → Cartão Sim

Listagem de cartoes SIM (MVNO): cada chip tem ICCID, numero ativo e situacao (aqui, Disponivel).

Os chips são importados da operadora (botão Importar SimCards). Abrindo um chip, os botões disponíveis dependem da situação dele e do que a operadora permite:

#	Botão	Quando aparece	O que faz
1	Ativar SimCard	Chip Inativo	Ativa o chip na operadora, vinculando contrato, plano, DDD e (opcional) número portado.
2	Atualizar dados	Chip ativo/disponível ou com portabilidade em andamento	Sincroniza as informações do chip com a plataforma da operadora.
3	Troca de usuário	Chip ativo/disponível	Transfere o chip para outro usuário móvel.
4	Troca de número	Chip ativo/disponível	Troca o número ativo do chip.
5	Troca de plano	Chip ativo/disponível	Troca o plano do chip.
6	Bloqueio parcial	Chip ativo/disponível	Bloqueia chamadas de voz, SMS e dados, mas o usuário ainda recebe chamadas e SMS.
7	Bloqueio total	Chip ativo/disponível	Bloqueia todos os serviços do chip.
8	Desbloquear SimCard	Chip bloqueado (parcial ou total)	Libera os serviços do chip. Não funciona em chip cancelado.
9	Cancelar SimCard / Cancelar plano	Chip ativo/disponível	Cancela o chip (ou o plano, em algumas operadoras).

Estados do cartão SIM: Inativo, Disponível, Ativo, Bloqueado, Bloqueado parcialmente, Cancelado, Suspenso e Pendência financeiro. Na listagem os chips bloqueados aparecem em vermelho, os inativos em amarelo e os cancelados em cinza. A aba Pagamentos só aparece quando a operadora suporta captura de pagamento.

Usuário (MVNO)

Telefonia → Usuário (MVNO)

O usuário móvel liga o contrato do cliente aos chips. Cada contrato tem um único usuário por integrador. Em algumas operadoras (ex. Brazmóvel) o usuário nasce Pré Ativo e precisa ser ativado: você envia um código para o número do cliente e confirma a ativação com o código recebido. Dentro do usuário você vê os chips (SIM) vinculados a ele.

Número (MVNO)

Telefonia → Número (MVNO)

Listagem de numeros moveis (MVNO): numeros importados da operadora, prontos para vincular a um chip/usuario.

Os números móveis também são importados (botão Importar Números) e ficam disponíveis para vincular a um chip/usuário durante a ativação ou pela troca de número.

Grupo de telefonia

Grupos organizam os usuários na operadora (por exemplo "Equipe Comercial", "Suporte Técnico"). Eles vêm da operadora — você os importa (botão Importar Grupos) e depois associa um grupo a cada usuário de voz fixa. Aplica-se aos gateways de voz fixa.

Telefonia → Grupo

Listagem de grupos de telefonia importados da operadora.

Faturamento e Extrato de chamadas

O Faturamento é o fechamento do ciclo: para cada usuário, o sistema soma minutos e valores por tipo de chamada (a partir do extrato CDR), aplica a franquia do plano e chega a um valor total. Você confere e transforma em cobrança.

Telefonia → Faturamento

Listagem de faturamentos por usuario, com a coluna Faturado (Sim/Nao), o mes de referencia e os valores de minutagem e total.

O que você faz em um faturamento

Abrindo um faturamento (que é somente leitura) você vê os minutos e valores por tipo de chamada e o detalhamento das chamadas. Os botões disponíveis:

#	Botão	O que faz
1	Ver usuário / Ver cliente / Ver contrato / Ver débito	Abre os cadastros relacionados ao faturamento.
2	Gerar venda	Aparece quando o faturamento ainda não foi faturado e tem contrato. Cria a venda no contrato do cliente (escolhendo tipo de venda, forma de pagamento e vencimento) e marca como faturado.
3	Marcar como faturado	Marca manualmente como faturado sem gerar venda (quando a cobrança foi tratada por outro caminho).

Faturamento não se cria à mão. Os registros surgem do processamento das chamadas (importação do CDR + cálculo). A tela só permite conferir, gerar a venda e marcar como faturado.

Extrato de chamadas (CDR)

O extrato lista cada chamada individual (início, origem, destino, duração, tipo e valor). Você pode importar o extrato manualmente, filtrar por período e usuário e gerar relatório. Os tipos de chamada seguem o glossário (Local, Nacional, Internacional, Móvel Local/Regional/Nacional, 0800 e Outros).

Tarefas automáticas

Boa parte do trabalho roda sozinho por tarefas agendadas. Cada uma faz uma parte do ciclo. Quem liga, desliga e agenda essas tarefas é o administrador do servidor — a equipe de operação não controla isso por uma tela.

Tarefa	O que faz
Importa CDR	Busca na operadora o extrato de chamadas (CDR) e traz para o Quaza. É o que alimenta o faturamento.
Cria os financeiros do CDR	A partir do extrato, gera os faturamentos/cobranças das chamadas.
Ativação do chip Bora MVNO	Conclui em segundo plano a ativação de chips na operadora Bora (que pode levar alguns minutos).
Captura de pagamento	Processa os pagamentos agendados dos chips, nas operadoras que suportam captura de pagamento.

Manual ou automático. Importar CDR e gerar o faturamento também podem ser feitos na hora pelos botões Importar das telas. As tarefas apenas automatizam o que você faria à mão.

Pegadinhas frequentes

Importar antes de cadastrar. Planos, grupos, números e chips vêm da operadora. Se você tentar cadastrar um usuário sem antes importar planos/números, não terá o que selecionar. Comece sempre pelo Integrador e pelas importações.

O número só cobra quando vinculado. Um número importado fica livre. Ele só entra na conta do cliente depois de ser vinculado a um usuário com contrato.

Testou a conexão? Se a importação "não traz nada", quase sempre é credencial errada no Integrador. Use o botão Testar conexão antes de abrir chamado.

Bloqueio parcial não é bloqueio total. No parcial o cliente ainda recebe chamadas e SMS; só corta voz de saída, SMS de envio e dados. Para cortar tudo, use bloqueio total.

Chip cancelado não desbloqueia. Depois de cancelado (ou com data de cancelamento atingida) o chip não pode ser desbloqueado — é preciso ativar/importar de novo conforme a operadora.

Usuário MVNO pré ativo. Em algumas operadoras o usuário móvel nasce Pré Ativo e só funciona depois da ativação por código enviado ao número do cliente. Sem essa etapa o chip não opera.

Um usuário por contrato no móvel. Cada contrato só pode ter um usuário móvel por integrador. O sistema barra a criação de um segundo.

Faturamento já faturado. Depois de gerar a venda ou marcar como faturado, o registro não gera nova cobrança. Confira antes de marcar.

Cada operadora libera funções diferentes. Nem todo gateway suporta troca de número, portabilidade ou captura de pagamento. Botões indisponíveis para aquela operadora aparecem desabilitados.

Dia de corte x dia de faturamento. São coisas distintas no Integrador: o corte fecha o ciclo de chamadas; o faturamento é quando a cobrança é gerada. Configure os dois.

Perguntas frequentes

Qual a diferença entre esta tela e o VoIP.Mor?

Aqui você opera a telefonia (planos, números, chips, tarifação e cobrança) dentro do Quaza. O VoIP.Mor é uma integração somente para consultar saldo e chamadas de uma plataforma VoIP externa (MOR), sem operar a tarifação por aqui.

Onde fica a telefonia no menu?

No grupo Telefonia, com as telas Integrador, Plano, Número, Usuário, Grupo, Faturamento, Cartão Sim, Usuário (MVNO) e Número (MVNO).

Por onde eu começo?

Sempre pelo Integrador: escolha a operadora e informe a conexão. Depois importe planos, grupos e números e só então cadastre usuários.

Preciso digitar os planos à mão?

Não. Os planos vêm da operadora pelo botão Importar Planos. Você só ajusta valor e serviço de cada um.

Como o cliente passa a ser cobrado pelas chamadas?

As chamadas entram pelo extrato (CDR), o sistema calcula o faturamento por usuário e você gera a venda no contrato. A cobrança segue o fluxo financeiro normal.

Importei o número mas o cliente não consegue usar. Por quê?

Um número importado fica livre. Ele precisa ser vinculado a um usuário (com cliente e contrato) para funcionar e ser cobrado.

Como ativo um chip móvel?

Em Cartão Sim, abra o chip Inativo e clique em Ativar SimCard: escolha contrato, plano e DDD. Em algumas operadoras a ativação é concluída em segundo plano por uma tarefa.

Qual a diferença entre bloqueio parcial e total?

No parcial o cliente ainda recebe chamadas e SMS (corta voz de saída, SMS de envio e dados). No total tudo é bloqueado.

Como faço portabilidade de número?

A portabilidade entra na ativação do chip: informe que o número é portado e o número a ser trazido. Acompanhe a situação de portabilidade do chip (em andamento, aguardando autorização, concluída).

A importação não trouxe nada. O que verificar?

Quase sempre é credencial errada no Integrador. Use o botão Testar conexão. Confirme também se o integrador está com a situação ativa.

Posso ter mais de uma operadora ao mesmo tempo?

Sim. Cadastre um Integrador para cada operadora — por exemplo um para voz fixa e outro para móvel. Planos, números e usuários ficam separados por integrador.

As chamadas são importadas sozinhas?

Sim, por uma tarefa automática (Importa CDR), agendada pelo administrador do servidor. Você também pode importar na hora pelo botão Importar das telas.

Marquei como faturado por engano. Vai cobrar de novo?

Não. Um faturamento já faturado não gera nova cobrança. Verifique sempre antes de marcar ou gerar a venda.

Um botão do chip está desabilitado. Por quê?

Aquela função não é suportada pela operadora do chip (cada gateway libera funções diferentes), ou o chip está em um estado que não permite a ação.

Documentos relacionados

VoIP.Mor — consulta somente leitura de saldo e chamadas de uma plataforma VoIP externa (MOR).
Rede — cadastros de rede (blocos de IP, configurações de acesso) do provedor.
Cobrança — como as vendas geradas pelo faturamento de telefonia viram cobrança para o cliente.