Conectar Hotmart (e-commerce)

O Implementaê recebe os eventos de vendas e carrinho abandonado da Hotmart por webhook e sincroniza automaticamente com o ActiveCampaign — incluindo recuperação de carrinho. Este guia mostra a conexão de ponta a ponta.

O que você vai precisar

Conta ativa na Hotmart com acesso a Ferramentas → Credenciais
Conta no Implementaê com o ActiveCampaign já conectado
As credenciais de um App da Hotmart (Client ID e Client Secret — criamos no Passo 2)

Como a Hotmart autentica? O Implementaê usa OAuth2 client_credentials: com o Client ID e o Client Secret do seu App, geramos um token de leitura da API da Hotmart. Não há login com redirecionamento — você só cola as duas credenciais e validamos na hora.

As mesmas credenciais servem para a Hotmart e-commerce e para a Hotmart Club. Se você já conectou uma, a outra reaproveita a conexão.

Passo 1 — Abra o wizard no Implementaê

Acesse hub.implementae.com → Integrações
Clique em Conectar no card da Hotmart
O wizard tem 4 etapas: credenciais → webhook de carrinho → webhook de pedidos → concluído.

Passo 2 — Crie o App e copie as credenciais

O Client ID e o Client Secret ficam em Ferramentas → Credenciais, dentro de um App que você cria na Hotmart.

Na Hotmart, acesse Ferramentas → Credenciais Developers (app.hotmart.com/tools/applications), logado com o usuário principal da conta produtora do curso.
Clique em Criar Credencial e dê um nome a ela.
No campo Tipo, deixe a opção Sandbox desmarcada. Credencial de Sandbox é de teste: a Hotmart emite o token, mas nega a leitura de produtos, vendas e cursos em produção. O tipo não pode ser alterado depois; se errar, crie outra.
Copie o Client ID e o Client Secret gerados. O Client Secret só aparece nessa hora.

O botão Abrir painel de credenciais da Hotmart no rodapé do wizard leva direto a essa tela.

Passo 3 — Cole as credenciais e valide

De volta ao wizard do Implementaê:

Cole o Client ID e o Client Secret nos campos correspondentes.
Opcional: dê um nome de exibição à conexão (ex.: Minha Conta Hotmart).
Clique em Validar e continuar. Validamos as credenciais na hora junto à API da Hotmart.

Campo	Onde encontrar
Client ID	Hotmart → Ferramentas → Credenciais → seu App
Client Secret	Mesmo App — copie o Client Secret
Nome de exibição	Opcional — só para identificar a conexão no Hub

Se aparecer Credenciais inválidas, confira os dois valores no painel da Hotmart (Ferramentas → Credenciais). Cole exatamente, sem espaços extras.

Se aparecer que a Hotmart não libera leitura de dados em Produção, a credencial é de Sandbox ou foi gerada fora da conta produtora. Crie uma nova com Sandbox desmarcado.

Para trocar as credenciais depois de conectar, abra o wizard e clique em 1. Credenciais na barra de etapas. Os webhooks já configurados continuam valendo.

Passo 4 — Configure o Webhook 1 (carrinho abandonado)

A Hotmart não cria webhooks por API — configure manualmente no painel e cole o HOTTOK gerado.

No wizard, copie a URL do webhook de carrinho (botão Copiar).
Acesse o painel de webhooks da Hotmart.
Crie um webhook com a URL copiada.
Selecione o evento:

Evento	Descrição
`PURCHASE_OUT_OF_SHOPPING_CART`	Compra fora do carrinho (carrinho abandonado)

Salve e copie o HOTTOK exibido pela Hotmart.
Volte ao wizard, cole o HOTTOK e clique em Salvar HOTTOK e continuar.

O HOTTOK é o token que a Hotmart envia em cada webhook para provar a origem. Cada webhook (carrinho e pedidos) tem o seu — cole o correto em cada etapa.

Passo 5 — Configure o Webhook 2 (status de pedidos)

Repita o processo com a segunda URL (pedidos) e a lista de eventos abaixo.

No wizard, copie a URL do webhook de pedidos.
No painel de webhooks da Hotmart, crie um segundo webhook com essa URL.
Selecione os eventos:

Evento	Descrição	Recomendado
`PURCHASE_APPROVED`	Compra aprovada	✅ Sim
`PURCHASE_COMPLETE`	Compra concluída	✅ Sim
`PURCHASE_BILLET_PRINTED`	Boleto emitido (aguardando pagamento)	✅ Sim
`PURCHASE_CANCELED`	Compra cancelada	✅ Sim
`PURCHASE_EXPIRED`	Pagamento expirado	✅ Sim
`PURCHASE_REFUNDED`	Reembolsado	✅ Sim
`PURCHASE_CHARGEBACK`	Chargeback	✅ Sim
`PURCHASE_DELAYED`	Pagamento em processamento	Opcional
`PURCHASE_PROTEST`	Pagamento em contestação	Opcional

Salve, copie o HOTTOK desse segundo webhook e cole no wizard.
Clique em Salvar HOTTOK e continuar.

Configure os dois webhooks. Sem o de carrinho, as automações de carrinho abandonado não disparam; sem o de pedidos, o status das vendas não é atualizado no ActiveCampaign.

Passo 6 — Integração ativa

Quando os dois webhooks são confirmados, a integração vira Ativa automaticamente. O wizard mostra Integração ativa ✓.

A partir daqui, todas as vendas e carrinhos abandonados da Hotmart são enviados ao ActiveCampaign em tempo real. Acompanhe os eventos em Atividades.

Depois de conectar: o painel do Hub

A integração já envia tudo o que acontecer daqui para frente. A tela Sincronizar serve só para trazer o que aconteceu antes da conexão: comece pelo Histórico de catálogo, porque os pedidos dependem dos produtos, e no histórico de pedidos escolha uma data de corte para não passar do limite de contatos do seu plano no ActiveCampaign.

No vídeo abaixo, gravado com um cliente, mostramos o painel, a sincronização, as atividades e os créditos, e explicamos a diferença entre o Hub e ferramentas como Zapier, Make e n8n.

Usar no ActiveCampaign: automação de compra

Com a integração ativa, cada venda da Hotmart pode disparar uma automação. No ActiveCampaign, crie uma automação, escolha o gatilho de e-commerce Faz uma compra (ou o de carrinho abandonado), selecione a integração da Hotmart e defina se ela roda uma vez ou múltiplas vezes por contato. O contato chega com nome, e-mail, telefone e os dados do produto e da oferta, sem lista nem campo personalizado para criar.

Como funciona

A integração funciona via webhook: a cada evento (venda aprovada, cancelamento, reembolso, carrinho abandonado), a Hotmart envia os dados para a URL correspondente da sua conta. O Implementaê:

Valida a origem comparando o HOTTOK do webhook com o que você cadastrou (comparação segura contra timing attack).
Evita duplicatas pela chave (provider, external_id, evento) — reentregas retornam sem reprocessar.
Normaliza o status da Hotmart para o padrão do ActiveCampaign (ver tabela abaixo).
Sincroniza com o ActiveCampaign via Deep Data (pedidos, contatos, carrinho abandonado).

Status: Hotmart → ActiveCampaign

Status Hotmart	Status no ActiveCampaign
Aprovado / Concluído	`COMPLETED`
Boleto emitido / Aguardando pagamento	`PENDING_PAYMENT`
Cancelado / Expirado / Em atraso	`CANCELLED`
Reembolsado / Chargeback	`REFUNDED`
Recusado / Sem saldo / Bloqueado	`FAILED`
Carrinho abandonado	`ABANDONED`

Dados recebidos

Categoria	Dados
Cliente	Nome, email, telefone, CPF/CNPJ, endereço
Produto	Nome, SKU, quantidade, valor unitário
Pagamento	Valor total, método, moeda (BRL)
Pedido	Número, datas, status normalizado, ID do carrinho
Rastreamento	ID do carrinho (para detecção de recuperação)

Quando o cliente abandona e depois paga, o Implementaê marca o pedido como recuperado automaticamente pelo ID do carrinho.

Perguntas frequentes

Preciso conectar o ActiveCampaign antes? Sim. A Hotmart envia os dados e o Implementaê sincroniza com o ActiveCampaign — a conexão do AC precisa existir antes.

As credenciais da Hotmart e-commerce servem para a Hotmart Club? Sim. É a mesma credencial OAuth. Se você já conectou uma, a Hotmart Club reaproveita a conexão sem pedir Client ID/Secret de novo.

Por que preciso de dois webhooks? São categorias diferentes na Hotmart: carrinho (abandono) e pedidos (status de venda). Cada um tem sua própria URL e seu próprio HOTTOK.

Onde encontro o HOTTOK? A Hotmart exibe o HOTTOK ao criar o webhook, no painel de webhooks. Copie exatamente o token mostrado.

O que acontece se um webhook falhar? A Hotmart reenvia automaticamente. O Implementaê deduplica reentregas, então a mesma venda não é contada duas vezes.

Os valores vêm em centavos ou reais? O Implementaê normaliza automaticamente — os valores chegam ao ActiveCampaign em reais decimais, no padrão do AC.