Telefonia — Visão geral do módulo
Telefonia — Visão geral do módulo
O módulo Telefonia gerencia dois tipos de serviço: telefonia fixa/VoIP (ramal com número fixo) e MVNO (chip de celular vendido pelo próprio provedor, usando a rede de uma operadora parceira). Os dois funcionam de forma parecida com um serviço SVA: são cadastrados como catálogo e adicionados ao contrato do cliente.
Atenção pra não confundir: existe também uma integração mais antiga chamada "VoIP.Mor", usada por alguns provedores legados — é um sistema separado, mais simples, e não tem relação com o módulo Telefonia moderno descrito aqui. Se o seu provedor usa o VoIP.Mor, esse artigo não se aplica.
As telas principais
-
Integrador — o cadastro do gateway externo que realmente presta o serviço (Summit, TIP, SaperX e Magnus Billing pra telefonia fixa; Tá Telecom, DryTelecom, Bora, Brazmóvel e Gertel pra MVNO). É aqui que ficam a URL da API, credenciais e o dia de faturamento.
-
Número (Fixo) — o número de telefone em si, importado do gateway e vinculado a um Usuário.
-
Usuário (Fixo) — o "ramal" propriamente dito: login/senha no gateway, plano contratado, grupo, bloqueios de chamada (local, DDD, DDI) e vínculo com o contrato do cliente.
-
Plano — a franquia de minutos por tipo de chamada (local, longa distância nacional/internacional) com a tarifa do minuto excedente.
-
Grupo — agrupamento de usuários no gateway (só telefonia fixa).
-
Cartão SIM (Chip) — o chip físico do MVNO. Não confunda com "Número": o chip é o objeto físico (identificado pelo ICCID) que carrega um número, e pode trocar de número numa portabilidade sem precisar trocar de chip.
Como vincular telefonia a um cliente
- Cadastre o Serviço de Telefonia no catálogo (Cliente > Serviço), vinculado ao Integrador correto.
- Adicione esse serviço ao contrato do cliente — no wizard de criação de contrato, o sistema reconhece automaticamente que é um serviço de telefonia e pede os dados extras (fixo ou MVNO, dependendo do integrador escolhido).
- Ao confirmar, o sistema já cria o Usuário (fixo) ou Usuário MVNO vinculado ao contrato.
- Depois de criado, use a tela Telefonia > Usuário pra vincular ou trocar números específicos, se precisar ajustar manualmente.
Ativação de chip MVNO
Diferente do fixo, o MVNO passa por um fluxo de ativação: o chip começa como pré-ativo, o cliente recebe um código por SMS e confirma na tela — só depois disso o chip vira ativo de fato. A tela de Cartão SIM também cobre o ciclo de vida completo: trocar usuário, trocar número (portabilidade), trocar plano, bloqueio parcial/total e cancelamento.
Como funciona a cobrança
A telefonia não é cobrada como um valor fixo igual aos outros serviços do contrato — o valor muda todo mês conforme o consumo. O sistema importa o CDR (extrato de chamadas) do gateway, soma os minutos usados por tipo de chamada, aplica a franquia do plano contratado e cobra o excedente que passou da franquia. Isso tudo cai na mesma fatura/débito do contrato do cliente, junto com internet e outros serviços — não gera uma cobrança separada.