Integração Hubsoft com ProvedorZAP

Sobre a ProvedorZAP

A ProvedorZAP é uma API de WhatsApp feita para provedores de internet. O provedor conecta o próprio número na área do cliente e gerencia conexões e chaves de API por um painel. A plataforma trata o nono dígito dos números brasileiros e envia com intervalos e pausas automáticas para proteger o número de bloqueios.

O que a integração faz

• Envia notificações, avisos de vencimento e faturas no WhatsApp do assinante, a partir do Hubsoft.
• Dispara os avisos pelas regras de SMS da forma de cobrança: depois de gerada a fatura, antes do vencimento, depois do vencimento ou depois do pagamento.
• Usa os layouts de SMS para mensagens de atendimento, ordem de serviço, aniversário e outros tipos.
• Permite disparos personalizados pelo menu do cliente ou para um grupo de clientes filtrado no relatório Serviços do Cliente.
• Valida o JSON da mensagem: no layout de SMS, nas regras da forma de cobrança e nos disparos personalizados, o Hubsoft avisa que a mensagem precisa estar em JSON e oferece a opção Validar JSON, que aponta erros e formata o texto.

O que você precisa

• Conta na ProvedorZAP com o WhatsApp conectado.
• A URL de produção e a chave de autenticação da API (x-api-key) da ProvedorZAP.

Como ativar

1. No Hubsoft, acesse Configurações > Integrações > SMS/Mensageiro e clique em Adicionar.
2. Escolha o gateway Provedor Zap e informe a descrição, a URL e a chave da API. Salve.
3. Teste a integração em Ações.
4. Monte as mensagens em JSON nos layouts de SMS e nas regras da aba SMS da forma de cobrança, usando Validar JSON antes de salvar.
5. Crie a rotina Enviar SMS em Configuração > Geral > Rotinas.

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

Limitações

• A mensagem precisa estar em JSON. Se o formato estiver errado, o Hubsoft mostra um alerta, e o layout é validado também ao salvar.

Perguntas frequentes

Por que a mensagem precisa ser em JSON?

Porque esse gateway envia a requisição em JSON para a ProvedorZAP. A opção Validar JSON mostra se o texto está correto e formata a mensagem para facilitar a edição.

Consigo enviar uma mensagem para um grupo de clientes?

Sim. Filtre os clientes no relatório Serviços do Cliente, marque quem vai receber e use a ação de SMS personalizado com a integração da ProvedorZAP.

Um cliente não recebeu o aviso. O que conferir?

Se a fatura se encaixa na regra, se está na forma de cobrança com as regras e se o serviço e o contato do cliente permitem esse tipo de aviso.

Revisado em 10/10/2026.