Integração Hubsoft com Play Móvel

Sobre a Play Móvel

A Play Móvel é uma operadora móvel virtual (MVNO) com proposta totalmente digital: o assinante consulta a cobertura e controla os planos pelo aplicativo. A rede que suporta os serviços é da Surf Telecom. Para o provedor de internet, a Play Móvel é uma forma de incluir planos de celular na oferta aos próprios clientes.

O que a integração faz

• Sincronização de planos: os planos da Play Móvel são trazidos para o Hubsoft pela tela da integração.
• Ativação pelo ICCID: no serviço do cliente, o atendente escolhe o plano e informa o ICCID do chip. A Play Móvel gera o número, e o Hubsoft o grava no cadastro quando a transmissão termina.
• Pré-pago ou pós-pago: por padrão, as linhas entram como pré-pagas. Um parâmetro da integração cadastra as linhas como pós-pagas.
• Linhas que já existem na Play Móvel: se o assinante já tem linha na plataforma, o provedor cadastra o número no Hubsoft. Na transmissão, o Hubsoft procura a linha e o CPF/CNPJ do cliente e faz a associação.
• Bloqueio e desbloqueio: quando o serviço do cliente é suspenso ou habilitado no Hubsoft, o pedido vai para a fila de transmissão da Play Móvel.
• Inadimplência: com a recorrência ativa, o Hubsoft bloqueia ou desbloqueia o plano da linha conforme o pagamento das faturas.
• Portabilidade: depois da ativação, o provedor cadastra a portabilidade com o número antigo do assinante. O Hubsoft envia o pedido e consulta o status a cada hora.
• Cancelamento: ao excluir o número ou o plano, o cancelamento é enviado à Play Móvel.
• Faturamento por pacote: o provedor pode exigir um pacote em cada número, para faturar a linha pelo Hubsoft.
• Relatório MVNO: lista os serviços com linhas da Play Móvel e os erros de transmissão.

O que você precisa

• Contrato com a Play Móvel, a chave de API e a identificação do provedor como parceiro, fornecidas pela própria Play Móvel.
• 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 Playmóvel.
2. Informe a chave de API e a identificação de parceiro. Se as linhas forem pós-pagas, ative o parâmetro de pós-pago.
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, informe o ICCID e aguarde a transmissão.

O passo a passo com as telas está na página da Play Móvel na wiki da Hubsoft.

Limitações

• O número não é escolhido no cadastro: a Play Móvel gera o número a partir do ICCID.
• A portabilidade é um passo separado, feito depois da ativação da linha.

Perguntas frequentes

Já tenho assinantes com linha da Play Móvel. Preciso recadastrar na plataforma?

Não. Cadastre os números no Hubsoft. Na transmissão, o Hubsoft localiza a linha e o CPF/CNPJ do cliente na Play Móvel e faz a associação.

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 à Play Móvel. Ao habilitar o serviço, o desbloqueio segue o mesmo caminho.

O assinante pode trazer o número de outra operadora?

Sim. Depois de ativar a linha, cadastre a portabilidade nas ações do número com o número antigo. O andamento fica na guia Status da tela de portabilidade.

Revisado em 10/10/2026.