Checkouts e plataformas de venda

Com a plataforma de venda ligada, cada checkout iniciado, pagamento pendente, compra e reembolso chega ao Leadz como evento. O evento atualiza o contato, registra a negociação e pode iniciar um funil. O Leadz não lê a sua conta da plataforma sozinho: alguém precisa avisar, e há dois caminhos para isso.

#Escolher o caminho

Use o Tracker quando você anuncia e quer saber de qual anúncio veio cada venda. Use o webhook quando não usa o Tracker ou quando quer controlar cada campo.

#Caminho 1: pelo Sparkle Tracker (recomendado)

O Tracker se conecta a plataformas como Hotmart, Kiwify, Monetizze e Eduzz. A lista completa e o passo a passo de cada uma ficam no próprio Tracker.

Por esse caminho chegam Checkout Iniciado, Pagamento Pendente, compra aprovada e reembolso. Pix e boleto chegam os dois como Pagamento Pendente. A compra aprovada fecha sozinha a negociação aberta pelo checkout.

#Caminho 2: por webhook direto

Vale para qualquer plataforma que envie webhook. O Leadz não tem um modelo pronto por plataforma: você envia um evento de teste e mapeia os campos do JSON que chegou.

O passo a passo completo da tela está em Webhooks de entrada.

#Exemplo: compra aprovada da Hotmart

Este exemplo usa o formato de evento de compra aprovada da Hotmart (versão 2.0.0), com dados fictícios. Confira sempre no seu evento de teste: o que vale é o JSON que chegou no seu webhook.

{
  "id": "3f0e7c1a-0000-4000-8000-000000000001",
  "event": "PURCHASE_APPROVED",
  "version": "2.0.0",
  "data": {
    "buyer": {
      "email": "ana@exemplo.com",
      "first_name": "Ana",
      "last_name": "Lima",
      "checkout_phone": "5511999990000"
    },
    "purchase": {
      "transaction": "HP0000000001",
      "status": "APPROVED",
      "price": { "value": 197.0, "currency_value": "BRL" }
    }
  }
}

Mapeie assim:

Depois, em Configurar:

Para Kiwify, Monetizze, Eduzz e outras plataformas, o caminho é o mesmo. Só mudam os nomes dos campos no JSON, que você vê no evento de teste.

#Como a negociação é registrada

Estas regras valem para o caminho 2, por webhook:

• Sem valor mapeado, não há negociação. O contato é criado ou atualizado, e só.
• Sem Situação mapeada, a negociação entra concluída. O webhook sempre significou uma venda que aconteceu.
• A Situação entende estas palavras, em maiúsculas ou minúsculas:

#Unir checkout e compra na mesma negociação

Por webhook, a compra só fecha a negociação aberta pelo checkout quando as quatro condições valem:

1. Os dois eventos chegam no mesmo endereço de webhook.
2. O número do pedido está mapeado em Chave da negociação e é igual nos dois eventos.
3. O primeiro evento abriu a negociação como em aberto.
4. A compra chega em até 30 dias depois do checkout.

Fora disso, cada evento vira uma negociação separada.

Uma negociação reembolsada não volta a concluída por um evento que chegue depois. Para reverter, altere a negociação na ficha do contato.

#Montar um funil de recuperação

Ligar a plataforma faz o evento chegar. As mensagens, os tempos e os templates são seus, montados no editor de funil.

• Pelo Tracker, use o gatilho Evento do Sparkle Tracker e escolha Pagamento Pendente ou Checkout Iniciado em Eventos personalizados da conta.
• Por webhook, use o gatilho Entrada via webhook e escolha o webhook da plataforma.

A compra fecha a negociação, mas não interrompe sozinha um funil que já está rodando. Coloque uma condição ou um bloco Aguardar Evento antes de cada mensagem, para não cobrar quem já pagou.

#Limites que você precisa conhecer

• O Leadz não tem integração direta com a conta de nenhuma plataforma de venda. Sem o Tracker, tudo chega por webhook e mapeamento.
• Não existe modelo de funil de recuperação pronto. Você monta o seu.
• Sem telefone no evento, a mensagem de WhatsApp não sai. Confira se a sua página de pagamento pede esse campo.
• Pelo Tracker, Pix e boleto não são separados: os dois chegam como Pagamento Pendente.

#Problemas comuns

A compra chegou, mas a negociação do checkout continua em aberto

Falta uma das quatro condições de «Unir checkout e compra». O mais comum é a Chave da negociação não estar mapeada, ou o checkout e a compra chegarem em endereços diferentes.

A negociação entrou com o valor 100 vezes maior

A plataforma envia o valor em centavos e o campo foi mapeado para Valor. Mapeie para Valor em centavos.

O pagamento pendente foi registrado como venda concluída

A palavra que a plataforma usa para a situação não está na lista aceita, ou a Situação não foi mapeada. Veja a tabela de palavras acima.

A plataforma reenviou o evento e a negociação duplicou

Preencha Deduplicação — campo do ID do evento com o campo do número do pedido. Um reenvio idêntico deixa de ser processado de novo.

A plataforma recebe erro 401 ao enviar

O endereço foi cadastrado sem o token. Copie de novo pelo botão Copiar e cole o endereço inteiro.

#Veja também

• Sparkle Tracker
• Webhooks de entrada
• Postbacks