Taxa e comissão de cada venda
O Sparkle busca quanto ficou com a plataforma e mostra a receita líquida, que é a base do lucro e do ROAS líquido.
INTEGRAÇÃO NATIVAHotmart
Integração com a Hotmart: pixel, UTM e webhook com a venda no anúncio certo
A Hotmart avisa o Sparkle Tracker a cada compra. O Sparkle liga a venda ao lead, mostra de qual campanha, conjunto e criativo ela veio e envia a compra para o Meta e o Google.
Webhook e API
Compra enviada ao Meta e ao Google
A partir do plano Pro
Hotmart para o Sparkle Tracker
Webhook
Compra aprovadaPURCHASE_APPROVED
VendaBoleto impressoPURCHASE_BILLET_PRINTED
AguardandoAbandono de carrinhoPURCHASE_OUT_OF_SHOPPING_CART
CheckoutCompra reembolsadaPURCHASE_REFUNDED
ReembolsoEventos do webhook da Hotmart
8eventos da Hotmart lidos pelo Sparkle
4efeitos no painel: venda, aguardando, checkout e reembolso
Resposta rápida
Como rastrear as vendas da Hotmart por anúncio?
Para saber de qual anúncio veio cada venda da Hotmart, cadastre na Hotmart o link de webhook do Sparkle Tracker. A cada compra, a Hotmart avisa o Sparkle, que liga a venda ao lead pelo telefone ou pelo e-mail do comprador.
O lead já tem a campanha, o conjunto e o criativo do clique. A venda aparece no painel com essa origem e segue para o Meta e para o Google como compra. É uma das integrações nativas do Sparkle Tracker.
Atualizado em
Webhook e API da Hotmart
Oito eventos lidos, da venda ao reembolso
Venda com campanha, conjunto e criativo
O que chega
Quais eventos da Hotmart o Sparkle Tracker recebe?
São os eventos que você marca ao cadastrar o webhook na Hotmart. Cada um tem um efeito diferente no painel.
| Evento na Hotmart | No Sparkle Tracker | Efeito |
|---|---|---|
| Compra aprovada PURCHASE_APPROVED | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Compra completa PURCHASE_COMPLETE | Venda aprovada | Entra no faturamento e envia a compra (Purchase) para o Meta e o Google |
| Boleto impresso PURCHASE_BILLET_PRINTED | Aguardando pagamento | Mostra quem gerou Pix ou boleto e ainda não pagou. Não conta como venda |
| Compra atrasada PURCHASE_DELAYED | Aguardando pagamento | Mostra quem gerou Pix ou boleto e ainda não pagou. Não conta como venda |
| Abandono de carrinho PURCHASE_OUT_OF_SHOPPING_CART | Iniciou checkout | Mostra quem abriu o checkout e não comprou. Não conta como venda |
| Compra reembolsada PURCHASE_REFUNDED | Reembolso | Desconta o valor do faturamento |
| Chargeback PURCHASE_CHARGEBACK | Chargeback | Desconta o valor do faturamento |
| Compra cancelada PURCHASE_CANCELED | Cancelamento | Desconta o valor do faturamento |
Pixel e UTM
Pixel no checkout da Hotmart ou venda pelo webhook?
O pixel no checkout depende do navegador do comprador. O webhook sai do servidor da Hotmart e chega ao Sparkle com a venda confirmada.
| Pergunta | Como funciona com o Sparkle Tracker |
|---|---|
| Quem avisa que a venda aconteceu | A Hotmart, pelo webhook, de servidor para servidor. Não depende do navegador nem de a pessoa voltar para a página de obrigado. |
| Como a venda acha o anúncio | Pelo telefone ou e-mail do comprador, que o Sparkle compara com o lead. O lead já carrega a campanha, o conjunto e o criativo do primeiro clique. |
| Para onde vão as UTMs | Na Venda Direta, o script do Sparkle guarda as UTMs por 30 dias e acrescenta UTMs, src, sck e xcod em todo link que leva ao checkout. O checkout guarda esses campos e devolve na venda. |
| O que volta para o Meta e o Google | A compra (Purchase) com a origem, enviada pelo Sparkle. Para o Google Ads, a conversão vai quando o clique veio de um anúncio do Google. |
| Pix e boleto pagos depois | Entram como Aguardando pagamento quando são gerados e viram venda quando a Hotmart confirma o pagamento. |
A venda confirmada pelo gateway não depende do que o navegador deixou passar.
Passo a passo
Como integrar a Hotmart ao Sparkle Tracker
Você precisa de uma operação criada no Sparkle e de acesso de administrador ou produtor na Hotmart, além de Client ID e Client Secret.
1Ative a integração no Sparkle
- No painel do Sparkle, abra Integrações, encontre o cartão Hotmart e clique em Ativar integração.
- Em Operação, escolha de qual operação são as vendas e clique em Continuar.
Cada operação tem um link de webhook próprio. Para vender em mais de uma operação, gere um link para cada.
2Gere as credenciais na Hotmart
- Na Hotmart, abra Ferramentas e procure por Credenciais Hotmart (pode aparecer em inglês, como "Hotmart Credentials").
- Clique em Criar credencial e dê um nome. Deixe a opção Sandbox desmarcada: credencial de teste não lê vendas reais.
- Na credencial criada, copie o Client ID e o Client Secret.
- Volte ao Sparkle, cole os dois valores e clique em Testar e ativar. A conexão é testada na hora.
Há dois campos opcionais. O Basic pode ficar em branco, porque o Sparkle calcula esse valor com o Client ID e o Client Secret. O Hottok fica em Ferramentas, Webhook (API e Notificações), na parte de Autenticação.
3Crie o webhook na Hotmart
- No Sparkle, copie o link que apareceu com o selo NOVO. Copie pelo botão ao lado do link, sem montar o endereço à mão.
- Na Hotmart, abra Ferramentas › Webhook (API e Notificações) e clique em Cadastrar webhook.
- Em Nome, escreva um nome que identifique a operação.
- Em Produto, escolha o produto vendido nessa operação.
- Em URL para envio de dados, cole o link copiado do Sparkle.
- Em Versão, escolha 2.0.0.
- Marque os eventos da tabela acima e salve o webhook.
Sem os eventos de reembolso e chargeback marcados, a venda devolvida continua no faturamento.
4Teste com uma compra
- Faça uma compra de teste, ou use o botão de teste do webhook, se o painel tiver.
- No Sparkle, abra Logs de Eventos: a chamada aparece em poucos segundos.
- Abra Leads Capturados e clique no comprador. Em Histórico de ações, a venda aparece com gateway, produto e valor.
O guia com as telas está na documentação: integração Hotmart no Sparkle Tracker.
Além do webhook
O que as credenciais de API da Hotmart acrescentam?
O webhook traz a venda. Com Client ID e Client Secret salvos, o Sparkle também lê a Hotmart pela API.
Venda que o webhook perdeu
Todo dia, à meia-noite, o Sparkle confere as vendas na Hotmart e recupera a que não chegou pelo webhook.
Reembolso e chargeback em dia
A venda devolvida é atualizada e sai do faturamento, para o resultado do anúncio não ficar inflado.
Hottok, para aceitar só a sua conta
O Hottok é um código da sua conta na Hotmart. Com ele salvo no Sparkle, só é aceita a venda que chega com o mesmo valor. O campo é opcional.
Do mesmo assunto
Outras integrações e o que fazer com a venda
Integração KiwifyEventos e passo a passo do webhook da Kiwify
Integração EduzzEventos e passo a passo do webhook da Eduzz
Integração CaktoEventos e passo a passo do webhook da Cakto
Trackeamento de vendasComo a venda do gateway é ligada ao lead e ao anúncio
Todas as integraçõesGateways, e-commerces, pixels, CRMs, API e webhooks
Trackeamento de venda diretaPágina de vendas e checkout, sem WhatsApp no meio
FAQs
Dúvidas sobre a integração Hotmart
Ative a integração Hotmart no painel do Sparkle Tracker e escolha a operação. Cole as credenciais de API (Client ID e Client Secret), copie o link de webhook gerado e cadastre esse link no painel da Hotmart, marcando os eventos de venda, pagamento pendente e reembolso. Uma compra de teste confirma se a venda chegou.
São oito: compra aprovada, compra completa, boleto impresso, compra atrasada, abandono de carrinho, compra reembolsada, chargeback e compra cancelada. Cada um vira um efeito no painel: venda aprovada, aguardando pagamento, início de checkout ou reembolso.
São caminhos diferentes. O pixel colocado no checkout roda no navegador do comprador. A integração do Sparkle Tracker recebe a venda do servidor da Hotmart e envia a compra ao Meta e ao Google com o anúncio de origem. Assim a compra chega às plataformas mesmo quando o navegador bloqueia o pixel ou quando o Pix é pago depois.
A versão 2.0.0. É a que o passo a passo do Sparkle Tracker pede no campo Versão, na tela de cadastro do webhook da Hotmart. Depois de escolher a versão, marque os oito eventos da lista e salve.
Há duas causas comuns. O comprador usou no checkout um telefone ou e-mail diferente do que tinha como lead, e a venda entrou como um lead novo de Venda Direta. Ou o anúncio estava sem o modelo de UTM nos parâmetros de URL. O modelo fica em Operações e UTMs, na aba UTMs.
Dá. Em Integrações, Hotmart, Gerenciar, clique em Novo link, escolha a operação e gere o link. Depois crie outro webhook na Hotmart com esse link. O limite de links é o número de operações do seu plano.
As integrações com checkouts e gateways de pagamento fazem parte dos planos Pro, Expert e Growth. Ver os planos.
Veja de qual anúncio veio a próxima venda da Hotmart.
Ative a integração, cadastre o webhook e acompanhe a venda voltar ao criativo de origem. 7 dias grátis no plano mensal.