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 (app.hotmart.com/tools/applications).
- Crie um App (ou abra um App existente).
- Copie o Client ID e o Client Secret do App.
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.
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.
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
HOTTOKdo 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.