Integracao com Hotmart

A integracao com a Hotmart dispara templates de WhatsApp automaticamente a partir dos eventos de compra da sua conta Hotmart, com atraso configuravel por regra (imediato ate 7 dias) — ideal para sequencias como "boleto impresso agora, lembrete 24h depois".

Pre-requisitos

1. Conexao de WhatsApp ativa e plano Pro ou superior no UltronChat.
2. Template de WhatsApp aprovado (status APPROVED).
3. Conta Hotmart com acesso a Ferramentas → Webhook (App Postback), configurado na versao 2.0 (a versao 1 nao e aceita).

Eventos suportados

Evento	Quando dispara
PURCHASE_APPROVED	Compra aprovada
PURCHASE_COMPLETE	Compra concluida (apos garantia)
PURCHASE_BILLET_PRINTED	Boleto/PIX gerado
PURCHASE_EXPIRED	Compra expirada
PURCHASE_REFUNDED	Reembolso
PURCHASE_CANCELED	Compra cancelada
PURCHASE_OUT_OF_SHOPPING_CART	Carrinho abandonado
SUBSCRIPTION_CANCELLATION	Assinatura cancelada

Como configurar

1. Abra Dashboard → sua conexao WhatsApp → Hotmart.
2. Copie a URL do webhook, unica desta conexao, e cadastre na Hotmart em Ferramentas → Webhook (App Postback), versao 2.0, inscrevendo os eventos desejados.
3. Na Hotmart, copie o HOTTOK (token de autenticacao do webhook, na mesma tela) e cole no campo correspondente do UltronChat. Eventos com HOTTOK divergente sao descartados.
4. Crie as regras: evento + (opcional) filtro por produto + template + variaveis + agendamento (imediato, presets de 5 min a 72h, ou personalizado em minutos — maximo 7 dias).

Variaveis disponiveis

Nome (primeiro/completo), email, telefone e documento do comprador; nome e id do produto; transacao, valor total, forma de pagamento, status e link do boleto da compra; nome do plano e codigo do assinante da assinatura (para cancelamento); e texto fixo.

Telefone do destinatario

O telefone vem do checkout da Hotmart (campo de telefone do comprador; no cancelamento de assinatura, o telefone do assinante). Produto que nao coleta telefone no checkout → evento SKIPPED sem destinatario. Numeros brasileiros sem codigo do pais ganham 55 automaticamente.

Disparos agendados

Regras com atraso criam o disparo como QUEUED com o horario previsto visivel no historico. No momento do envio, o UltronChat re-valida tudo (regra ativa, integracao ativa, plano, template aprovado) — se algo mudou, o envio e cancelado com SKIPPED.

Historico e solucao de problemas

Cada evento vira uma linha no historico com status QUEUED, SENT, DELIVERED, READ, FAILED ou SKIPPED (com motivo). Casos comuns:

• Webhook retorna erro 400 na Hotmart — o App Postback esta na versao 1; migre para a 2.0.
• SKIPPED por HOTTOK invalido — o token colado na UI nao bate com o da conta Hotmart que enviou; recopie em Ferramentas → Webhook → Autenticacao.
• Disparo agendado nunca sai — confira se a regra e a integracao seguem ativas e se o template continua APPROVED (a re-validacao cancela com SKIPPED se algo mudou).
• SKIPPED por plano — conta Essencial; faca upgrade para Pro.

Veja tambem: Integracoes — visao geral.