For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/hotmart.md.
  • Português

      • Integrar Hotmart

      Crie a integração na Clickmax com o Hottok do webhook e uma credencial de API da Hotmart (Client ID e Client Secret) e cadastre a URL gerada no webhook da Hotmart. A partir daí, cada evento com e-mail cria ou atualiza um contato (com a tag hotmart), as compras aprovadas viram vendas na Clickmax e você pode vender pela Hotmart direto nas suas páginas com o bloco Checkout Hotmart.

      Antes de começar

      • Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
      • Acesso de administrador à sua conta Hotmart, para abrir Ferramentas → Webhook (API e notificações) e Ferramentas → Credenciais Hotmart.

      Passo a passo

      1. Na Clickmax, abra Integrações, clique em Explorar Integrações e escolha Hotmart em Vendas e Pagamentos.
      2. Em outra aba, acesse a Hotmart e faça login. No menu lateral, abra Ferramentas → Ver todas → Webhook (API e notificações). Na seção Autenticação, copie o Hottok de verificação e cole no campo Hottok de verificação da Clickmax.
      3. Na Hotmart, volte a Ferramentas → Ver todas e abra Credenciais Hotmart. Clique em Criar credencial e crie uma credencial de produção — não marque Sandbox.
      4. Copie o Client ID e o Client Secret da credencial e cole nos campos de mesmo nome na Clickmax.
      5. Informe um Nome para a integração, deixe o Status ativo e clique em Criar integração. A Clickmax confere a credencial na Hotmart antes de criar.
      6. A Clickmax gera uma URL de webhook. Copie essa URL.
      7. Na Hotmart, vá em Ferramentas → Ver todas → Webhook (API e notificações) → Cadastrar webhook. Cole a URL no campo URL e escolha a versão 2.0.0.
      8. Em Produtos, escolha Todos (ou os produtos que você vai vender pela Clickmax). Em Eventos, marque todos os de compra (aprovada, completa, cancelada, reembolsada, chargeback, atrasada, expirada e aguardando pagamento — Pix ou boleto gerado e ainda não pago), abandono de carrinho, cancelamento de assinatura e troca de plano.
      9. Salve o webhook na Hotmart e, na Clickmax, clique em Concluir integração.

      O Hottok viaja no cabeçalho x-hotmart-hottok de cada envio: se não bater com o Hottok cadastrado, a Clickmax rejeita a entrega. Para saber quais eventos da Hotmart a Clickmax reconhece e o que cada um gera (contato, venda, assinatura, carrinho abandonado), consulte a referência de webhooks de entrada.

      A credencial de API é o que deixa você escolher o produto e a oferta no bloco Checkout Hotmart do editor de páginas. A Clickmax renova o acesso à API sozinha; você só precisa criar uma credencial nova se apagar esta na Hotmart.

      Relacionados

      Se não funcionou

      • Nada chega na Clickmax e a Hotmart marca falha (erro 401): o Hottok de verificação cadastrado não corresponde ao da sua conta, a integração está com o Status inativo ou o webhook não está na versão 2.0.0. Revise os três e veja os códigos de erro.
      • A integração não é criada e aparece um erro de credencial inválida: o Client ID e o Client Secret não correspondem a uma credencial da Hotmart. Copie os dois de novo em Ferramentas → Credenciais Hotmart.
      • A integração não é criada e aparece que a credencial não consegue ler produtos: a credencial é de Sandbox. Crie uma credencial de produção e use o Client ID e o Client Secret dela.
      • Minha integração Hotmart é antiga e o editor não lista meus produtos: integrações criadas antes de a credencial de API ser pedida só têm o Hottok. No bloco Checkout Hotmart, digite o código da oferta, ou crie a integração de novo seguindo o passo a passo acima.
      • A venda aparece, mas o contato não: eventos sem e-mail do comprador são ignorados — a Clickmax precisa do e-mail para resolver o contato. Confira em Por que meu contato não aparece?.
      • Você não encontra o menu Integrações: seu papel no workspace não tem acesso. Veja o que fazer sem permissão.