Passar para o conteúdo principal

💰 Como integrar a sua comunidade com a Kiwify

Descubra como integrar a sua comunidade Cativa com a Kiwify usando webhooks nativos.

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

      • Exemplo: Acesso Kiwify - 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 Kiwify

Passo 2: Criar o webhook na Kiwify

  1. No painel da Kiwify, clique na opção App e depois selecione Webhooks

  2. Clique em Criar webhook e preencha os campos:

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

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

    • Produto: selecione o produto correspondente

    • Evento: Compra Aprovada

    • Token: não precisa preencher

  3. Clique em Criar

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 Kiwify. 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 Kiwify

  3. Clique nos 3 pontos ao lado do webhook que acabou de criar e clique em Testar Webhook

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

  5. Faça o mapeamento dos campos:

    • Nome usuário: busque por Customer e arraste Full_name

    • Email: busque por Customer e arraste email

    • Telefone (opcional): busque por Customer e arraste 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

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

      • Exemplo: Remoção de selo Kiwify - 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: Criar o webhook de remoção na Kiwify

  1. No painel da Kiwify, clique na opção App e depois selecione Webhooks

  2. Clique em Criar webhook e preencha os campos:

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

    • Produto: o mesmo produto do webhook de acesso

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

    • Eventos para enviar: selecione os dois eventos abaixo:

      • ✅ Compra reembolsada

      • ✅ Chargeback

    • Token: não precisa preencher

  3. Clique em Criar

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 Kiwify. 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 Kiwify

  3. Clique nos 3 pontos ao lado do webhook que acabou de criar e clique em Testar Webhook

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

  5. Faça o mapeamento dos campos:

    • Email: busque por Customer e arraste 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 Kiwify - [Produto] - [Prazo]

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

Nome na Kiwify

Acesso Cativa - [Produto]

Remoção de selo Cativa - [Produto]

Evento na Cativa

Adicionar selo

Remover selo

Eventos na Kiwify

Compra aprovada

Compra reembolsada + Chargeback

Criar usuário

✅ Ativado

❌ Desativado

Dias para expiração

Preencher conforme o prazo

Deixar em branco

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

Respondeu à sua pergunta?