Uma plataforma MVNO é uma operadora de rede móvel virtual que, essencialmente, compra o direito de utilizar parte da infraestrutura oferecida por uma ou mais operadoras móveis. Possibilitando que o usuário utilize várias redes (Vivo, TIM, Claro, etc…) com um único chip.
A integração com a Telecall utiliza a API Partners v2.1 e permite, direto pelo HubSoft:
A partir da versão 1.121, a integração foi migrada para a API Partners v2.1. As integrações já cadastradas foram atualizadas automaticamente, e não é necessário reconfigurar nada. O campo chave deixou de existir.
Para adicionar a integração no sistema, acesse Menu lateral > Configuração > Integrações > MVNO > Adicionar.
Ao clicar em Adicionar, selecione o gateway Telecall.
Os parâmetros disponíveis podem ser consultados clicando no ícone de ajuda (?), no topo da janela.
Preencha os parâmetros:
| Parâmetro | Descrição |
|---|---|
| api_url | URL da API da Telecall. Já vem preenchida com https://api-mvno-v3.telecall.com.br/v2.1. Altere somente se orientado pela Telecall. |
| usuario | Usuário de acesso à API, fornecido pela Telecall. |
| senha | Senha de acesso à API, fornecida pela Telecall. |
| dia_vencimento | Dia de vencimento usado nos planos pós-pagos. A Telecall aceita somente os dias 7, 10, 12, 15, 20 ou 25. Se não preenchido, será utilizado o dia de vencimento do plano do cliente. Também pode ser informado ao adicionar o número. |
| token | Gerado automaticamente. |
| token_expira_em | Gerado automaticamente. O HubSoft renova o token antes de expirar e autentica novamente sozinho quando necessário. |
Há também o parâmetro opcional:
Após configurar a integração, sincronize os planos clicando no botão Sincronizar, pelo menu Ações > Planos, na página da Integração MVNO. Os planos são trazidos do catálogo da Telecall já com o perfil HLR e o tipo da linha (pré-pago ou pós-pago).
Para finalizar a configuração, antes de atribuir o plano ao cliente, marque a opção Serviço Permite MVNO em Configuração > Geral > Serviços / Planos.
Caso essa opção não esteja marcada, o sistema bloqueará qualquer tentativa de adição de planos MVNO ao serviço.
Com a integração e o serviço/plano configurados, vincule os planos MVNO ao cliente em Serviços do Cliente > Outras Opções > Dados MVNO > Adicionar.
Selecione a integração e informe o plano, o DDD, o ICCID e o Número. Os números disponíveis na Telecall para o DDD escolhido são listados para seleção. Após salvar, aguarde a transmissão do número.
O que o sistema confere no cadastro:
Na transmissão, o HubSoft cadastra o cliente, a conta e a linha na Telecall e guarda os identificadores no número. Se a transmissão for repetida, o sistema reconhece a linha já existente e não duplica o cadastro.
Linha recém-ativada: até o primeiro uso, a linha fica em pré-ativação na Telecall. Nesse período, se for necessário bloquear a linha por inadimplência, o HubSoft aplica o bloqueio total e registra no histórico do número.
Para cadastrar/remover a portabilidade, acesse Serviço do cliente > Outras Opções > Dados MVNO > Ações > Portabilidade e marque ou desmarque a opção de portabilidade, conforme necessário.
Requisitos para a portabilidade:
Agendamento automático
O HubSoft agenda a portabilidade sozinho, seguindo as regras da base nacional de portabilidade:
Os feriados nacionais são considerados mesmo que não estejam no cadastro de feriados do provedor.
Status da portabilidade
Após cadastrar, a portabilidade fica com o status aguardando e é enviada à Telecall por uma rotina interna do sistema. A mesma rotina continua consultando a Telecall periodicamente até a portabilidade ser concluída.
| Status no HubSoft | Significado |
|---|---|
| Aguardando | Cadastrada no HubSoft, ainda não enviada à Telecall. |
| Solicitado | Pedido aceito pela Telecall e em andamento na base nacional. Se houver conflito na operadora doadora, o motivo aparece na mensagem. |
| Transmitido – Portabilidade transmitida! | Portabilidade concluída. O número da linha passa a ser o número portado. |
| Transmitido – Portabilidade recusada: … | Pedido recusado. O motivo aparece traduzido, com a orientação do que fazer. |
| Transmitido – Portabilidade cancelada! | Portabilidade cancelada. |
Quando a portabilidade é recusada ou cancelada, é possível solicitar novamente. Se a recusa for por falta de cota na data agendada, o novo pedido é agendado automaticamente para depois dessa data.
O detalhamento de cada consulta fica disponível na guia Status da página de portabilidade e no histórico do número.
Ao apagar o número, ele é colocado na fila de transmissão para cancelamento da linha na Telecall.
Permite alterar o plano atual de um número sem precisar excluí-lo e adicioná-lo novamente. Clique em Ações > Alterar Plano e selecione o novo plano. Após confirmar, o número fica com o status aguardando_cadastro e entra na fila de transmissão. Na Telecall, a troca é aplicada na hora.
Regras da Telecall para a troca de plano:
- o novo plano precisa ter o mesmo perfil HLR do plano atual;
- o novo plano precisa ser do mesmo tipo (pré-pago ou pós-pago). A troca entre pré-pago e pós-pago não é suportada: nesse caso, remova o número e cadastre-o novamente no plano desejado.
Permite trocar o SIM Card atual do número e enviar a alteração para a Telecall, sem remover o número nem gerar cobranças indevidas na plataforma.
Acesse Dados MVNO > Ações > Alterar SIM Card, informe o novo ICCID e clique em Salvar. O número fica com o status aguardando_cadastro até a troca ser concluída na Telecall.
Permite trocar o titular do número, colocando-o na fila de transmissão com o status aguardando_cadastro.
Clique em Ações > Troca de Titularidade, consulte o cliente, identifique o serviço e conclua a alteração.
Atenção:
- Na Telecall, a troca de titularidade encerra a assinatura atual e cria uma nova para o novo titular. Por isso, o consumo da linha é zerado.
- Se o serviço MVNO tiver mais de um número, cadastre a troca para todos os números do serviço.
- O tipo da conta do novo titular (pré-pago ou pós-pago) precisa ser compatível com o plano.
- O número só é migrado para o novo cliente/plano quando a troca é processada pela fila de transmissão.
Pelo menu Ações do número, em Dados MVNO, é possível consultar o consumo da linha mês a mês, separado por franquia do plano:
O mesmo consumo fica disponível para o assinante no app do cliente.
Para linhas com eSIM, o menu Ações do número, em Dados MVNO, exibe o QR Code de ativação do chip, para o cliente instalar o eSIM no aparelho. A consulta é somente leitura.
Para a plataforma Telecall, as ações executadas no HubSoft são enviadas pela fila de transmissão:
Em Relatórios > MVNO está disponível um relatório de serviços que possuem planos de MVNOs cadastrados. Por ele é possível visualizar os erros na transmissão dos dados à plataforma.
Recursos que a integração não oferece:
Abaixo estão as perguntas/problemas frequentes relacionados a MVNO Telecall. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte.
Sim. Se o serviço do cliente que contém os Dados MVNO for suspenso/habilitado no HubSoft, os números são colocados na fila de transmissão para bloqueio/desbloqueio também na Telecall.
Não. A URL da API foi atualizada automaticamente para a v2.1, e o usuário e a senha continuam os mesmos. O campo chave não é mais utilizado.
Confira se o ICCID foi digitado corretamente. Se estiver correto, o SIM Card não está disponível para uso na Telecall (inexistente, já vinculado a outra linha ou inutilizado). Use outro SIM Card ou verifique o estoque com a Telecall.
Nos planos pós-pagos, a Telecall aceita somente os dias 7, 10, 12, 15, 20 ou 25. Ajuste o dia de vencimento no número, na integração ou no plano do cliente.
Sincronize novamente os planos em Integração MVNO > Ações > Planos > Sincronizar.
A Telecall só permite trocar para um plano com o mesmo perfil HLR e do mesmo tipo (pré-pago ou pós-pago). Escolha outro plano ou, para mudar entre pré e pós-pago, remova o número e cadastre-o novamente.
A linha ficou sem plano na Telecall. Abra um chamado na Telecall informando o número.
A base nacional de portabilidade exige no mínimo 3 dias úteis de antecedência e que o horário seja o início de uma janela de portabilidade. O HubSoft escolhe automaticamente a primeira data e janela válidas.
O motivo aparece traduzido na guia Status da portabilidade e no histórico do número. Os mais comuns:
| Motivo exibido | O que fazer |
|---|---|
| O DDD do número portado é diferente do DDD da linha Telecall | Cadastre a linha Telecall no mesmo DDD do número que será portado. |
| O documento informado é diferente do titular do número | O CPF/CNPJ do cliente precisa ser o mesmo do titular na operadora atual. |
| Já existe portabilidade em andamento | Aguarde a conclusão da portabilidade anterior. |
| Não há cota de portabilidade para a data agendada | Solicite de novo: o HubSoft agenda para um dia depois. |
| O horário agendado está fora de uma janela / a data não tem a antecedência mínima | Solicite de novo: o HubSoft escolhe outra data. |
| Não é possível portar para a operadora de origem do número | O cliente deve conferir qual é a operadora atual do número. |
| Há um desligamento em andamento na operadora atual | Aguarde ou oriente o cliente a falar com a operadora atual. |
| A base nacional não concluiu a portabilidade | Solicite de novo e, se persistir, abra um chamado na Telecall. |
O HubSoft move todos os números do serviço para o novo titular, mas na Telecall cada linha muda de dono separadamente. Cadastre a troca de titularidade para todos os números do serviço.
Sim. Na Telecall, a troca de titularidade encerra a assinatura anterior e cria uma nova para o novo titular, com consumo zerado.