Vendas do checkout

Como conectar a Hotmart ao TraceClose

Atualizado em 12 de outubro de 2026

Passo a passo

1. Crie a conexão no TraceClose

   Em Configurações › Integrações, clique em Nova conexão e, no grupo Vendas do checkout, escolha Hotmart. Deixe a aba aberta: a tela mostra a URL do webhook (botão de copiar) e o campo Hottok.

2. Abra o Webhook na Hotmart

   Na Hotmart, entre com a conta do produtor e abra Ferramentas › Ver todas › Webhook (API e notificações). Se não achar, procure “Webhook” na busca do menu.

3. Copie o Hottok

   Na tela de Webhook, abra a aba de autenticação e copie o Hottok, o código que a Hotmart manda em cada notificação. Cole no campo Hottok do TraceClose.

4. Cadastre o webhook

   Clique em Cadastrar Webhook. Dê um nome (ex.: “TraceClose”), cole a URL do webhook do TraceClose em URL de envio, escolha todos os produtos ou um produto específico e marque os eventos: Compra aprovada, Compra reembolsada, Chargeback e Compra cancelada. Se a tela pedir a versão, use a mais recente (2.0.0). Salve.

5. Escolha as opções e salve

   Decida o envio do Purchase para a Meta (ligado por padrão; se o pixel do checkout já envia a compra, veja abaixo) e se o checkout não pago vira lead (desligado por padrão). Clique em Salvar.

6. Teste

   Na Hotmart, em Minhas configurações, abra o ícone de lista ao lado do webhook e envie o teste. A notificação aparece no TraceClose, na conexão, como último evento recebido.

Qual é a URL

O painel mostra a URL pronta, no formato https://t.traceclose.com/webhooks/sales/hotmart/<id-da-conexão>. Ela é única da sua conexão: não use a de outra conta nem a de outra plataforma.

Carrinho abandonado e boleto gerado (opcional)

Para o vendedor recuperar quem não pagou, ligue checkout não pago vira lead na conexão e marque também, na Hotmart, Abandono de carrinho e Aguardando pagamento. Esses eventos criam (ou acham) o lead com a origem, sem venda e sem Purchase. Se o comprador pagar depois, a venda entra no mesmo lead.

O que acontece no TraceClose

• Venda aprovada vira venda no TraceClose, com o valor pago e a moeda do pedido, creditada ao vendedor do lead. O lead vai para a etapa de ganho.
• O lead é achado pela referência do link de checkout, depois pelo telefone, depois pelo e-mail. Não achou: o lead é criado com a origem que o checkout guardou e entra no rodízio.
• Lead que já existia mantém a origem e o vendedor: quem veio de um anúncio de clique para WhatsApp continua creditado a esse anúncio.
• Reembolso e chargeback cancelam a venda. A mesma entrega reenviada pela plataforma não duplica nada.

Para a venda casar com o lead certo mesmo quando o comprador paga com outro e-mail ou telefone, use Copiar link de checkout no detalhe do lead: cole a URL do produto e o TraceClose acrescenta a referência do lead no parâmetro de rastreio da plataforma. Na Hotmart, a referência vai no parâmetro sck, que a Hotmart guarda na venda. Se você já usa o sck para outra coisa nesse link, o do TraceClose ocupa o lugar dele.

Se o pixel da Meta já está instalado no checkout da plataforma e envia o Purchase, escolha quem envia a compra: desligue o envio do Purchase nesta conexão com um clique (ou desligue o Purchase no pixel do checkout). Assim a Meta recebe a venda uma vez só, e ela continua entrando no painel e no ROAS.

Não funcionou? Veja…

• Nada chega: confira se a URL foi colada inteira e se o webhook está ativo na Hotmart. A Hotmart desativa a configuração sozinha quando a URL responde com erro várias vezes: corrija e ative de novo.
• A conexão mostra erro de autenticação: o Hottok colado no TraceClose é diferente do da Hotmart. Copie de novo e salve em Editar.
• Venda chegou, mas não foi para a Meta: veja a venda não aparece na Meta.
• A Hotmart guarda o histórico de envios por 60 dias e permite reenviar: na aba Histórico, ou em Vendas › Minhas vendas, no detalhe da venda.

Perguntas frequentes