Conectar checkout com IA: Hotmart, Kiwify, Eduzz e Cakto ligados pela conversa

Por que ligar o checkout ao rastreamento?

Porque sem o checkout você sabe quantas pessoas clicaram e entraram, mas não quem comprou. A venda é o único número que paga a conta, e ela acontece em outro sistema.

Quando o checkout está ligado, ele avisa o Sparkle a cada compra pelo webhook, de servidor para servidor. O Sparkle liga a venda ao lead pelo telefone ou pelo e-mail do comprador, e o lead já carrega a campanha, o conjunto e o criativo do clique. É assim que a venda de um grupo de WhatsApp, de uma conversa 1x1 ou de uma página de vendas chega com a origem. O caminho completo está em trackeamento de vendas.

O problema é a configuração. Cada gateway tem a tela de webhook num lugar, chama os eventos de um jeito e pede chaves diferentes. É aqui que a IA ajuda: ela traz o roteiro certo para o gateway que você usa, na hora em que você precisa.

E o ganho aparece logo depois. Com o checkout ligado, a mesma conversa responde qual anúncio vendeu mais com a venda que o gateway confirmou, e não com a conversão que a Meta atribui a si mesma.

O que a IA faz e o que fica com você?

A IA faz a parte do Sparkle. A parte do gateway é feita por você, no painel dele, com o roteiro que ela entrega.

A IA não apaga integração, não troca o link de webhook e não desconecta nada. Quando é preciso, ela manda o link da tela certa do painel e a ação fica com você.

Como conectar checkout com IA, passo a passo

1. Diga a operação. A operação é obrigatória: cada operação tem o seu link de webhook, e é por ele que a venda cai no funil certo. Para vender o mesmo produto em duas operações, são dois links. Se ainda não tem operação, peça à IA para criar.
2. Peça o gateway. "Ligue a Kiwify na operação Desafio 7 Dias." A IA confere se o seu plano libera aquela integração antes de ligar.
3. Copie o link e siga o roteiro. A IA mostra o link de webhook, onde colar no gateway e quais eventos marcar. Em alguns gateways vêm blocos extras, como o corpo JSON das automações da HeroSpark e a dica de onde colar o link na Cartpanda, na Digistore24 e na Clickbank.
4. Cole as chaves no bloco seguro. Nos gateways com leitura por API, a IA abre um bloco do Sparkle para as chaves. Você cola ali, e elas vão direto para o Sparkle.
5. Teste. Peça "teste a conexão do gateway". Depois faça uma compra de teste, confira a chamada em Logs de Eventos e pergunte à IA se a venda chegou com a origem.

Veja como fica numa conversa:

ClaudeSparkle Tracker conectado

Ligue a Hotmart na operação Mentoria Elite.

Conectou o gateway

Pronto. O link de webhook da Mentoria Elite está no bloco abaixo, com o botão de copiar. Na Hotmart, abra Ferramentas › Webhook (API e Notificações), cadastre um webhook com esse link, escolha o produto da mentoria e a versão 2.0.0. Marque os 8 eventos, entre eles:

Evento na HotmartNo Sparkle

Compra aprovadaVenda

Boleto impressoAguardando

Compra reembolsadaReembolso

Para trazer a taxa de cada venda, abri um bloco seguro para o Client ID e o Client Secret. Eu não vejo o que você colar.

Colei as chaves e salvei o webhook.

Testou o gateway

Testei a conexão com a Hotmart. Agora falta a prova que conta: faça uma compra de teste e confira no painel, em Logs de Eventos, se a chamada da Hotmart apareceu. Depois me pergunte se a venda chegou com a campanha de origem.

Exemplo de conversa

Pedidos prontos para copiar, trocando os nomes pelos seus:

• Ligue a [gateway] na operação [nome da operação] e me mostre o link de webhook, onde colar e quais eventos marcar.

  Copiar

• Quais gateways estão ligados em cada uma das minhas operações? Falta algum?A IA lê o resumo da conta.

  Copiar

• A última venda da [gateway] chegou? Veio com campanha, conjunto e anúncio?Depois da compra de teste.

  Copiar

Quais eventos marcar em cada checkout?

Cada gateway dá um nome diferente para os eventos, mas no Sparkle eles viram quatro efeitos. A IA mostra a lista do gateway que você está ligando, com os que são opcionais.

Não pule os eventos de reembolso e chargeback. Sem eles, a venda devolvida continua no faturamento, e o ROAS do anúncio fica maior do que é. O guia ROAS real com IA mostra como esses descontos entram na conta.

As listas completas, com o nome de cada evento no gateway, estão nas páginas de integração: Hotmart, Kiwify, Eduzz e Cakto.

Quais checkouts dá para conectar pela IA?

Os mesmos do card de Integrações do painel. A IA usa o mesmo roteiro de cada gateway, então o que funciona no painel funciona na conversa.

• Gateways de pagamento: Hotmart, Kiwify, Eduzz, Monetizze, Cakto, Perfect Pay, Kirvano, Braip, Ticto, Guru, Doppus, Hubla, Lastlink, HeroSpark, Payt, TriboPay, AppMax, Mundpay, B4you, Pepper, Greenn, InovaPag e Vega.
• E-commerces e marketplaces: Yampi, Cartpanda, Logzz, Digistore24 e Clickbank.

Todos estão listados em Integrações. Quando a venda acontece fora de um checkout, como num CRM ou num formulário próprio, o caminho é o webhook de entrada, que a IA também configura pela conversa.

Integrações de checkout a partir do plano Pro. A conexão com a IA também. Teste o plano Pro por 7 dias e ligue o seu checkout pela conversa.

Como as chaves do gateway chegam ao Sparkle?

Por um bloco seguro do Sparkle, nunca pelo texto da conversa. A IA abre o bloco dentro do chat, ou manda um link, e você cola as chaves ali.

• Vale 10 minutos e um envio. Passou o prazo ou já foi usado, a IA abre outro. Depois de 5 tentativas erradas, o link morre.
• A IA não vê o valor. As chaves vão direto para o Sparkle e não voltam em nenhuma resposta.
• Se alguém pedir a chave no chat, não cole. A IA conectada ao Sparkle não pede senha nem chave na conversa.

Para que servem as chaves, se o webhook já traz a venda? Nos gateways com leitura por API, como Hotmart, Kiwify e Cakto, elas trazem a taxa de cada venda, que é a base da receita líquida e do ROAS líquido. Na Hotmart, também servem para recuperar a venda que o webhook não entregou e manter reembolsos em dia.

Como saber se a venda está chegando?

1. Peça o teste da conexão. A IA testa a ligação com o gateway e avisa que testou. Esse teste é o começo, não a prova.
2. Faça uma compra de teste. Ou use o botão de teste do webhook, se o gateway tiver.
3. Abra Logs de Eventos no painel. A chamada do gateway aparece ali em poucos segundos. Se não apareceu, o problema está no cadastro do webhook no gateway.
4. Pergunte à IA. "A última venda da Hotmart chegou? Veio com campanha e anúncio?" Ela lê os leads, com telefone e e-mail mascarados, e o Dashboard. Em Leads Capturados, o histórico do comprador também mostra gateway, produto e valor.

Venda que chegou sem campanha quase sempre tem uma de duas causas: o comprador usou no checkout um telefone ou e-mail diferente do que deixou como lead, ou o anúncio estava sem o modelo de UTM. Na venda direta, o script do Sparkle também leva as UTMs e os campos src, sck e xcod para todo link que vai ao checkout, o que ajuda a ligar a venda mesmo quando o contato muda.

Quais são os erros mais comuns?

• Webhook da operação errada. O link de uma operação colado no produto de outra joga a venda no funil errado. Um link por operação, sempre copiado pelo botão.
• Eventos de reembolso desmarcados. A venda devolvida segue contando no faturamento.
• Versão do webhook. Na Hotmart, a versão pedida é a 2.0.0.
• Credencial de teste. Na Hotmart, credencial criada como Sandbox não lê vendas reais.
• Chave colada no chat. Se aconteceu, gere uma chave nova no gateway e cole a nova no bloco seguro.

Com o checkout ligado, o próximo passo é a compra voltar para a Meta com a origem. Se o pixel ainda não está pronto, o guia configurar pixel com IA faz esse passo na mesma conversa. Para conectar a IA, comece por conectar o Claude.