Integração Hubsoft com Zenvia

Sobre a Zenvia

A Zenvia é uma plataforma de comunicação com os clientes. A Zenvia Customer Cloud usa inteligência artificial para atender e vender pelo WhatsApp e por outros canais, da atração ao pós-venda, em uma solução unificada.

O que a integração faz

• Envia SMS e mensagens de WhatsApp pela Zenvia. O canal é definido pela URL da integração: uma para SMS e outra para WhatsApp.
• No WhatsApp, usa templates HSM, com as variáveis preenchidas pelo Hubsoft no envio.
• 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.
• Permite disparos para um grupo de clientes filtrado no relatório Serviços do Cliente, escolhendo o template quando a integração usa HSM.

O que você precisa

• Conta na Zenvia com o canal de SMS ou de WhatsApp ativo.
• O token de autenticação da Zenvia e o identificador do canal de envio.
• Para WhatsApp, os templates HSM aprovados na Zenvia e o Template ID de cada um.

Como ativar

1. No Hubsoft, acesse Configuração > Integrações > SMS/Mensageiros e clique em Adicionar.
2. Escolha o gateway Zenvia e informe o token, a URL do canal (SMS ou WhatsApp), o número e o identificador do canal.
3. Para WhatsApp, ative a chave HSM e salve.
4. Em Ações > Template de HSM > Adicionar, informe o Template ID da Zenvia como código do template, uma descrição e as variáveis com o mesmo nome usado na Zenvia.
5. Configure as regras na aba SMS da forma de cobrança e a rotina Enviar SMS em Configuração > Geral > Rotinas.

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

Limitações

• Templates HSM não levam anexos. O PDF da fatura não vai pela Zenvia no WhatsApp.
• Uma integração com HSM ativo não serve para mensagens avulsas nem para a Central do Assinante.

Perguntas frequentes

Posso usar a Zenvia para SMS e para WhatsApp?

Sim. A integração envia SMS e WhatsApp, e o canal é definido pela URL informada nos parâmetros: uma para SMS e outra para WhatsApp.

Consigo enviar PDF pela Zenvia?

Não com templates HSM, que são mensagens estruturadas e não aceitam anexos.

Posso personalizar as mensagens?

Sim. As variáveis do template são trocadas pelos dados do cliente, e cada regra da forma de cobrança pode usar um template diferente.

Revisado em 10/10/2026.