Integração Hubsoft com TáTelecom

Sobre a Tá Telecom

A Tá Telecom, nome comercial da ISPS do Brasil S.A., com sede em São Paulo, é uma operadora de telefonia móvel para todo o Brasil. O provedor de internet vende os planos para a própria base e pode usar o modelo white label, com chip e perfil eSIM com a marca dele. A rede é a da TIM. Para operar, o provedor precisa estar regular com a regulamentação de telecomunicações.

O que a integração faz

• Sincronização de planos: os planos da Tá Telecom são trazidos para o Hubsoft pela tela da integração.
• Ativação da linha: no serviço do cliente, o atendente escolhe o plano e o DDD, informa o ICCID e o número, quando ele não vem preenchido.
• Linha que já existe na Tá Telecom: o atendente informa o contrato vigente e o número é vinculado ao contrato existente, sem novo cadastro na plataforma.
• Portabilidade com token: pode ser pedida na ativação ou depois, pelas ações do número. A Tá Telecom envia um código por SMS ao celular do assinante, e o atendente valida esse código no Hubsoft para seguir com a portabilidade. O Hubsoft consulta o status a cada hora.
• Troca de plano, de SIM Card e de titularidade: pelas ações do número, sem apagar a linha e sem gerar cobrança indevida na plataforma.
• Bloqueio e desbloqueio: quando o serviço do cliente é suspenso ou habilitado no Hubsoft, o pedido vai para a fila de transmissão da Tá Telecom.
• Cancelamento: ao excluir o número ou o plano, o cancelamento é enviado à Tá Telecom.
• Relatório MVNO: lista os serviços com linhas da Tá Telecom e os erros de transmissão.

O que você precisa

• Contrato com a Tá Telecom e o token de autenticação, fornecido pelo suporte da Tá Telecom.
• Chips identificados pelo ICCID.
• Os planos do Hubsoft que vão receber linhas marcados com a opção "Serviço Permite MVNO".

Como ativar

1. No Hubsoft, acesse Configuração > Integrações > MVNO > Adicionar e selecione o gateway Tá Telecom.
2. Informe o token. Se a Tá Telecom indicar outro endereço de API, informe também esse endereço.
3. Sincronize os planos em Ações > Planos.
4. Em Configuração > Geral > Serviços / Planos, marque "Serviço Permite MVNO" nos planos que terão linha móvel.
5. No serviço do cliente, acesse Outras Opções > Dados MVNO > Adicionar, escolha o plano e o DDD e informe o ICCID.

O passo a passo com as telas está na página da Tá Telecom na wiki da Hubsoft.

Limitações

• Alguns provedores ainda usam a Tá Telecom pelo gateway da TIP, que tem a mesma API. A Tá Telecom está migrando os clientes para a integração própria. Antes de cadastrar, confirme com a Tá Telecom como o seu contrato foi feito. Para quem usa o gateway da TIP, há uma página específica na wiki.
• A portabilidade só segue depois que o código enviado por SMS ao assinante é validado.

Perguntas frequentes

Se o serviço do cliente for suspenso por débito, a linha também é suspensa?

Sim. A suspensão no Hubsoft entra na fila de bloqueio da Tá Telecom. Ao habilitar o serviço, o desbloqueio segue o mesmo caminho.

Consigo trazer para o Hubsoft uma linha que já está ativa na Tá Telecom?

Sim. No cadastro do número, informe o contrato vigente. O número é vinculado ao contrato que já existe, sem novo cadastro.

Por que a portabilidade pede um token?

É uma regra da Tá Telecom. Ao pedir a portabilidade, o assinante recebe um código por SMS. O atendente valida o código no Hubsoft e o pedido segue.

Revisado em 10/10/2026.