Nó Hotmart

O nó de workflow Hotmart chama a Hotmart Developers API para buscar vendas, assinaturas e comissões de afiliados. Use-o em workflows de infoproduto para consultar detalhes de compra, notificar compradores no WhatsApp ou reportar comissões a afiliados.

ID do nó no editor: hotmart_request
Base URL: https://developers.hotmart.com/payments/api/v1/
Auth: Authorization: Bearer {{hotmart_access_token}}

O que faz

• Envia requisições HTTP autenticadas para endpoints de pagamento/vendas da Hotmart
• Suporta GET, POST, PUT e DELETE
• Retorna status HTTP, data de resposta e headers de resposta
• Inclui templates de operação para vendas, assinaturas e comissões

Pré-requisitos

1. Uma conta Hotmart de produtor ou co-produtor
2. OAuth access token do portal Hotmart Developers
3. Chave de integração hotmart_access_token em Configurações → Chaves de API

Obtendo um access token

A Hotmart usa OAuth 2.0 (client credentials ou authorization code flow):

1. Registre uma aplicação em Hotmart Developers
2. Obtenha Client ID e Client Secret
3. Solicite um access token via endpoint OAuth da Hotmart
4. Armazene o token como hotmart_access_token nas chaves de integração do WhatsWave

Access tokens expiram. Renove tokens antes de expirarem ou reautentique quando receber erros 401.

Como configurar

Passo 1 — Definir credenciais

1. Abra Configurações → Chaves de API
2. Adicione a chave de integração:
   • Nome: hotmart_access_token
   • Valor: seu Hotmart OAuth access token

Header padrão: Authorization: Bearer {{hotmart_access_token}}

Passo 2 — Adicionar o nó

Arraste Hotmart da paleta Marketing para o canvas do workflow.

Passo 3 — Escolher um template de operação

Passo 4 — Configurar campos da requisição

Exemplo — buscar detalhes da venda após webhook (GET):

• URL: https://developers.hotmart.com/payments/api/v1/sales/{{trigger.body.data.purchase.transaction}}
• Method: GET

Exemplo — listar vendas recentes com filtro de data (GET):

• URL: https://developers.hotmart.com/payments/api/v1/sales?start_date=2026-01-01&end_date=2026-01-31
• Method: GET

Exemplo — listar assinaturas (GET):

• URL: https://developers.hotmart.com/payments/api/v1/subscriptions?status=ACTIVE
• Method: GET

Parâmetros de query para filtragem (datas, status, produto) variam por endpoint — consulte a documentação da API Hotmart.

Passo 5 — Usar dados da resposta

A estrutura dos dados de venda depende do endpoint. Inspecione a saída de execução para os caminhos de campo:

Buyer email: {{hotmart_1.data.items[0].buyer.email}}
Product name: {{hotmart_1.data.items[0].product.name}}

Use um nó JavaScript se precisar transformar respostas aninhadas complexas.

Saídas do nó

Eventos em tempo real vs polling de API

O nó Hotmart consulta a API — não recebe notificações push por si só. Para notificações de compra em tempo real:

1. Configure webhooks Hotmart (Postback/Webhook) nas configurações do seu produto Hotmart
2. Aponte a URL do webhook para um workflow com Gatilho Webhook do WhatsWave
3. Use este nó Hotmart nesse workflow para buscar detalhes completos da venda por transaction ID

Consulte Webhooks recebidos.

Dicas e boas práticas

• Padrão webhook + GET — o webhook dispara instantaneamente; o nó Hotmart enriquece com dados completos de comprador/produto
• Armazene IDs de transação Hotmart em contatos WhatsWave como campos customizados
• Para produtos de assinatura, monitore /subscriptions para eventos de churn e renovação
• Relatórios de comissão via /commissions ajudam automações de pagamento a afiliados
• Filtre vendas por intervalo de datas para evitar respostas paginadas muito grandes
• Expiração de token causa 401 — renove o token OAuth proativamente
• Payloads de postback Hotmart usam nomes de campo específicos — mapeie {{trigger.body.data.purchase.transaction}} com cuidado
• Teste com credenciais de sandbox Hotmart quando disponíveis

Exemplos de casos de uso

Webhook de compra → boas-vindas WhatsApp

1. Gatilho Webhook — evento Hotmart PURCHASE_COMPLETE
2. Hotmart GET — buscar venda por transaction ID
3. Enviar mensagem — "Bem-vindo {{buyer_name}}! Acesse seu produto aqui: {{access_link}}"

Assinatura cancelada → mensagem de retenção

1. Gatilho Webhook — evento Hotmart SUBSCRIPTION_CANCELLATION
2. Hotmart GET — buscar detalhes da assinatura
3. Enviar mensagem — oferta de retenção via WhatsApp

Relatório mensal de comissão de afiliados

1. Gatilho agendado — primeiro dia do mês
2. Hotmart GET — listar comissões do mês anterior
3. Loop — iterar afiliados
4. Enviar mensagem — resumo de comissão para cada afiliado

Follow-up de carrinho abandonado

1. Gatilho Webhook — evento de carrinho abandonado Hotmart (se configurado)
2. Enviar mensagem — oferta de recuperação com link de checkout

FAQ

Por que 401 Unauthorized?
hotmart_access_token expirado ou inválido. Reautentique via OAuth Hotmart.

Este nó pode criar vendas ou reembolsos?
Os templates focam em operações de leitura (listar/obter vendas, assinaturas, comissões). Para operações de escrita (reembolsos, etc.), configure URLs customizadas conforme a documentação da API Hotmart.

Qual a diferença entre webhook e este nó?
Webhooks empurram eventos ao WhatsWave em tempo real. Este nó puxa dados da API Hotmart — use ambos juntos.

Como obtenho o sale ID de um webhook?
Inspecione o payload do webhook no histórico de execução. Caminho comum: trigger.body.data.purchase.transaction.

Funciona para afiliados ou só produtores?
Endpoints de comissão servem relatórios de afiliados. Contas de produtor/co-produtor acessam dados de vendas e assinatura conforme permissões Hotmart.

Referência da API

Relacionados

• Visão geral de Marketing
• Nó Kiwify
• Webhooks recebidos
• Variáveis no workflow