Passar para o conteúdo principal

Plataformas de vendas: conecte Hotmart, Kiwify, Eduzz ou seu próprio webhook

Como integrar a Weve com plataformas de vendas para liberar acesso automático aos seus clientes assim que uma compra é aprovada.

Plataformas de vendas são a ponte entre onde você vende (Hotmart, Kiwify, Eduzz, etc.) e a área de membros da Weve. Ao conectar uma plataforma, toda compra aprovada dispara automaticamente a liberação de acesso pro cliente — sem você precisar cadastrar manualmente.

Esta área agora vive dentro da Central de Entrega como uma das três abas. Links antigos continuam funcionando via redirecionamento automático.

Plataformas suportadas

  • Hotmart

  • Kiwify

  • Eduzz

  • Webhook personalizado — pra integrar qualquer outro sistema (CRM, gateway próprio, planilha, n8n/Zapier, etc.)

Como conectar uma plataforma

  1. Acesse Configurações → Central de Entrega → aba Plataformas.

  2. Na sub-aba Conexões, clique em Adicionar plataforma e escolha qual quer conectar.

  3. Cole as credenciais necessárias:

    • Hotmart: Hottok (encontra nas configurações de webhook da Hotmart).

    • Kiwify: Signature Key (chave de assinatura HMAC SHA256).

    • Eduzz: Origin Key (em Órbita → Configurações → API).

    • Webhook personalizado: Secret (gerado automaticamente se você deixar em branco).

  4. Salve. A Weve te mostra a URL de webhook que você deve configurar do lado da plataforma.

  5. Cole essa URL no painel da sua plataforma de vendas, no local de configuração de webhooks.

Eventos que a Weve processa

Vendas aprovadas (libera acesso)

  • Hotmart: PURCHASE_COMPLETE, PURCHASE_APPROVED

  • Kiwify: order_approved, paid, order_paid, subscription_renewed

  • Eduzz: invoice_paid, contract_paid

  • Webhook: purchase.completed, subscription.renewed

Reembolsos e chargebacks (revoga acesso)

  • Hotmart: PURCHASE_REFUNDED, PURCHASE_CHARGEBACK

  • Kiwify: order_refunded, refunded, chargeback

  • Eduzz: invoice_refunded, contract_refunded, invoice_chargeback, contract_chargeback

  • Webhook: purchase.refunded, purchase.chargeback

Cancelamento de assinatura (revoga acesso)

  • Hotmart: SUBSCRIPTION_CANCELLATION, PURCHASE_CANCELED, PURCHASE_EXPIRED

  • Kiwify: subscription_canceled, subscription_late

  • Eduzz: contract_canceled

  • Webhook: subscription.canceled

Múltiplas plataformas

As plataformas nativas (Hotmart, Kiwify, Eduzz) podem ser conectadas apenas uma vez por organização — cada uma usa uma credencial única.

Já o Webhook personalizado pode ser configurado quantas vezes você quiser — útil pra ter integrações separadas pra fluxos diferentes (ex.: "CRM Marketing" e "Gateway próprio").

Histórico de webhooks

Na sub-aba Webhooks recebidos da aba Plataformas você vê todas as requisições recebidas das plataformas: quando chegaram, qual evento, se foram processadas com sucesso ou se deram erro. Útil pra debugar quando uma venda não liberou acesso.

O que acontece após conectar

Conectar a plataforma é só o primeiro passo. Pra que vendas liberem acesso, você ainda precisa:

  1. Cadastrar os Produtos da Weve na aba Produtos da Central e vinculá-los aos IDs externos das suas ofertas na plataforma.

  2. Criar uma Entrega de Produto na aba Entregas, definindo o que o aluno recebe ao comprar (coleções, posts, conteúdos, etc.).

Sem produtos e entregas, as vendas chegam mas não liberam nada. A plataforma é só o canal de entrada — o que o aluno recebe é definido em Produtos e Entregas.

Perguntas frequentes

O que faço se a venda chegou mas o acesso não foi liberado?

Confira na ordem: (1) a sub-aba Webhooks recebidos mostra que a requisição chegou? (2) o ID do produto na plataforma está vinculado a um Produto na Weve? (3) o Produto tem uma Entrega ativa associada?

Posso usar a Weve sem plataforma de vendas?

Sim. Você consegue cadastrar membros manualmente ou usar links mágicos. Plataformas são pra automatizar o fluxo de compra → acesso.

A URL de webhook muda?

Não. A URL é fixa por organização e plataforma — uma vez configurada na plataforma de vendas, não precisa mexer mais.

Como troco a credencial?

Edite a plataforma conectada e cole a nova credencial. A URL de webhook continua a mesma.

O webhook personalizado estava falhando com erro 419 — o que aconteceu?

Um erro de configuração fazia com que requisições POST para a URL do webhook personalizado retornassem status 419 (token CSRF inválido) e fossem redirecionadas para a tela de login em vez de serem processadas. Isso afetava apenas o webhook personalizado — Hotmart, Kiwify e Eduzz não eram impactados. O problema foi corrigido. Se você tinha vendas que não liberaram acesso por esse motivo, acesse o Histórico de Webhooks e reprocesse os eventos com erro para liberar o acesso retroativamente.

Respondeu à sua pergunta?