Integração Hub.la + Leavo

Integração via Webhook – Hub.la + Leavo

1. Visão Geral

A Hub.la é uma plataforma de vendas e gestão de infoprodutos focada em criadores de conteúdo e empreendedores digitais. A integração com o Leavo permite automatizar qualificação e follow-up de compradores.

Casos de uso principais:

• Qualificar compradores após pagamento confirmado
• Gerenciar assinaturas e renovações
• Reengajar clientes com faturas vencidas
• Notificar sobre carrinhos abandonados

Fluxos disponíveis:

• ✅ Hub.la → Leavo: Hub.la envia eventos para o Leavo
• ❌ Leavo → Hub.la: Não suportado (sem API REST pública)

Diferencial: Sistema de idempotência robusto e múltiplos eventos de assinatura.

2. Documentação Oficial

Hub.la:

• Integrações de webhook
• Eventos v2.0.0
• Boas práticas

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 Eventos da Hub.la (v2.0.0)

A Hub.la organiza eventos por categoria:

Lead:

• Carrinho Abandonado

Assinatura:

• Assinatura criada
• Assinatura ativada
• Assinatura expirada
• Assinatura desativada

Fatura:

• Fatura criada
• Pagamento da fatura realizado
• Pagamento da fatura falhou
• Fatura reembolsada

Eventos recomendados para Leavo: ✅ Pagamento da fatura realizado, Carrinho Abandonado, Assinatura desativada

4. Como configurar webhooks

4.1 FLUXO: Hub.la 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"
3. Clique em "+ Criar Webhook"

No modal:

• Nome: Hub.la - Compradores [Produto]
• Descrição: Recebe compradores da Hub.la
• Webhook ativo: LIGADO
• Clique em "Criar Webhook"

Passo 2: Configurar Webhook na Hub.la

2.1 Ativar integração:

1. No painel Hub.la, vá em Integrações
2. Selecione "Webhooks"
3. Clique em "Ativar Integração"

⚠️ IMPORTANTE: Um token de autenticação será gerado. GUARDE ESTE TOKEN.

2.2 Criar regra:

Passo 3: Estrutura do Payload da Hub.la

Exemplo de invoice.payment_succeeded:

{
  "event": "invoice.payment_succeeded",
  "data": {
    "customer": {
      "id": "cust_xyz789",
      "name": "João Silva",
      "email": "joao.silva@example.com",
      "phone": "+5511999999999"
    },
    "invoice": {
      "status": "paid",
      "amount": 197.00,
      "currency": "BRL"
    },
    "subscription": {
      "plan_name": "Plano Premium Mensal",
      "status": "active"
    },
    "product": {
      "name": "Curso de Marketing Digital"
    }
  }
}

Campos disponíveis:

• data.customer.name
• data.customer.email
• data.customer.phone
• data.invoice.amount
• data.product.name

Passo 4: Mapear Campos no Leavo

4.1 Mapeamento:

4.2 Campos Personalizados:

Passo 5: Validação de Segurança

A Hub.la envia 2 headers importantes:

x-hubla-token: Valida autenticidade do webhook x-hubla-idempotency: Evita processamento duplicado

5. Observações e Limitações

5.1 Limitações da Hub.la

6. Troubleshooting

6.1 Webhook não funciona

6.2 Eventos duplicados

Solução: Use x-hubla-idempotency para deduplicar

7. Casos de Uso

7.1 Recuperação de Carrinho Abandonado

Fluxo:

1. Cliente abandona carrinho (cart.abandoned)
2. Hub.la envia para Leavo
3. Lead criado com tag "Carrinho-Abandonado"
4. Após 1 hora, agente IA envia mensagem
5. Oferece desconto de 10%

7.2 Gestão de Renovações

Fluxo:

1. Fatura falha (invoice.payment_failed)
2. Hub.la notifica Leavo
3. Lead criado com status "Pagamento-Pendente"
4. Agente IA contata cliente
5. Ajuda a resolver problema de pagamento

Referências

• Hub.la Webhooks
• Eventos v2.0.0
• Leavo