Integração de Telefonia Móvel - Contel (Beta)
Introdução
Atenção!
Este conteúdo está presente na versão Beta do sistema. A disponibilidade desta integração na versão Estável será a partir de Abril de 2025.
O que é a Contel?
A MVNO Contel é uma plataforma que atua no mercado com soluções de tecnologia e conectvidade em telefonia móvel. Por meio da integração do sistema com a plataforma Contel, é possível integrar de maneira eficaz sua operação de telefonia móvel, facilitando o gerenciamento ágil e eficiente de suas linhas.
A funcionalidade Integrações de Telefonia Móvel/MVNO é uma ferramenta essencial para provedores de internet que oferecem telefonia móvel integrada a pacotes de internet. Esse recurso permite a configuração, manutenção e gerenciamento eficiente das conexões entre o sistema da empresa e diversas plataformas de telefonia móvel.
- Este documento descreve o processo de integração entre o MVNO Contel e o Sistema IXC Soft;
- 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.
Acesso à Configuração
Caminho: Configurações > Integrações > Integrações MVNO/telefonia móvel
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 Contel.
- 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 Contel no campo MVNA;
- Insira as informações fornecidas pela Contel no campo:
- Client Secret: serve como uma chave de acesso, permitindo que ocorra a comunicação entre o sistema e a Contel. Insira a senha informada pela plataforma.
- Clique em Salvar para validar a criação da integração e concluir o cadastro;
Campos preenchidos automaticamente: - Token: Gerado automaticamente após salvar a integração, serve como autenticador entre as plataformas, definindo a comunicação adequada entre ambas;
Importante:
As credenciais são essenciais para estabelecer a conexão segura entre os sistemas e são fornecidas pela plataforma credenciada.
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.
Importante:
O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.
- Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastros > Produtos;
- Pressione o botão Novo;
- Preencha os campos obrigatórios na aba Produtos e na aba Planejamento;
- Acesse a aba Telefonia Móvel;
- No campo ID Integração: Selecione a integração cadastrada anteriormente;
- ID Plano integração: Clique em buscar plano integração para buscar os planos da plataforma, selecione o plano respectivo ao produto que está sendo cadastrado;
- ID Produto IXC: O ID do produto criado no sistema para controle do plano de telefonia móvel;
- Tipo referência: Contrato.
- Ativo: marque como Sim;
Atenção:
O ID Plano integração é respectivo à descrição do pacote na plataforma.
- Clique em Salvar para validar e finalizar o cadastro do produto.
Passo 3: Produto no Contrato
Para realizar a gestão do contrato efetivamente, é 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 Formulário Planos de Venda.
- Acesse o Formulário 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” e no campo Produto/Serviço, clique na lupa e selecione o produto de MVNO cadastrado. Clique em Salvar para validar as configurações.
Atenção:
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 numero ou solicitar a portabilidade de uma operadora para a Contel.
Atenção:
Somente é possível realizar o cadastro de uma linha MVNO em contratos que estão com status ativo.
Validação cadastral
A plataforma Contel valida os seguintes dados para a ativação de uma linha MVNO:
- Data de nascimento;
- Nome/Razão social;
- CPF/CNPJ;
- E-mail;
- Telefone celular (com DDD);
- Endereço (campos CEP, Endereço, Número, Complemento).
Atente-se ao cadastro do cliente para que todos estes dados estejam devidamente cadastrados.
4.1: Ativação de número novo
-
Ainda no contrato do cliente, navegue até a Linha MVNO;
-
Clique no botão Novo e preencha os campos apresentados:
- API: Selecione a opção Alterar na API e no IXC;
- Alterar na API e no IXC: ao utilizar essa opção, o sistema promoverá a comunicação entre o IXC Provedor e a plataforma. Toda requisição de alteração na linha MVNO será enviada para a plataforma Contel, garantindo que os dados sejam sincronizados.
- Ignorar API e alterar apenas no IXC: ao utilizar essa opção, o sistema não utilizará a API da Contel, resultando em nenhuma comunicação com ela. Todas as alterações feitas serão refletidas apenas no IXC Provedor, sem afetar a linha MVNO na plataforma MVNO.
- Integração: Clique na lupa e selecione o ID da integração da plataforma Contel;
- Produto relacionado: Deve inserir um produto IXC/MVNO, o qual foi cadastrado em Produtos e que esteja vinculado ao contrato do cliente;
- eSIM (chip virtual):
- Sim: Se marcado como sim, o sistema preencherá os dados de SIM card e número de telefone com o retorno da plataforma, isto é, são dados preenchidos automaticamente a partir do chip virtual. Ao salvar a linha, é feita a ativação do chip virtual na Contel e retornará o link no campo Link eSim para visualizar o QR Code e o cliente finalizar, aceitando a ativação;
- Não: caso esteja marcado como não, os demais campos devem ser preenchidos manualmente.
- SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Caso a linha não seja eSim, preencha manualmente a numeração fornecida;
- Portabilidade: Marque como Não;
- DDD: Inserir DDD para que seja retornado o número do telefone equivalente ao DDD inserido;
- Número do telefone: Este é o número de telefone que ficará vinculado à linha, preenchido automaticamente após salvar a linha;
- ID linha integração: Identificador da linha gerado automaticamente a partir da integração.
- API: Selecione a opção Alterar na API e no IXC;
-
Após informar todos os campos, clique em Salvar.
-
Campos preenchidos automaticamente:
- SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Preenchido automaticamente caso o parâmetro eSim estiver habilitado como sim;
- Número do telefone: Este é o número de telefone que ficará vinculado à linha, preenchido automaticamente após salvar a linha;
- ID linha integração: Identificador da linha gerado automaticamente a partir da integração.
- ID linha integração: ao cadastrar a linha MVNO no IXC, este campo é preenchido como um retorno da plataforma Contel, indicando o ID do cadastro da linha na plataforma;
- Status linha: indica o status de uso da linha;
- Link eSim: Quando a linha cadastrada for uma linha de chip virtual e o parâmetro estiver marcado como sim, este campo será preenchido automaticamente com o link para ativação da linha.
4.2: Ativação de número existente (portabilidade)
- 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;
- Alterar na API e no IXC: ao utilizar essa opção, o sistema promoverá a comunicação entre o IXC Provedor e a plataforma. Toda requisição de alteração na linha MVNO será enviada para a plataforma Contel, garantindo que os dados sejam sincronizados.
- Ignorar API e alterar apenas no IXC: ao utilizar essa opção, o sistema não utilizará a API da Contel, resultando em nenhuma comunicação com ela. Todas as alterações feitas serão refletidas apenas no IXC Provedor, sem afetar a linha MVNO na plataforma MVNO.
- Integração: Clique na lupa e selecione o ID da integração da plataforma Contel;
- Produto relacionado: Deve inserir um produto IXC/MVNO, o qual foi cadastrado em Produtos e que esteja vinculado ao contrato do cliente;
- eSIM (chip virtual):
- Sim: Se marcado como sim, o sistema preencherá os dados de SIM Card com o retorno da plataforma, isto é, é preenchido automaticamente a partir do chip virtual. Ao salvar a linha, é feita a ativação do chip virtual na Contel e retornará o link no campo Link eSim para visualizar o QR Code e o cliente finalizar, aceitando a ativação;
- Não: caso esteja marcado como não, os demais campos devem ser preenchidos manualmente.
- SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Caso a linha não seja eSim, preencha manualmente a numeração fornecida;
- Portabilidade: Marque como Sim;
- DDD: Inserir DDD para que seja retornado o número do telefone equivalente ao DDD passado;
- Número de Telefone: Informar o número a ser portado;
- Operadora origem: clique na lupa e selecione a opção de operadora de origem disponível pela plataforma;
- API: Selecione a opção Alterar na API e no IXC;
- Após informar todos os campos, clique em Salvar.
- Campos preenchidos automaticamente:
- SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Preenchido automaticamente caso o parâmetro eSim estiver habilitado como sim;
- Número temporário: número temporário a ser utilizado até a ativação da linha quando for portabilidade;
- ID linha integração: ao cadastrar a linha MVNO no IXC, este campo é preenchido como um retorno da plataforma Contel, indicando o ID do cadastro da linha na plataforma;
- Status linha: indica o status de uso da linha.
- Status portabilidade: ao ativar a linha como portabilidade, esta informação será preenchida como Aguardando ativação. Com a portabilidade concluída, o status é alterado para Concluída.
- Link eSim: Quando a linha cadastrada for uma linha de chip virtual e o parâmetro estiver marcado como sim, este campo será preenchido automaticamente com o link para ativação da linha.
Finalização:
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.
Importante:
O controle de acesso é feito diretamente pelas ações do contrato ou manualmente nos botões de Status da linha (bloqueio e liberação).
Atenção:
Após cadastrada, a linha MVNO Contel não permite nenhuma atualização ou alteração.
Casos de Uso
1. Controle de Acesso pelas Ações do Contrato
É possível realizar o gerenciamento do status da linha diretamente pelo sistema, mediante o status do contrato. Quando existe uma linha MVNO vinculada em um contrato, toda ação realizada no status do contrato e status de acesso irá refletir no status da linha, sendo esta alterada também e impactando no consumo do cliente final.
Legenda - impacto do status do contrato na linha MVNO:
- Ativo: ao contrato que estiver com status de ativo e seu status de acesso também constar como ativo, a linha deve admitir o status de Ativa;
- Bloqueio manual/automático: ao contrato que for bloqueado por inadimplência de forma manual ou automática, assumindo o status de Bloqueio manual ou Bloqueio automático, a linha sofrerá bloqueio total, interrompendo totalmente o consumo do cliente;
- Financeiro em atraso: ao contrato que assumir o status de acesso do contrato para Financeiro em atraso, a linha permanecerá ativa;
- Liberação manual ou automática: é possível realizar o desbloqueio do contrato mediante o pagamento ou renegociação da mensalidade, por meio da liberação manual ou automática a partir do pagamento do título que ocasionou o bloqueio total ou parcial, ativando automaticamente o contrato ou manualmente;
- Cancelamento: ao cancelar/desativar o contrato, a linha irá respeitar o status do contrato e também será cancelada, admitindo o status de Inativa no sistema, enquanto a Contel suspende o plano e impede a renovação. Se a linha permanecer cancelada, m 60 dias é automaticamente desativada conforme as regras da Anatel.
2. Controle de Acesso pelas Ações da Linha MVNO
É possível realizar o gerenciamento do status da linha diretamente pelo IXC, de modo que o sistema permite a alteração manual do status diretamente pela linha e não somente pelo contrato.
Para alterar o status da linha, siga os passos a seguir:
- 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, conforme as opções disponíveis;
Legenda - status:
- Bloqueio roubo: altera o status da linha para Bloqueio roubo, interrompendo totalmente o consumo do cliente ao que diz respeito o consumo de dados, ligações e envios de SMS devido ao dispositivo/simcard ter sofrido roubo;
- Cancelar linha: altera o status da linha para Cancelada, efetuando o cancelamento total da linha;
- Liberar linha: realiza a liberação da linha quando estiver em bloqueio, retomando o consumo do cliente. A linha assume o status de Ativa. Libera o uso de ligações, consumo de dados e envio de SMS caso a linha tenha saldo. Retorna a utilização imediatamente ao liberar;
- Bloqueio perda: altera o status da linha para Bloqueio roubo, interrompendo totalmente o consumo do cliente ao que diz respeito o consumo de dados, ligações e envios de SMS devido à perda do simcard/dispositivo;
- Bloqueio total: realiza a alteração do status da linha para Bloqueio total, interrompendo totalmente o consumo do cliente ao que diz respeito o consumo de dados, ligações e envios de SMS.
3. Troca de plano da Linha MVNO Contel
A plataforma permite a alteração do plano atrelado à linha MVNO. Para realizar a alteração do plano, siga os passos a seguir:
- Acesse o formulário Contrato do Cliente através do caminho: Sistema > Cadastro > Contratos;
- Selecione o contrato do cliente que deseja realizar a alteração do plano e clique em Editar;
- Acesse a aba Produtos no formulário Contrato do Cliente e clique em Novo;
- No campo Tipo, indique a opção MVNO/Telefonia Móvel para habilitar a seleção de produtos desta classe;
- No campo Produto/Serviço, selecione e vincule outro produto de telefonia móvel anteriormente cadastrado;
- Após vincular o produto, acesse a Aba Linha MVNO - Contrato do Cliente. Selecione a linha MVNO cadastrada e clique em Editar;
- No campo Produto/Serviço, clique na lupa e selecione o produto de MVNO anteriormente associado ao contrato;
- Clique em Salvar para atualizar os dados da linha.
Fluxo de Trabalho
graph TD A[Início] --> B[Cadastro de Cliente] B --> C[Criação de Contrato] C --> D[Seleção de Plano Móvel] D --> E[Acesso à Aba MVNO] E --> F[Preenchimento de Dados da Linha] F --> G[Envio para Ativação] G --> H[Confirmação da Contel] H --> I[Linha Ativa] I --> J[Monitoramento e gerenciamento]
Considerações Finais
A integração entre a plataforma Contel 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.
Etiquetas
Integracoes IntegracoesDeTelefoniaMovel IntegracaoContel Contel MVNO