Pular para o conteúdo principal
CHECKOUT · 5 MIN

Webhook: Automação Total

Esqueça adicionar alunos à mão. Quando alguém comprar no seu checkout (Kiwify, Hotmart, PerfectPay), a sua plataforma financeira avisa o App Mestre para liberar o aplicativo e disparar o email de boas-vindas com a senha no mesmo segundo. O nome dessa ponte é Webhook.

Copiando a URL do Webhook do seu painel e colando no Checkout.

1

Encontrando seu Endpoint Mestre

Para a Kiwify conseguir conversar com seu Aplicativo, ela precisa saber o seu "Endereço". Vá na barra lateral no menu Integrações. Role a tela até Configuração de Webhooks e copie a URL exata.

URL Endpoint
https://appmestre.app/api/webhooks/inbound/vendas/seutoken...

Segurança da URL

Esta URL possui um Token criptografado exclusivo da sua conta (Tenant). Quem possuir essa URL pode simular vendas e criar alunos de graça no seu app. Nunca compartilhe.
2

Ajustando no seu Checkout Gateway

O processo é semelhante em 99% das plataformas (Hotmart, Eduzz, Kiwify, Yampi):

  1. Entre na sua conta da plataforma financeira.
  2. Vá em Configurações > Webhooks/Postback.
  3. Crie uma nova integração e cole a URL que você copiou do App Mestre.
  4. Selecione quais eventos a plataforma deve notificar (Ver passo 3).
Checkout Link (Exemplo Kiwify) → Envia JSON → App Mestre Processa
3

Os 4 Eventos Mágicos (O que marcar?)

Não marque "Todos os eventos" no seu checkout para não sobrecarregar nosso servidor em vão (como eventos de "carrinho abandonado"). Marque apenas o que altera o status de acesso do aluno:

  • Venda Aprovada (Pix/Cartão): Cria o aluno, dá acesso ao app e manda o e-mail com botão mágico de login sem senha.
  • Boleto Pago: Faz exatamente o mesmo da venda aprovada.
  • Compra Reembolsada / Chargeback: Expulsa o aluno sumariamente do aplicativo e revoga o acesso.
  • Assinatura Cancelada / Atrasada: Revoga o acesso temporariamente até ele regularizar.

O Fluxo do Aluno

Assim que o webhook bate no App Mestre, nós disparamos um template de email com o logo da sua escola e um botão verde "Acessar Plataforma". O aluno clica e já cai logado no Web App, sem precisar digitar senha.