Passar para o conteúdo principal

💰 Como integrar a sua comunidade com a Greenn

Como integrar a Cativa com a Green usando webhooks nativos para liberar e revogar acesso automaticamente.

Configuração de Webhooks

A Cativa permite integração nativa com a Green por meio de webhooks. Com essa configuração, quando um usuário comprar um produto na Green, 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 Green 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 Green 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 Green - [Nome do produto] - [Prazo de acesso]

      • Exemplo: Acesso Green - AMA 360 - 12 meses

    • 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 Green

Passo 2: Configurar a entrega via webhook na Green

  1. No painel da Green, acesse Meus Produtos

  2. Selecione o produto em questão

  3. Clique em Conteúdos

  4. Clique em Adicionar conteúdo

  5. Selecione Sistema externo

  6. Selecione Entrega via webhook

  7. No campo Enviar para a URL, cole a URL do webhook copiada da Cativa

  8. Nos eventos, selecione:

    • ✅ Venda paga

    • ✅ Assinatura paga

  9. Clique em Criar liberaçã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 Green. 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. Volte para a Green

  3. Na parte de Conteúdos, localize o webhook que acabou de criar

  4. Clique no ícone de raio (⚡) — Enviar teste

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

  6. Faça o mapeamento dos campos:

    • Nome usuário: busque e selecione Client.name

    • Email: busque e selecione Client.email

    • Telefone (opcional): busque e selecione Client.phone

    • 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

  7. 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 Green - [Nome do produto] - [Prazo]

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

    • Evento: Remover selo

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

  3. Copie a nova URL do webhook gerada

Passo 2: Configurar a entrega via webhook de remoção na Green

  1. No painel da Green, acesse Meus Produtos

  2. Selecione o mesmo produto do webhook de acesso

  3. Clique em Conteúdos

  4. Clique em Adicionar conteúdo

  5. Selecione Sistema externo

  6. Selecione Entrega via webhook

  7. No campo Enviar para a URL, cole a nova URL copiada da Cativa

  8. Nos eventos, selecione:

    • ✅ Chargeback realizado

    • ✅ Venda reembolsada

  9. Clique em Criar liberaçã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 Green. 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. Volte para a Green

  3. Na parte de Conteúdos, localize o webhook de remoção

  4. Clique no ícone de raio (⚡) — Enviar teste

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

  6. Faça o mapeamento dos campos:

    • Email: busque e selecione Client.email

    • Id do selo: selecione o selo correspondente ao produto

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

  7. Clique em Salvar

Resumo da configuração completa

Webhook de Acesso

Webhook de Remoção

Nome na Cativa

Acesso Green - [Produto] - [Prazo]

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

Nome na Green

Conteúdo: Acesso Cativa - [Produto]

Conteúdo: Remoção Cativa - [Produto]

Evento na Cativa

Adicionar selo

Remover selo

Eventos na Green

Venda paga + Assinatura paga

Chargeback realizado + Venda reembolsada

Criar usuário

✅ Ativado

❌ Desativado

Dias para expiração

Preencher conforme o prazo

Deixar em branco

Parâmetros mapeados

Client.name + Client.email + Client.phone (opcional)

Client.email

💡 Dica: Repita esse processo completo (Parte 1 + Parte 2) para cada produto que você deseja integrar. Cada produto na Green deve ter seus próprios webhooks de acesso e remoção, apontando para os selos correspondentes na Cativa.

Respondeu à sua pergunta?