Integração Hubsoft com Qualifica

Sobre a Qualifica

A Qualifica é um hub de benefícios digitais, os serviços de valor agregado (SVAs), para empresas que querem oferecer mais aos clientes. Para o provedor de internet, os planos da Qualifica entram como benefício ou como serviço adicional no plano de internet, com códigos como pro e premium.

O que a integração faz

A integração usa a API da Qualifica. Com ela, o Hubsoft faz:

• Cadastro do assinante na Qualifica quando o pacote é vinculado a um serviço habilitado, ou quando o serviço é habilitado.
• Remoção quando o pacote sai do serviço.
• Suspensão e reativação conforme o cliente fica inadimplente ou volta a pagar, com a chave de habilitar e suspender ligada.
• Geração automática do token de acesso a partir das credenciais da integração.
• Data de expiração do acesso por assinante. Sem preenchimento, o Hubsoft envia a data de um ano após o cadastro.
• Definição do usuário e da senha do assinante a partir de um dado do cadastro. O padrão é o login de autenticação; também pode ser o CPF ou CNPJ, o código do cliente, o e-mail ou o telefone.

Os pacotes podem ser vendidos avulsos, dados como benefício ou incluídos em combos com o plano de internet.

O que você precisa

• Contrato com a Qualifica.
• O client_id e o client_secret, fornecidos pela Qualifica.
• O código de cada produto contratado, que aparece no painel da Qualifica.

Como ativar

1. No Hubsoft, acesse Configuração > Integrações > Plataformas de Conteúdo, clique em Adicionar e selecione a Qualifica.
2. Preencha o client_id e o client_secret e salve. Se o token não for gerado, use Ações > Testar.
3. Ligue a chave de habilitar e suspender, se quiser.
4. Cadastre os produtos com o código exato do painel da Qualifica.
5. Em Configuração > Geral > Pacotes, crie o pacote com valor e composição fiscal e, na aba Integração, escolha a Qualifica e o produto.
6. Vincule o pacote ao serviço do cliente (Outras Opções > Pacotes > Adicionar Pacote) e, se quiser, defina a data de expiração.

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

Limitações

• O assinante é identificado pelo código do cliente. Por isso, o pacote com integração deve ficar em um só plano do cliente. Para cobrar o mesmo valor em outro plano, use um pacote igual sem integração.
• O código do produto errado causa erro na transmissão.
• A composição fiscal do pacote deve ser validada com a contabilidade do provedor.

Perguntas frequentes

Por quanto tempo o assinante tem acesso?

Até a data de expiração informada no pacote. Sem preenchimento, o Hubsoft envia a data de um ano depois do cadastro.

Qual usuário o assinante usa na Qualifica?

O dado escolhido na integração. Por padrão, o login de autenticação do plano. Com outro dado, como o CPF, usuário e senha passam a ser esse dado.

Onde encontro o código do produto?

No painel da Qualifica, na lista de produtos contratados. Cadastre no Hubsoft exatamente como aparece lá.

Revisado em 10/10/2026.