Integracao com Hubla
Dispare templates de WhatsApp em eventos de pagamento da Hubla — compra aprovada, pagamento falhou, reembolso, assinatura expirada e carrinho abandonado.
A integracao com a Hubla dispara templates de WhatsApp automaticamente a partir dos eventos de pagamento e checkout da sua conta Hubla. O envio e imediato (sem delay) e usa os dados do comprador que vem no proprio evento.
Exemplos de uso:
- Compra aprovada → template de boas-vindas com o nome do comprador e link de acesso.
- Pagamento falhou → template com nova tentativa/segunda via.
- Carrinho abandonado → template de recuperacao com o link do checkout.
Pre-requisitos
- Conexao de WhatsApp ativa e plano Pro ou superior no UltronChat.
- Template de WhatsApp aprovado (status APPROVED).
- Conta na Hubla com acesso as configuracoes de webhooks/integracoes.
Eventos suportados
| Evento | Quando dispara |
|---|---|
Pagamento aprovado (invoice.payment_succeeded) | Compra confirmada |
Pagamento falhou (invoice.payment_failed) | Tentativa de cobranca recusada |
Fatura expirada (invoice.expired) | Fatura venceu sem pagamento |
Reembolso (invoice.refunded) | Compra reembolsada |
Carrinho abandonado (lead.abandoned_checkout) | Lead iniciou o checkout e nao concluiu |
Como configurar
- Abra Dashboard → sua conexao WhatsApp → Hubla.
- A pagina mostra a URL do webhook, unica desta conexao — copie e cadastre na Hubla (area de Integracoes/Webhooks da sua conta), inscrevendo os eventos que quiser usar.
- Na Hubla, copie o "Hubla Webhook Token" (em Integracoes → Autenticacao) e cole no campo correspondente da pagina do UltronChat. Esse token e usado para confirmar que os eventos vem mesmo da sua conta Hubla — eventos com token divergente sao descartados.
- Crie as regras: evento + (opcional) filtro por produto + template + mapeamento de variaveis.
Variaveis disponiveis
Nome (primeiro/ultimo/completo), email, telefone e documento do comprador; nome e id do produto; total, cupom e forma de pagamento da fatura; link do checkout (util no carrinho abandonado); e texto fixo.
Telefone do destinatario
O telefone vem do proprio evento da Hubla (dados do pagador/comprador). No
carrinho abandonado, so ha disparo se o lead preencheu o telefone antes de
abandonar — sem telefone, o evento fica SKIPPED. Numeros brasileiros sem
codigo do pais ganham 55 automaticamente.
Historico e solucao de problemas
O historico de disparos da pagina mostra cada evento com status SENT,
DELIVERED, READ, FAILED ou SKIPPED (com motivo). Os casos mais comuns:
- Nada em "historico" — o evento nao chegou: confira a URL cadastrada na Hubla e se o evento esta inscrito.
SKIPPEDcom motivo de token — o "Hubla Webhook Token" colado na UI nao bate com o da conta que enviou o evento. Recopie o token na Hubla.SKIPPEDpor plano — conta Essencial; faca upgrade para Pro.- Sem telefone no destinatario — o checkout nao coletou telefone.
Veja tambem: Integracoes — visao geral.