Passar para o conteúdo principal

💰 Como integrar a sua comunidade a Hotmart

Como integrar a Hotmart com a Cativa via Webhooks

Atualizado há mais de 2 semanas

A Cativa permite integração nativa com a Hotmart por meio de webhooks. Com essa configuração, quando um usuário comprar um produto na Hotmart, ele ganha acesso automaticamente à sua comunidade na Cativa — e quando houver reembolso ou chargeback, o acesso é revogado automaticamente.

O processo envolve criar dois webhooks: um para liberar acesso e outro para remover acesso.

Antes de começar

Você precisará ter em mãos:

  • Acesso ao Painel Administrativo da Cativa

  • Acesso ao painel da Hotmart como produtor

  • Um selo criado na Cativa para o produto que será integrado (cada produto deve ter seu próprio selo)

💡 Por que usar selos? Os selos são a forma mais eficiente de controlar o acesso por produto. Cada produto da Hotmart fica atrelado a um selo específico na Cativa, facilitando o gerenciamento de permissões, prazos e segmentação de membros.
​

⚠️ Importante: O acesso do membro à comunidade está diretamente vinculado ao selo. Isso significa que, em casos de reembolso, chargeback ou não renovação de assinatura, o selo é removido automaticamente — e sem o selo, o membro perde o acesso aos conteúdos do produto.

Parte 1 — Webhook de acesso (Compra aprovada)

Passo 1: Criar o webhook na Cativa

  1. No Painel Administrativo, acesse Integrações → Recebimento de webhook

  2. Clique em Novo webhook

  3. Preencha os campos:

    • Nome: Acesso Hotmart - [Nome do produto] - [Prazo de acesso]

      • Exemplo: Acesso Hotmart - AMA 360 - 12 meses

    • Descrição: Feito por um colaborador da Cativa

    • Evento: Adicionar selo

    • Criar usuário caso não esteja cadastrado: ✅ ativado

  4. Não clique em Salvar ainda — você precisará receber o evento teste antes de finalizar

  5. Copie a URL do webhook gerada — você vai precisar dela na Hotmart

Passo 2: Criar o webhook na Hotmart

  1. No painel da Hotmart, pesquise por "Webhook" na barra de busca ou acesse Ferramentas → Ver tudo → Webhook (API e notificações)

  2. Clique em + Cadastrar Webhook e preencha:

    • Nome da configuração: Acesso Cativa - [Nome do produto]

    • Produto: selecione o produto correspondente

    • URL para envio de dados: cole a URL copiada da Cativa

    • Versão: 2.0.0 (Recomendado)

    • Eventos para enviar: Compra aprovada

  3. Marque o checkbox de conformidade com a LGPD

  4. Clique em Salvar

  5. Na tela de confirmação, clique em Enviar teste de configuração

Passo 3: Mapear os campos na Cativa

⚠️ Atenção — siga a ordem abaixo à risca. A Cativa precisa estar "ouvindo" antes de você disparar o teste pela Hotmart. Inverter essa ordem é o erro mais comum!

  1. Volte para a Cativa e clique em Receber evento

    • Uma contagem regressiva de ~52 segundos será iniciada — só avance para o próximo passo depois disso

  2. Sem fechar a Cativa, abra a Hotmart em outra aba

  3. Na Hotmart, clique em Enviar teste de configuração

  4. Volte para a Cativa — o Objeto Recebido com os dados da Hotmart já estará disponível

  5. Faça o mapeamento dos campos:

    • Nome usuário: busque por name e arraste buyer > name

    • Email: busque por email e arraste buyer > email

    • Id do selo: selecione o selo correspondente ao produto

    • Dias para expiração: preencha com o prazo em dias

      • Exemplo: 365 para acesso anual, deixe em branco para acesso vitalício

  6. Clique em Salvar

Parte 2 — Webhook de remoção (Reembolso e Chargeback)

Passo 1: Criar o webhook de remoção na Cativa

  1. Acesse Integrações → Recebimento de webhook → Novo webhook

  2. Preencha os campos:

    • Nome: Remoção de selo Hotmart - [Nome do produto] - [Prazo]

      • Exemplo: Remoção de selo Hotmart - AMA 360 - 12 meses

    • Descrição: Feito por um colaborador da Cativa

    • Evento: Remover selo

    • Criar usuário caso não esteja cadastrado: ❌ desativado

  3. Copie a nova URL do webhook gerada

Passo 2: Criar o webhook de remoção na Hotmart

  1. Na Hotmart, cadastre um novo webhook com:

    • Nome da configuração: Remoção de selo Cativa - [Nome do produto]

    • Produto: o mesmo produto do webhook de acesso

    • URL: a nova URL copiada da Cativa

    • Versão: 2.0.0 (Recomendado)

    • Eventos para enviar: selecione os dois eventos abaixo:

      • ✅ Compra reembolsada

      • ✅ Chargeback

  2. Marque o checkbox de conformidade com a LGPD

  3. Clique em Salvar e em seguida em Enviar teste de configuração

Passo 3: Mapear os campos na Cativa

⚠️ Atenção — siga a ordem abaixo à risca. A Cativa precisa estar "ouvindo" antes de você disparar o teste pela Hotmart. Inverter essa ordem é o erro mais comum!

  1. Volte para a Cativa e clique em Receber evento

    • Uma contagem regressiva de ~52 segundos será iniciada — só avance para o próximo passo depois disso

  2. Sem fechar a Cativa, abra a Hotmart em outra aba

  3. Na Hotmart, clique em Enviar teste de configuração

  4. Volte para a Cativa — o Objeto Recebido já estará disponível

  5. Faça o mapeamento dos campos:

    • Email: busque por email e arraste buyer > email

    • Id do selo: selecione o selo correspondente ao produto

    • Dias para expiração: deixe em branco (é uma remoção, não é necessário)

  6. Clique em Salvar

Resumo da configuração completa

Webhook de Acesso

Webhook de Remoção

Nome na Cativa

Acesso Hotmart - [Produto] - [Prazo]

Remoção de selo Hotmart - [Produto] - [Prazo]

Nome na Hotmart

Acesso Cativa - [Produto]

Remoção de selo Cativa - [Produto]

Evento na Cativa

Adicionar selo

Remover selo

Eventos na Hotmart

Compra aprovada

Compra reembolsada + Chargeback

Criar usuário

✅ Ativado

❌ Desativado

Dias para expiração

Preencher conforme o prazo

Deixar em branco

Dúvidas?

Se tiver alguma dificuldade durante a configuração, entre em contato com o suporte da Cativa.

Respondeu à sua pergunta?