Integração Hubsoft com TelOS – ISPX

Sobre a TelOS – ISPX

A ISPX Soluções em Telecomunicações é uma operadora autorizada pela Anatel, com sede e data center principal em Maringá (PR). Atua com banda larga, telefonia fixa e telefonia móvel, e tem rede própria de fibra no Paraná. Na telefonia celular, a ISPX oferece uma solução white label para o provedor de internet virar operadora móvel. A TelOS é a plataforma pela qual o Hubsoft se integra a esse serviço.

O que a integração faz

• Sincronização de planos: os planos da TelOS 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 e informa o ICCID. O número só é informado em caso de portabilidade.
• Cadastro do assinante sem duplicidade: no primeiro cadastro, a TelOS devolve um código para o assinante. Nas linhas seguintes do mesmo cliente, mesmo em outro serviço, o Hubsoft reaproveita esse código.
• Portabilidade: é pedida na ativação da linha, com o número e a operadora doadora.
• Recarga com fatura: pelas ações do número, o atendente escolhe o plano da recarga e informa o valor, o tipo de serviço e o vencimento. O Hubsoft gera a fatura e envia a recarga à TelOS.
• Troca de plano: pelas ações do número, sem apagar e recadastrar a linha.
• Bloqueio e desbloqueio: quando o serviço do cliente é suspenso ou habilitado no Hubsoft, o pedido vai para a fila de transmissão da TelOS.
• Cancelamento: ao excluir o número ou o plano, o cancelamento é enviado à TelOS.
• Relatório MVNO: lista os serviços com linhas da TelOS e os erros de transmissão.

O que você precisa

• Contrato com a ISPX e os dados de acesso à API da TelOS (chave de API, grupo de cliente e conta corrente), fornecidos pela própria plataforma.
• 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 a TelOS.
2. Informe a chave de API, o grupo de cliente e a conta corrente.
3. Sincronize os planos em Ações > Planos > Sincronizar.
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 TelOS na wiki da Hubsoft.

Limitações

• A portabilidade só pode ser pedida na ativação da linha.
• Toda recarga feita pelo Hubsoft gera uma fatura para o assinante.

Perguntas frequentes

Como peço a portabilidade do número do assinante?

Na ativação da linha. Ative o parâmetro de portabilidade e informe o número e a operadora doadora.

Como cobro uma recarga?

Em Dados MVNO > Ações > Recarga, escolha o plano e informe o valor, o tipo de serviço e o vencimento. O Hubsoft gera a fatura e envia a recarga à TelOS.

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 transmissão e o bloqueio é enviado à TelOS. Ao habilitar o serviço, o desbloqueio segue o mesmo caminho.

Revisado em 10/10/2026.