Passar para o conteúdo principal

💰 Como integrar a sua comunidade com a Ticto

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

Configuração de Webhooks

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

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

Passo 2: Configurar o webhook na Ticto

  1. No painel da Ticto, acesse Tictools → Webhook → Adicionar

  2. Selecione o produto que será integrado

  3. Cole a URL do webhook copiada da Cativa no campo correspondente

  4. Selecione a versão 2.0

  5. Formato de envio: deixe em JSON

  6. No campo de evento, selecione:

    • ✅ Venda realizada

  7. Clique em Salvar

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

  3. No webhook que acabou de criar, clique em Ações e selecione Enviar evento teste

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

  5. Faça o mapeamento dos campos:

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

    • Email: busque e selecione customer.email

    • Telefone (opcional): busque e selecione customer.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 Ticto - [Nome do produto] - [Prazo]

      • Exemplo: Remoção de selo Ticto - 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 Ticto

  1. No painel da Ticto, acesse Tictools → Webhook → Adicionar

  2. Selecione o mesmo produto do webhook de acesso

  3. Cole a URL do webhook de remoção copiada da Cativa

  4. Selecione a versão 2.0

  5. Formato de envio: deixe em JSON

  6. Nos eventos, selecione:

    • ✅ Chargeback

    • ✅ Reembolso

  7. Clique em Salvar

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

  3. No webhook de remoção, clique em Ações e selecione Enviar evento teste

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

  5. Faça o mapeamento dos campos:

    • Email: busque e selecione customer.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 Ticto - [Produto] - [Prazo]

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

Nome na Ticto

Webhook: Acesso Cativa - [Produto]

Webhook: Remoção Cativa - [Produto]

Evento na Cativa

Adicionar selo

Remover selo

Eventos na Ticto

Venda realizada

Chargeback + Reembolso

Criar usuário

✅ Ativado

❌ Desativado

Dias para expiração

Preencher conforme o prazo

Deixar em branco

Parâmetros mapeados

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

customer.email

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

Respondeu à sua pergunta?