Integração Hotmart + Leavo

Integração via Webhook – Hotmart + Leavo

1. Visão Geral

A Hotmart é uma das maiores plataformas de produtos digitais do mundo, especializada em infoprodutos. A integração com o Leavo permite automatizar a qualificação de compradores, assinantes e leads.

Casos de uso principais:

• Qualificar compradores após aprovação de pagamento
• Reengajar clientes que cancelaram assinaturas
• Notificar equipe sobre chargebacks e reembolsos
• Automatizar boas-vindas e onboarding de novos clientes

Fluxos disponíveis:

• ✅ Hotmart → Leavo: Hotmart envia eventos de compra/assinatura para o Leavo
• ⚠️ Leavo → Hotmart: Via API REST com OAuth2 (não webhook direto)

Diferencial: Plataforma consolidada com webhooks robustos e validação de assinatura nativa.

2. Documentação Oficial

Hotmart:

• Documentação Hotmart Developers
• Eventos de Pedido (Webhook 2.0)
• Autenticação OAuth2
• Ambiente Sandbox

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 Eventos da Hotmart (Webhook 2.0)

A Hotmart suporta múltiplos eventos relacionados a vendas e assinaturas:

Eventos mais relevantes: PURCHASE_APPROVED, PURCHASE_COMPLETE, PURCHASE_CANCELED

4. Como configurar webhooks

4.1 FLUXO 1: Hotmart enviando eventos para o Leavo

Passo 1: Criar Webhook de Entrada no Leavo

1. Acesse https://app.leavo.ai/pt-BR/ai-settings/webhooks
2. Clique na aba "Entrada" (ícone: ⬇️)
3. Clique em "+ Criar Webhook"

No modal:

• Nome: Hotmart - Compradores [Nome do Produto]
• Descrição: Recebe compradores da Hotmart para qualificação
• Webhook ativo: LIGADO
• Clique em "Criar Webhook"

Passo 2: Configurar Webhook na Hotmart

2.1 Acessar painel:

1. No painel da Hotmart, vá em Ferramentas
2. Clique em Webhook (Postback)
3. Clique em "+ Nova Configuração"

2.2 Configurar:

Passo 3: Estrutura do Payload da Hotmart

Exemplo de payload PURCHASE_APPROVED:

{
  "id": "1234567890123456789",
  "creation_date": 1702318800000,
  "event": "PURCHASE_APPROVED",
  "version": "2.0.0",
  "data": {
    "product": {
      "id": 987654,
      "name": "Curso Completo de Marketing Digital",
      "ucode": "abc-123-def"
    },
    "buyer": {
      "email": "joao.silva@example.com",
      "name": "João Silva",
      "checkout_phone": "+5511999999999",
      "document": "12345678900"
    },
    "purchase": {
      "transaction": "HP17715690036014",
      "status": "APPROVED",
      "full_price": {
        "value": 497.00,
        "currency_value": "BRL"
      },
      "payment": {
        "type": "CREDIT_CARD",
        "installments_number": 12
      }
    }
  }
}

Campos disponíveis:

• data.buyer.name - Nome do comprador
• data.buyer.email - Email
• data.buyer.checkout_phone - Telefone
• data.product.name - Nome do produto
• data.purchase.full_price.value - Valor da compra

Passo 4: Mapear Campos no Leavo

4.1 Mapeamento de Campos:

4.2 Campos Personalizados:

💡 Dica: Use notação de ponto para campos aninhados: data.buyer.name

Passo 5: Validação de Segurança

A Hotmart envia um header de validação:

⚠️ CRÍTICO: O Leavo valida automaticamente este token.

5. Observações e Limitações

5.1 Limitações da Hotmart

6. Troubleshooting

6.1 Webhook não recebe eventos

6.2 Campos vazios

7. Casos de Uso Práticos

7.1 Onboarding Automático

Objetivo: Qualificar novos compradores

Fluxo:

1. Cliente compra curso na Hotmart
2. PURCHASE_APPROVED enviado para Leavo
3. Lead criado com tag "Comprador"
4. Agente IA envia boas-vindas via WhatsApp
5. Qualifica satisfação e necessidades adicionais

7.2 Reengajamento de Cancelamentos

Objetivo: Recuperar clientes que cancelaram

Fluxo:

1. Cliente cancela assinatura (PURCHASE_CANCELED)
2. Lead criado no Leavo com status "Cancelou"
3. Após 3 dias, agente IA inicia contato
4. Oferece benefício exclusivo

Referências

• Hotmart Developers
• Webhook 2.0
• Painel Leavo