Passar para o conteúdo principal

💰 Como integrar a sua comunidade com a Hubla

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

Configuração de Webhooks

A Cativa permite integração nativa com a Hubla por meio de webhooks. Com essa configuração, quando um usuário comprar um produto na Hubla, ele ganha acesso automaticamente à sua comunidade na Cativa — e quando houver reembolso, 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 Hubla 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 Hubla 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 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 Hubla - [Nome do produto] - [Prazo de acesso]

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

Passo 2: Configurar o webhook na Hubla

  1. No painel da Hubla, acesse Integrações → Webhooks → Configurar

  2. Clique em Adicionar regra

  3. Preencha os campos:

    • Nome: Acesso Cativa - [Nome do produto]

    • URL: cole a URL do webhook copiada da Cativa

    • Produto: selecione o produto correspondente

    • Ofertas: selecione Todas

    • Evento: Nova venda

  4. Clique em Criar regra

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

  3. No webhook que acabou de criar, clique nos 3 pontos e selecione Testar configuração

  4. Preencha o teste com os dados solicitados (não é necessário preencher o campo "Id do usuário")

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

  6. Faça o mapeamento dos campos:

    • Nome usuário: busque e selecione event.userName

    • Email: busque e selecione event.userEmail

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

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

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

  1. No painel da Hubla, acesse Integrações → Webhooks → Configurar

  2. Clique em Adicionar regra

  3. Preencha os campos:

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

    • URL: cole a nova URL copiada da Cativa

    • Produto: o mesmo produto do webhook de acesso

    • Ofertas: selecione Todas

  4. Nos eventos, selecione:

    • ✅ Fatura reembolsada

    • ✅ Solicitação reembolso

  5. Clique em Criar regra

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

  3. No webhook de remoção, clique nos 3 pontos e selecione Testar configuração

  4. Preencha o teste com os dados solicitados (não é necessário preencher o campo "Id do usuário")

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

  6. Faça o mapeamento dos campos:

    • Email: busque e selecione event.userEmail

    • 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 Hubla - [Produto] - [Prazo]

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

Nome na Hubla

Regra: Acesso Cativa - [Produto]

Regra: Remoção Cativa - [Produto]

Evento na Cativa

Adicionar selo

Remover selo

Eventos na Hubla

Nova venda

Fatura reembolsada + Solicitação reembolso

Criar usuário

✅ Ativado

❌ Desativado

Dias para expiração

Preencher conforme o prazo

Deixar em branco

Parâmetros mapeados

event.userName + event.userEmail

event.userEmail

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

Respondeu à sua pergunta?