--- title: "Hotmart: pixel, UTM e webhook de vendas | Sparkle Tracker" description: "Integre a Hotmart ao Sparkle Tracker pelo webhook: cada compra aprovada volta ao anúncio de origem e segue para o Meta e o Google. Eventos e passo a passo." url: https://sparkletracker.com/integracoes/hotmart updated: 2026-11-12 language: pt-BR --- **INTEGRAÇÃO NATIVA** Hotmart # 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 [Teste grátis por 7 dias](https://sparkletracker.com/planos#planos) [Ver o passo a passo](https://sparkletracker.com/integracoes/hotmart#passo-a-passo) **8** eventos da Hotmart lidos pelo Sparkle **4** efeitos 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](https://sparkletracker.com/integracoes) do Sparkle Tracker. Atualizado em 6 de outubro de 2026 **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. Eventos do webhook da Hotmart e o efeito de cada um no Sparkle Tracker | 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. Como a origem do anúncio chega até a venda da Hotmart | 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 1. No painel do Sparkle, abra **Integrações**, encontre o cartão **Hotmart** e clique em **Ativar integração**. 2. 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 1. Na Hotmart, abra **Ferramentas** e procure por **Credenciais Hotmart** (pode aparecer em inglês, como "Hotmart Credentials"). 2. Clique em **Criar credencial** e dê um nome. Deixe a opção **Sandbox** desmarcada: credencial de teste não lê vendas reais. 3. Na credencial criada, copie o **Client ID** e o **Client Secret**. 4. 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 1. 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. 2. Na Hotmart, abra **Ferramentas › Webhook (API e Notificações)** e clique em **Cadastrar webhook**. 3. Em **Nome**, escreva um nome que identifique a operação. 4. Em **Produto**, escolha o produto vendido nessa operação. 5. Em **URL para envio de dados**, cole o link copiado do Sparkle. 6. Em **Versão**, escolha **2.0.0**. 7. 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 1. Faça uma compra de teste, ou use o botão de teste do webhook, se o painel tiver. 2. No Sparkle, abra **Logs de Eventos**: a chamada aparece em poucos segundos. 3. 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](https://docs.sparkletracker.com/hotmart). 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. ### 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. ### 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 Kiwify** Eventos e passo a passo do webhook da Kiwify](https://sparkletracker.com/integracoes/kiwify)[**Integração Eduzz** Eventos e passo a passo do webhook da Eduzz](https://sparkletracker.com/integracoes/eduzz)[**Integração Cakto** Eventos e passo a passo do webhook da Cakto](https://sparkletracker.com/integracoes/cakto)[**Trackeamento de vendas** Como a venda do gateway é ligada ao lead e ao anúncio](https://sparkletracker.com/trackeamento-de-vendas)[**Todas as integrações** Gateways, e-commerces, pixels, CRMs, API e webhooks](https://sparkletracker.com/integracoes)[**Trackeamento de venda direta** Página de vendas e checkout, sem WhatsApp no meio](https://sparkletracker.com/venda-direta) 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. É a conexão pelo webhook da Hotmart que liga cada venda ao anúncio de origem. A Hotmart avisa o Sparkle Tracker a cada compra, boleto, carrinho abandonado e reembolso; o Sparkle encontra o lead pelo telefone ou e-mail e mostra a venda no painel com a campanha, o conjunto e o criativo, além de enviar a compra ao Meta e ao Google. Sai. Os eventos de compra reembolsada, chargeback e compra cancelada descontam o valor do faturamento, para o ROAS e o lucro do anúncio não ficarem inflados. As integrações com checkouts e gateways de pagamento fazem parte dos planos Pro, Expert e Growth. [Ver os planos](https://sparkletracker.com/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. [Iniciar o teste grátis](https://sparkletracker.com/planos#planos) --- Versão em Markdown de https://sparkletracker.com/integracoes/hotmart para agentes de IA. Índice do site: https://sparkletracker.com/llms.txt