Integração Kirvano + Leavo

Integração via Webhook – Kirvano + Leavo

1. Visão Geral

A Kirvano é uma plataforma de pagamentos e gestão de produtos digitais (infoprodutos), especializada em cursos online e e-books. A integração com o Leavo permite automatizar qualificação de compradores e gestão de assinaturas.

Casos de uso principais:

• Qualificar compradores após aprovação de pagamento
• Gerenciar carrinhos abandonados com follow-up inteligente
• Reengajar clientes com boletos/PIX vencidos
• Notificar equipe sobre chargebacks e reembolsos

Fluxos disponíveis:

• ✅ Kirvano → Leavo: Kirvano envia eventos de venda para o Leavo
• ❌ Leavo → Kirvano: Não suportado (sem API REST pública)

Diferencial: Plataforma brasileira com múltiplos eventos de pagamento (boleto, PIX, Nupay, PicPay).

2. Documentação Oficial

Kirvano:

• Configurando Integração via Webhook

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 Eventos da Kirvano

A Kirvano suporta 16 eventos de vendas e assinaturas:

Eventos mais relevantes: Compra aprovada, Carrinho abandonado, Assinatura cancelada

4. Como configurar webhooks

4.1 FLUXO: Kirvano 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: Kirvano - Compradores [Produto]
• Descrição: Recebe compradores da Kirvano
• Webhook ativo: LIGADO
• Clique em "Criar Webhook"

Passo 2: Configurar Webhook na Kirvano

2.1 Acessar seção de webhooks:

1. No painel Kirvano, vá em Integrações
2. Selecione Webhooks
3. Clique em "Criar Webhook"

2.2 Preencher campos:

⚠️ Token: Guarde este token - será usado para validação.

Passo 3: Estrutura do Payload da Kirvano

Exemplo de BANK_SLIP_GENERATED (Boleto gerado):

{
  "event": "BANK_SLIP_GENERATED",
  "event_description": "Boleto gerado",
  "checkout_id": "Q8J1N6K3",
  "sale_id": "D2RP8RQ7",
  "payment_method": "BANK_SLIP",
  "total_price": "R$ 169,80",
  "status": "PENDING",
  "customer": {
    "name": "João Silva",
    "document": "12345678900",
    "email": "joao.silva@example.com",
    "phone_number": "5511999999999"
  },
  "products": [
    {
      "id": "1bb763ee-4a35-416c-a577-eb1420234be1",
      "name": "Curso de Marketing Digital",
      "price": "R$ 169,80"
    }
  ],
  "utm": {
    "utm_source": "broadcast",
    "utm_campaign": "black-friday"
  }
}

Campos disponíveis:

• customer.name
• customer.email
• customer.phone_number
• products[0].name
• total_price
• payment_method

Passo 4: Mapear Campos no Leavo

4.1 Mapeamento:

4.2 Campos Personalizados:

💡 Dica: Use notação de ponto e array: customer.name, products[0].name

5. Observações e Limitações

5.1 Limitações da Kirvano

6. Troubleshooting

6.1 Webhook não funciona

6.2 Campos vazios

7. Casos de Uso

7.1 Recuperação de Carrinho Abandonado

Fluxo:

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

7.2 Follow-up de Boleto

Fluxo:

1. Boleto gerado (BANK_SLIP_GENERATED)
2. Lead criado no Leavo
3. 1 dia antes do vencimento, agente IA lembra
4. Dia do vencimento, último lembrete
5. Cliente paga boleto

Referências

• Kirvano Webhook
• Leavo