Integração de Telefonia Móvel - Bora MVNO
Introdução
A Bora MVNO é uma empresa brasileira de telecomunicações que oferece soluções de telefonia móvel e dados para provedores regionais de internet, atuando como uma operadora móvel virtual (MVNO). Tem a proposta de reinventar o modelo de MVNO no Brasil através de simplicidade, transparência e competitividade nas ofertas.
- Este documento descreve o processo de integração entre a plataforma MVNO Bora MVNO e o Sistema IXC Provedor.
- O objetivo é centralizar o gerenciamento de serviços de banda larga e telefonia móvel em uma única plataforma.
- A integração visa simplificar a gestão de clientes, contratos, inadimplência e processos de ativação/manutenção.
Entrega de Valor
- Unificação do gerenciamento de banda larga e telefonia móvel
- Simplificação de processos operacionais
- Melhoria na gestão de inadimplência
- Ampliação da oferta de serviços de telecomunicações
Configuração da Integração
Passo 1: Cadastro da Integração
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma Bora MVNO.
Acesse o formulário de Integrações MVNO Telefonia Móvel através do caminho: Configurações > Integrações > Integração MVNO/Telefonia Móvel.
Pressione o botão Novo.
Selecione Bora MVNO no campo MVNA.
Insira as informações necessárias para a comunicação com a plataforma:
- Login: Insira o login fornecido pela plataforma.
- Senha: Insira a senha de acesso fornecida pela plataforma.
Clique em Salvar para concluir o cadastro da integração.
Ao salvar a integração, se os dados estiverem corretos, um token de autenticação será gerado.
Passo 2: Configuração do Produto de Telefonia Móvel (MVNO)
O cadastro do produto de MVNO é essencial para a gestão do produto no contrato, faturamento e também para permitir a ativação da linha MVNO pois o produto se relaciona com a integração pelos pacotes disponibilizados pela plataforma.
O cadastro do produto no sistema é respectivo ao pacote disponível na plataforma.
Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastros > Produtos.
Clique no botão Novo.
Preencha os campos obrigatórios na aba Produtos e na aba Planejamento.
Acesse a aba Telefonia Móvel.
Clique em Novo para relacionar aos pacotes de telefonia móvel.
No campo ID Integração, selecione a integração cadastrada. Preencha os demais campos:
- ID Plano integração: clique em Buscar plano integração para buscar os planos da plataforma. Selecione o plano conforme disponível e vincule ao campo.
- ID Produto IXC: preenchido automaticamente com o ID do produto que está sendo cadastrado.
- Tipo referência: marque a opção Contrato.
- Ativo: marque a opção Sim.
Clique em Salvar para validar e finalizar o cadastro do produto.
Passo 3: Produto no Contrato
Para realizar a gestão do contrato associado ao serviço de telefonia móvel, é necessário vincular o produto de MVNO ao contrato. Esta ação permite realizar a geração do faturamento, emitir notas fiscais e também efetuar ativação da linha associada à integração. Esta ativação pode ocorrer diretamente pelo contrato ou por Planos de Venda.
- Acesse o Contrato do Cliente através do caminho: Sistema > Cadastros > Contratos.
- Pressione o botão Editar para acessar o contrato.
- Navegue até a aba Produtos e clique no botão Novo.
- Defina o tipo do produto como MVNO/Telefonia Móvel.
- No campo Produto/Serviço, clique na lupa e selecione o produto de MVNO cadastrado.
- Clique em Salvar para validar as configurações.
O campo Tipo precisa, obrigatoriamente, estar marcado como MVNO/Telefonia móvel para a usabilidade da integração não sofrer inconsistências e apresentar o funcionamento adequado.
Passo 4: Cadastro e Ativação da Linha MVNO
A ativação do da linha MVNO consiste em realizar a ativação de um novo número ou solicitar a portabilidade de uma operadora para a Bora MVNO.
Ao criar uma linha MVNO, um assinante é criado na plataforma automaticamente.
A plataforma Bora MVNO valida os seguintes dados para a ativação de um assinante:
- Nome/Razão social;
- Endereço de e-mail;
- CPF/CNPJ;
- Data de nascimento (quando pessoa física);
- Data de fundação (quando pessoa jurídica);
- Endereço (campos CEP, Endereço, Número, Complemento).
Atente-se ao cadastro do cliente para que todos estes dados estejam devidamente preenchidos.
4.1: Ativação de número novo
Ainda no contrato do cliente, navegue até a aba Linha MVNO;
Clique no botão Novo e preencha os campos apresentados:
API: selecione a opção Alterar na API e no IXC. Saiba mais em: Parâmetro API.
ID Integração: selecione o ID da integração da plataforma Bora MVNO.
Produto relacionado: insira o produto IXC/MVNO cadastrado em Produtos, no contrato do cliente.
eSIM (chip virtual):
- Sim: marque sim se a linha utilizará um chip virtual. Após salvar a linha, um link será gerado com o QRCode de ativação.
- Não: marque não para definir que a linha utilizará um chip físico.
SIM Card: caso a linha utilize eSIM, clique em Buscar SIM Card e selecione o número que será relacionado à linha. Se não, digite o SIM Card.
Portabilidade: mantenha o campo selecionado na opção não.
DDD: insira o DDD da linha que está sendo ativada.
Após informar todos os campos, clique em Salvar.
Campos preenchidos automaticamente:
- Cliente MVNO: preenchido automaticamente com o ID da linha na plataforma.
- Número de telefone: número de telefone do cliente. É preenchido automaticamente com o retorno da plataforma.
- Link eSIM: se a linha for do tipo eSIM, após salvá-la, um link com o QRCode será gerado. Para ativar a linha, o aparelho celular que for utilizado deve realizar a leitura do QRCode.
4.2: Ativação de portabilidade número novo
Este tipo de ativação envolve a portabilidade de um número de outra operadora para a Bora MVNO.
Ainda no contrato do cliente, navegue até a aba Linha MVNO;
Clique no botão Novo e preencha os campos apresentados:
API: selecione a opção Alterar na API e no IXC. Saiba mais em: Parâmetro API.
ID Integração: selecione o ID da integração da plataforma Bora MVNO.
Produto relacionado: insira o produto IXC/MVNO cadastrado em Produtos, no contrato do cliente.
eSIM (chip virtual):
- Sim: marque sim se a linha utilizará um chip virtual. Após salvar a linha, um link será gerado com o QRCode de ativação.
- Não: marque não para definir que a linha utilizará um chip físico.
SIM Card: caso a linha utilize eSIM, clique em Buscar SIM Card e selecione o número que será relacionado à linha. Se não, digite o SIM Card.
Portabilidade: marque sim.
DDD: insira o DDD da linha que está sendo ativada.
Número de telefone: insira o número de telefone atual do cliente, sem o DDD.
Após informar todos os campos, clique em Salvar.
Campos preenchidos automaticamente:
- Cliente MVNO: preenchido automaticamente com o ID da linha na plataforma.
- Número temporário: indicará o número de telefone provisório a ser usado pelo cliente até o processo de portabilidade ser concluído. Após a ativação da linha, o número temporário é desativado e o cliente passa a usar somente o número portado.
- Link eSIM: se a linha for do tipo eSIM, após salvá-la, um link com o QRCode será gerado. Para ativar a linha, o aparelho celular que for utilizado deve realizar a leitura do QRCode.
A linha assumirá o status de Aguardando ativação.
Se necessário, para atualizar os dados da portabilidade, realize a consulta manual do status através do botão Consultar portabilidade, no cadastro da linha MVNO (necessário aguardar a aprovação da plataforma para a alteração do status e ativação definitiva).
Este método de ativação consiste na portabilidade de um número que já está ativo na Bora MVNO e o titular da linha deseja portar outro número para esta linha. Este processo pode ser realizado no IXC Provedor através do fluxo padrão de portabilidade.
O que é um eSIM?
O eSIM é um chip virtual que substitui chips físicos, promovendo maior segurança, flexibilidade e sustentabilidade, ao reduzir significativamente o uso de plástico. Ele é integrado diretamente no aparelho compatível - a verificação de compatibilidade deve ser feita junto à plataforma MVNO contratada.
Após realizar a ação de todos os passos, a linha estará pronta para uso.
Em casos de portabilidade a linha ficará com status Aguardando ativação até que o processo seja concluído. O status é alterado pela Tarefa - Consultar Portabilidade ou então a partir da Consulta manual de portabilidade - MVNO.
Após solicitar a portabilidade, existe um período de até 3 dias úteis para o processo ser concluído e a portabilidade ser aceita ou recusada.
Se a portabilidade for aceita, o campo Número temporário serve apenas como informativo. O número que o cliente passa a utilizar definitivamente é o informado no campo Número de Telefone
Após salvar a linha MVNO e editá-la, não será possível alterar o campo Integração. Este será exibido somente como visualização. Demais campos disponíveis podem ser editados, exceto a integração original com a qual a linha foi criada.
Casos de Uso
1. Controle de Acesso pelas Ações do Contrato
É possível realizar o gerenciamento do status da linha através do status do contrato. Isto significa que toda ação realizada no status do contrato e status de acesso irá refletir no status e no consumo da linha. Situações como suspensão temporária e liberação automática após pagamento, por exemplo, compreendem a alteração do status do contrato e, portanto, refletem os tatus da linha.
Confira, abaixo, a relação entre os status de contrato/acesso e como impactam o consumo de uma linha Bora MVNO:
| Status do Contrato | Status de Acesso | Status da Linha MVNO | Ação |
|---|---|---|---|
| Ativo | Ativo | Ativo | Linha ativa e consumindo normalmente |
| Ativo | Bloqueio manual/automático | Bloqueio total | A linha permanece ativa durante o ciclo vigente, porém a renovação do plano é suspensa. Ao final do ciclo, o bloqueio total é efetivado e o cliente perde o acesso ao serviço |
| Ativo | Financeiro em atraso | Ativo | Linha ativa e consumindo normalmente, pois não há bloqueio aplicado à linha no ciclo vigente |
| Pré-contrato | Aguardando assinatura | Ativo | Linha ativa e consumindo normalmente |
| Ativo | Aguardando assinatura | Ativo | Linha ativa e consumindo normalmente |
| Inativo | Desativado | Inativo | Cancela a linha, interrompendo permanentemente a recorrência do plano e impedindo a reativação. O cliente consome até o fim do ciclo de recorrência vigente e então o cancelamento é realizado |
2. Ações da Linha MVNO
Além do status do contrato, a linha permite a alteração manual e individual de status de acesso.
Como alterar status da linha
- Acesse o contrato do cliente;
- Clique na aba Linha MVNO;
- Selecione o botão de Editar;
- Clique sobre o botão Status;
- Selecione a opção de status que deseja aplicar à linha MVNO;
| Ações da Linha | Status da Linha MVNO | Ação |
|---|---|---|
| Liberar linha | Ativo | Permite o consumo da linha |
| Cancelar plano | Inativo | Cancela a recorrência do plano, permitindo a utilização do serviço até o vencimento do ciclo vigente |
| Bloqueio total | Bloqueio total | A linha permanece ativa, mas ocorre a suspensão da renovação do plano, efetivando o bloqueio ao final do ciclo vigente |
O botão Ativar SIMCard é exibido somente para linhas nos status relacionados a bloqueio ou aguardando ativação.
Linhas canceladas (seja pelas ações da própria linha ou pelo cancelamento do contrato) não permitem novas alterações. Nesses casos, o recurso fica automaticamente indisponível (oculto no sistema).
Se for necessário reutilizar o SIMCard vinculado a uma linha cancelada, é preciso criar uma nova linha usando os mesmos dados (desde que a anterior esteja devidamente cancelada).
3. Detalhamento da Linha
Uma vez ativa e em consumo, é possível verificar dados específicos de cada linha MVNO Bora. Informações como Dados móveis, Voz e SMS são exibidos no relatório. Para emiti-lo, siga as etapas a seguir:
Acesse o formulário de Linha MVNO através do contrato do cliente, seguindo o caminho: Sistema > Cadastros > Contratos;
Clique na aba Linha MVNO;
Selecione a linha da qual deseja consultar os dados e clique em Editar;
Em seguida, clique no botão Detalhamento da linha. O sistema emitirá um relatório contendo os principais dados, divididos em duas seções: Saldo disponível e Histórico da linha.
Seção Saldo disponível:
- Dados móveis;
- Voz;
- SMS.
Seção Histórico da linha
- Data da expiração dos dados.
Fluxo de Trabalho
Considerações Finais
A integração entre a plataforma Bora MVNO e o sistema proporciona uma solução completa para o gerenciamento de serviços de telecomunicações. Esta integração resulta em operações mais eficientes e uma experiência aprimorada para o cliente. É fundamental estar a par das diretrizes de utilização e eventuais atualizações da plataforma integrada, garantindo assim o máximo aproveitamento das funcionalidades oferecidas.