API da Hotmart: o que dá para fazer e como usar com agentes de IA
A API da Hotmart dá acesso ao histórico de vendas, assinaturas, alunos da área de membros e cupons de um produtor. É usada por infoprodutores, empresas de educação e integradores que ligam a Hotmart a CRM e atendimento. O acesso usa credenciais geradas na conta do produtor, e há webhooks para eventos de compra.
Os grandes recursos da API, em português claro.
Histórico de transações, comissões, participantes e detalhes de cada compra.
Assinantes, situação, cobranças e cancelamentos de produtos recorrentes.
Alunos, progresso e módulos do curso hospedado na Hotmart.
Criação e consulta de cupons de desconto por produto.
Avisos de compra aprovada, boleto gerado, reembolso, cancelamento e outros eventos.
Consulta dos produtos e ofertas da conta.
Como se acessa a API do Hotmart.
- Com credencial da sua empresaCredenciais (client id, client secret e basic) geradas na área de ferramentas para desenvolvedores da conta Hotmart, trocadas por um token de acesso.
- Documentação oficialdevelopers.hotmart.com
- Compradores são dados pessoais: use só para atendimento e comunicação consentida (LGPD).
- A API tem limites de requisição; prefira webhooks para eventos em tempo real.
- Valide a assinatura dos webhooks para não processar avisos falsos.
- api hotmart
- hotmart api vendas
- hotmart webhook
- hotmart api assinaturas
- integração api hotmart
- hotmart api documentação
- hotmart developers
O que um agente do iTeam faz com a API do Hotmart.
O webhook de boleto avisa o agente, que lembra o comprador no WhatsApp antes do vencimento e envia de novo o link quando ele pede.
O agente identifica assinaturas com pagamento atrasado e conduz a atualização do cartão, sem o time correr atrás de cada caso.
Com o progresso da área de membros, o agente encontra alunos que não passaram do primeiro módulo e manda uma mensagem de retomada.
Antes de reembolsar, o agente confirma a compra, o prazo de garantia e o motivo, e entrega o caso pronto para aprovação.
Da credencial ao agente trabalhando, com aprovação.
Gere as credenciais na Hotmart
Na conta do produtor, crie as credenciais de API e configure os webhooks dos eventos que interessam.
Cadastre no cofre do iTeam
Credenciais e segredo do webhook ficam no cofre; o agente de suporte vê vendas e alunos, mas não altera produtos.
Teste com aprovação
Mensagens a compradores começam revisadas e reembolsos sempre passam por aprovação humana.
Dúvidas sobre a API do Hotmart.
A API da Hotmart é gratuita?
De forma geral, sim: produtores acessam a API sem cobrança extra; a Hotmart cobra as taxas sobre as vendas.
Preciso programar para usar a API da Hotmart com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da Hotmart e o time de implantação configura os fluxos.
Dá para receber a venda em tempo real?
Sim, pelos webhooks, que avisam compra aprovada, reembolso e outros eventos assim que acontecem.
O que um agente de IA consegue fazer com a API da Hotmart?
A API dá acesso a vendas, assinaturas, alunos da área de membros e cupons de um produtor, e há webhooks para eventos de compra. O agente confirma uma compra, libera o suporte ao aluno, trata reembolso, avisa sobre assinatura atrasada e consulta o histórico de vendas. No iTeam, o aviso chega ao aluno pelo WhatsApp, com registro.
Como são geradas e usadas as credenciais da API da Hotmart?
Você cria as credenciais na área de ferramentas para desenvolvedores da conta: client id, client secret e basic, que são trocados por um token de acesso. A credencial nasce ligada a um ambiente, sandbox ou produção, no momento da criação. Guarde o secret em cofre e gere novas credenciais se houver suspeita de vazamento.
A Hotmart tem sandbox para testar integração?
Sim: a Hotmart descreve um ambiente de sandbox para simular e validar integrações, e as credenciais de teste apontam para a URL própria dele. Confira na documentação de desenvolvedores a URL e como simular compras. Use-o para validar a lógica de liberação de acesso e de reembolso antes de ligar o agente em vendas reais.
O que é o hottok e por que o agente deve conferi-lo?
O hottok é um token de verificação único da conta, enviado nas notificações de webhook, que permite confirmar que a chamada veio mesmo da Hotmart. Sem essa conferência, alguém poderia simular uma compra e liberar acesso indevido. O agente só processa avisos cujo hottok bate com o da conta. Guarde-o em cofre, como qualquer segredo.
Webhook ou consulta à API da Hotmart: qual usar para vendas?
O webhook, para eventos em tempo real, como compra aprovada, reembolso e cancelamento de assinatura; a consulta à API serve para conciliar o histórico e conferir o que o aviso perdeu. A Hotmart limita as requisições, então varrer vendas sem parar é desperdício. O agente reage ao evento e, uma vez por período, concilia a base.
O agente pode liberar ou bloquear o acesso de alunos na Hotmart?
A API trabalha com a área de membros, e o agente pode consultar alunos, mas conceder ou revogar acesso por reembolso ou inadimplência deve seguir regras explícitas. Para reembolsos, deixe a decisão com uma pessoa e use o agente para preparar o caso. Erros de revogação geram aluno pagante sem acesso, que é uma reclamação certa.
Dados de compradores da Hotmart podem ser usados para campanhas?
Só dentro da finalidade e do consentimento: dados da compra servem para entrega, suporte e comunicação relacionada ao produto. Campanhas de marketing exigem base legal adequada e opção de descadastro. Esta resposta não é parecer jurídico; combine com o jurídico a política de uso. O agente deve respeitar quem pediu para não receber mensagens.
Quanto custa usar a API da Hotmart?
A documentação não indica cobrança pelo acesso à API; as tarifas da Hotmart incidem sobre as vendas do produtor, conforme o contrato. Confira as condições vigentes no site. Para o agente, soma-se o custo do modelo de IA, proporcional às conversas de suporte e de cobrança que ele conduz. O volume de alunos define esse gasto.
