Integração de Telefonia Móvel - Telecall
Introdução
O que é a Telecall?
A MVNO Telecall é 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 Telecall, é possível integrar de maneira eficaz sua operação de telefonia móvel, facilitando o gerenciamento ágil e eficiente de suas linhas.
- Este documento descreve o processo de integração entre o MVNO Telecall 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
Requisitos de Uso
A contratação de um módulo é necessária para a liberação da integração no sistema IXC. Para realizar a contratação do módulo, entre em contato conosco mediante um atendimento direcionado ao departamento Administrativo Financeiro.
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: Acesso ao Formulário de Integrações
Neste passo, é efetuado o cadastro da integração. Este processo permite a comunicação e troca de dados entre o sistema e a plataforma Telecall.
- 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 Telecall no campo Plataforma;
- Insira as informações fornecidas pela Telecall nos campos:
- Login: insira seu login de acesso à plataforma do Portal do Cliente da Telecall, fornecido pela plataforma (e-mail válido);
- Senha: insira sua senha de acesso à plataforma do Portal do Cliente da Telecall, fornecido pela plataforma;
- URL: utilizada para identificar e acessar os dados da plataforma, necessários para a integração. Insira a URL disponibilizada pela Telecall para o uso da integração no IXC;
- Token: serve como uma chave de acesso, permitindo que ocorra a comunicação entre o IXC e a Telecall. Este campo é preenchido automaticamente após salvar a integração;
- Data atualização do token: data da última atualização do token na integração. O token é atualizado sempre que existe qualquer interação na integração, como consultas ao realizar o cadastro da linha MVNO.
- Clique em Salvar para validar a criação da integração e concluir o cadastro;
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 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 Formulário Planos de Venda.
- Acesse o formulário de 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 Telecall.
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 TeleCall valida os seguintes dados para a ativação de uma linha MVNO:
- CPF/CNPJ;
- Razão social/Nome;
- Data de nascimento;
- Endereço (campos CEP, Endereço, Número, Complemento);
- E-mail;
- Telefone de contato;
- Contrato ativo.
Atente-se ao cadastro do cliente para que todos estes dados estejam devidamente cadastrados.
Cuidado:
Realize o cadastro da linha com o status do contrato como Ativo. Ao realizar o cadastro de uma linha com o contrato com o status Pré-contrato, a linha será criada inativa e não será possível reativar.
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 Telecall, 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 Telecall, 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 Telecall;
- Cliente MVNO: clique na lupa e selecione o token gerado para o cliente MVNO correspondente à este cliente;
- Conta MVNO: clique sobre a lupa e selecione a conta MVNO correspondente à este cliente;
- Profile MVNO: clique sobre a lupa e selecione o perfil correspondente à este tipo de linha MVNO;
- Produto relacionado: Deve inserir um produto IXC/MVNO, o qual foi cadastrado em Produtos e que esteja vinculado ao contrato do cliente;
- SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Insira o número do cartão que ficará relacionado à esta linha;
- Portabilidade: Marque como Não;
- Tipo de número: clique no botão de seleção e indique uma das opções de tipo de número disponíveis (entre elas, DID móvel, Gold, M2M, M2M Especial, Normal, QA, Teste)
- DDD: Inserir DDD para que seja retornado o número do telefone equivalente ao DDD passado;
- Número do telefone: Este é o número de telefone que ficará vinculado à linha, clique sobre o botão “Buscar número linha” para abrir a listagem e selecione um número para associar à linha MVNO;
- Dia recorrência: Insira a data de vencimento do plano. Se baseia no status do contrato para ocorrer a renovação do plano.
- API: Selecione a opção Alterar na API e no IXC;
-
Após informar todos os campos, clique em Salvar.
-
Campos preenchidos automaticamente:
- ID linha integração: ao cadastrar a linha MVNO no IXC, este campo é preenchido como um retorno da plataforma Telecall, indicando o ID do cadastro da linha na plataforma;
- Status linha: indica o status de uso da linha;
4.2: Ativação de número existente (portabilidade)
-
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 Telecall, 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 Telecall, 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 Telecall;
- Cliente MVNO: clique na lupa e selecione o token gerado para o cliente MVNO correspondente à este cliente;
- Conta MVNO: clique sobre a lupa e selecione a conta MVNO correspondente à este cliente;
- Profile MVNO: clique sobre a lupa e selecione o perfil correspondente à este tipo de linha MVNO;
- Produto relacionado: Deve inserir um produto IXC/MVNO, o qual foi cadastrado em Produtos e que esteja vinculado ao contrato do cliente;
- SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Insira o número do cartão que ficará relacionado à esta linha;
- Portabilidade: Marque como Sim;
- Tipo de número: clique no botão de seleção e indique uma das opções de tipo de número disponíveis (entre elas, DID móvel, Gold, M2M, M2M Especial, Normal, QA, Teste)
- DDD: Inserir DDD para que seja retornado o número do telefone equivalente ao DDD passado;
- Número do telefone: Insira manualmente o número a ser portado;
- Dia recorrência: Insira a data de vencimento do plano. Se baseia no status do contrato para ocorrer a renovação do plano.
- API: Selecione a opção Alterar na API e no IXC;
-
Após informar todos os campos, clique em Salvar.
-
Campos preenchidos automaticamente:
- ID linha integração: ao cadastrar a linha MVNO no IXC, este campo é preenchido como um retorno da plataforma Telecall, 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.
-
Após Salvar a linha, clique no botão Enviar portabilidade para solicitar o processo de portabilidade com a operadora.
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).
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.
Dica:
Os bloqueios estão estruturados em suspensão dos planos, isto é, o plano não será renovado na plataforma quando ocorrer o bloqueio no sistema.
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 sofrerá bloqueio parcial, interrompendo parcialmente o consumo do cliente;
-
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.
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;
Legenda - status:
- Cancelar linha: altera o status da linha para Cancelada, efetuando o cancelamento da linha. Uma linha cancelada pode ser reativada dentro de 90 dias através do botão Liberar linha.
Atenção:
Após 90 dias de cancelamento, a linha não poderá ser reativada.
-
Liberar linha: realiza a liberação da linha quando estiver em bloqueio, retomando o consumo do cliente. A linha assume o status de Ativa;
-
Bloqueio parcial: altera o status da linha para Bloqueio parcial, interrompendo parcialmente o consumo do cliente;
-
Bloqueio total: realiza a alteração do status da linha para Bloqueio total, interrompendo totalmente o consumo do cliente.
Fluxo de Trabalho
flowchart TD A[Credenciamento com a plataforma] --> B[Cadastro da integração no sistema] B --> C[Cadastro do produto MVNO] C --> D[Incluir produto no contrato] D --> E[Ativar linha MVNO] E --> |Novo cadastro| F[Linha Ativa] E --> |Portabilidade| G[Consulta portabilidade] G --> |Concluída| F G --> |Recusada| H[Portabilidade Recusada] G --> |Cancelada| I[Portabilidade Cancelada] F --> J[Faturamento] J --> N[Monitoramento do contrato e status de acesso] N --> O[Status de acesso baseado no financeiro do cliente]
Considerações Finais
A integração entre a plataforma TeleCall 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 IntegracaoTelefoniaMovel MVNO TeleCall