Central de Ajuda

Leitura de 13 min

Integração de Telefonia Móvel - Tá Telecom

Introdução

Definição Tá Telecom:

A MVNO Tá Telecom é 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 plataformaTá Telecom, é 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 Tá Telecom 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

Para utilizar esta ferramenta, é necessário possuir os dados de integração em mãos. Em caso de dúvidas, entre em contato com a plataforma contratada para obtê-los.

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 Tá Telecom.

  1. 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;
  2. Pressione o botão Novo;
  3. Selecione Tá Telecom no campo MVNA;
  4. Insira as informações fornecidas pela Tá Telecom nos campos:
    • URL: insira a URL fornecida pela Tá Telecom. Esta informação permite o sistema IXC Provedor se conectar ao sistema da Tá Telecom para realizar consulta, inserções e alterações de dados;
    • Token: insira o token fornecido pela Tá Telecom. Este item opera como um autenticador entre as plataformas, garantindo a comunicação segura e adequada entre o IXC e a Tá Telecom.
  5. 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.

  1. Acesse o formulário de Cadastro de Produtos através do caminho: Sistema > Cadastros > Produtos;
  2. Pressione o botão Novo;
  3. Preencha os campos obrigatórios na aba Produtos e na aba Planejamento;
  4. Acesse a aba Telefonia Móvel;
  5. 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: preenchido automaticamente.
  6. 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.

  1. No menu principal, navegue até Sistema;
  2. Selecione Cadastros;
  3. Clique em Contrato;
  4. Pressione o botão Editar para acessar o contrato;
  5. 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 do 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 Tá Telecom.

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 Tá Telecom valida os seguintes dados para a ativação de uma linha MVNO:

  • CPF/CNPJ;
  • Nome/Razão social;
  • Tipo pessoa (física ou jurídica);
  • Data de nascimento;
  • Endereço (campos CEP, Endereço, Número, Complemento);
  • Endereço de E-mail;
4.1: Ativação de número novo

  1. Ainda no contrato do cliente, navegue até a Linha MVNO;

  2. Clique no botão Novo e preencha os campos apresentados:

    • API: Selecione a opção Alterar na API e no IXC;
      • 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 Tá Telecom, garantindo que os dados sejam sincronizados. Ao ativar uma nova linha, utilize esta opção;
      • Apenas no IXC: ao utilizar essa opção, o sistema não utilizará a API da Tá Telecom, resultando em nenhuma comunicação com ela. Todas as alterações feitas serão realizadas apenas no IXC Provedor, sem afetar a linha MVNO na plataforma MVNO. Pode ser utilizado para incluir uma linha no sistema que já existe na plataforma.
    • Integração: Clique na lupa e selecione o ID da integração da plataforma Tá Telecom;
    • Produto relacionado: Clique na lupa e selecione o produto vinculado ao contrato do cliente;
    • SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Clique no botão Buscar SIM Cards disponíveis e selecione o número do cartão que ficará relacionado à esta linha;
    • Portabilidade: Marque como Não;
    • DDD: Insira DDD para que o número do telefone seja devidamente preenchido, conforme o DDD que está sendo utilizado pelo provedor;
    • Número do telefone: Este é o número de telefone que ficará vinculado à linha, será preenchido automaticamente após salvar a linha MVNO.

  3. Após informar todos os campos, clique em Salvar.

  4. Campos preenchidos automaticamente:

    • Msisdn: Campo preenchido automaticamente com o número de telefone do cliente após concluir o cadastro da linha MVNO. Este campo considera o DDI + DDD + o número de telefone. Campo de leitura, não é editável;
    • ID contrato integração: ao cadastrar a linha MVNO no IXC, este campo é preenchido como um retorno da plataforma Tá Telecom, 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)
  1. Ainda no contrato do cliente, navegue até aba Linha MVNO;
  2. Clique no botão Novo e preencha os campos apresentados:
    • API: Selecione a opção Alterar na API e no IXC;
      • Na API e no IXC: ao utilizar essa opção, o sistema permite a comunicação entre o IXC Provedor e a plataforma. Toda requisição de alteração na linha MVNO será enviada para a plataforma Tá Telecom, garantindo que os dados sejam sincronizados. Utilize este recurso para ativar uma linha de portabilidade.
      • Alterar apenas no IXC: ao utilizar essa opção, o sistema não utilizará a API da Tá Telecom, 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. Pode ser utilizado para incluir uma linha no sistema que já existe na plataforma.
    • Integração: Clique na lupa e selecione o ID da integração da plataforma Tá Telecom;
    • Produto relacionado: Clique na lupa e selecione o produto vinculado ao contrato do cliente;
    • SIM card: Número do cartão repassado pela integrada, deve conter 20 caracteres. Clique no botão Buscar SIM Cards disponíveis e selecione o número do cartão que ficará relacionado à esta linha;
    • Portabilidade: Marque como Sim;
    • DDD: Insira o DDD do número do telefone equivalente;
    • Número de Telefone: Informar o número a ser portado;
  3. Após informar todos os campos, clique em Salvar.
  4. Campos preenchidos automaticamente:
    • Msisdn: telefone temporário do cliente. Campo preenchido automaticamente com o número de telefone do cliente após concluir o cadastro da linha MVNO. Este campo considera o DDI + DDD + o número de telefone. Campo de leitura, não é editável;
    • ID contrato integração: ao cadastrar a linha MVNO no IXC, este campo é preenchido como um retorno da plataforma Tá Telecom, 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.
  5. A linha assumirá o status de Aguardando ativação. Clique no botão Status e em seguida, selecione a opção Ativar Simcard;
  6. Em seguida, clique em Enviar portabilidade para enviar a portabilidade à plataforma e aguarde a aprovação.

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 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.

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, perdendo serviços que geram custos
  • 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, manualmente ou através da tarefa de cancelamento automático, a linha irá respeitar o status do contrato e também será cancelada, admitindo o status de Inativa.

Atenção:

Não é possível evitar que a linha sofra bloqueio parcial devido ao tratamento aplicado pela Tá Telecom. Dessa forma, o sistema não permite ajustes para impedir que esse bloqueio ocorra.

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:

  1. Acesse o contrato do cliente;
  2. Clique na aba Linha MVNO;
  3. Selecione o botão de Editar;
  4. Clique sobre o botão Status;
  5. Selecione a opção de status que deseja aplicar à linha MVNO;

Legenda - status:

  • Cancelar linha: altera o status da linha para Cancelada, solicitando o cancelamento 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;
  • 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.

3. Trocar titularidade - MVNO

O sistema permite a alteração da titularidade da linha, de modo que uma linha já cadastrada possa ser transferida para outro contrato.

Critérios de transferência:

  • A linha deve estar com o status Ativo;
  • O status da portabilidade, caso a linha seja portada, deve estar como Concluída;
  • O contrato que receberá a linha deve respeitar somente os seguintes status no contrato:
    • Status de contrato e status de acesso Ativo.
    • Status de contrato Pré-Contrato e status de acesso Desativado/Aguardando assinatura.
    • Status de contrato Ativo e status de acesso bloqueado ou em aviso de atraso.
  • O contrato que receberá a linha deve ser do novo titular. O novo contrato deve ser diferente do atual titular.

Para realizar uma troca de titularidade, siga os seguintes passos:

  1. Acesse a linha MVNO que deseja realizar a alteração do contrato;
  2. Selecione o botão Trocar titularidade;
  3. No campo ID contrato novo, clique sobre a lupa e selecione o contrato que passará a ter vínculo com a linha MVNO.
  4. Clique em confirmar para validar a troca de titularidade.

4. Consulta de Consumo

Para realizar a consulta de consumo das linhas MVNO, será utilizado o Relatório MVNO.

  1. Acesse menu Relatórios > Relatórios Provedor > Relatórios Telefonia > Relatório MVNO;
  2. Preencha o campo de Integração com o cadastro da integração da plataforma;
  3. Em seguida, preencha os demais campos:
    • Linha MVNO: clique na lupa e selecione uma linha MVNO existente;
    • Período: insira o período de mês e ano. Exemplo: 07/2025 (julho de 2025).
  4. Clique no botão Consumo por Período para emitir o relatório.
  5. O sistema exibirá um relatório contendo os dados de:
    • ID da linha
    • Número
    • Cliente
    • Plano
    • Consumo ligações (em minutos)
    • Consumo dados (em GB)
    • Consumo SMS
    • Status linha

5. Detalhamento da Linha MVNO

A funcionalidade de Detalhamento da Linha MVNO está integrada ao cadastro de contratos e linhas móveis no sistema. Seu funcionamento depende de duas condições principais:

  1. A linha MVNO precisa estar ativa no sistema;
  2. A linha precisa estar consumindo e haver algum registro recente de uso de dados, voz ou SMS.

O detalhamento da linha pode envolver os seguintes dados:

  • Saldo disponível: exibe os saldos atuais de dados móveis, voz e SMS;
  • Histórico da linha: que traz eventos importantes como data de expiração dos dados, data da última consulta de saldo, status da instalação do app e data da última recarga.

  1. Acesse o formulário de Linha MVNO por meio do contrato do cliente, seguindo o caminho: Sistema > Cadastros > Contratos;

  2. Clique na aba Linha MVNO;

  3. Selecione a linha desejada e clique em Editar;

  4. Em seguida, clique no botão Detalhamento da linha. O sistema emitirá um relatório com as principais informações, organizadas em duas seções: Saldo disponível e Histórico da linha.

    Seção Saldo disponível:

    • Dados móveis: Quantidade de dados (em MB ou GB) disponíveis para uso na linha no momento da consulta.
    • Voz: Minutos de chamadas de voz ainda disponíveis para utilização.
    • SMS: Quantidade de mensagens de texto (SMS) que a linha pode enviar com base no saldo atual.

    Seção Histórico da linha

    • Data de expiração dos dados: Indica até quando o saldo atual de dados móveis estará disponível para uso.

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 Tá Telecom]
    H --> I[Linha Ativa]
    I --> J[Monitoramento e gerenciamento]

Considerações Finais

A integração entre a plataforma Tá Telecom 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 TaTelecom

Leia Também

Explore nossos produtos!

IXC ACS
Opa! Suite
IXC ONER
Olli

Páginas relacionadas