Kiwify: Configurando o Webhook para Integração com a Ensinio
Este artigo orienta como configurar o webhook na Kiwify para que ela envie notificações à sua plataforma Ensinio sempre que ocorrer uma transação relevante — garantindo que o acesso dos alunos seja liberado ou bloqueado automaticamente.
Antes de prosseguir com este artigo, certifique-se de que já criou a integração na Ensinio.
Caso ainda não tenha feito, acesse o artigo: Checkout Externo: Integrando com Outra Plataforma de Vendas
Cadastrando o produto na Kiwify com entrega externa
Para que a Kiwify funcione apenas como processadora de pagamentos — mantendo o conteúdo e o acesso dos alunos na Ensinio —, é preciso cadastrar o produto com a opção de entrega externa.
Acesse sua conta na Kiwify e, no menu lateral, clique em Produtos.
Clique em Criar Produto e escolha o tipo de pagamento (único ou recorrente).
Na etapa de entrega do conteúdo, selecione a opção "Área de membros externa".
[Imagem: tela de criação de produto na Kiwify com a opção "Área de membros externa" selecionada]
Ao escolher "Área de membros externa", a Kiwify não tentará entregar nenhum conteúdo — ela apenas processa o pagamento e notifica a Ensinio via webhook.
Obtendo o ID do produto na Kiwify
Após criar o produto, você precisará do seu ID para inserir na integração da Ensinio.
No menu lateral, clique em Produtos.
Clique no produto desejado para abrir as configurações.
O ID do produto aparece na URL da página ou nas informações do produto.
[Imagem: tela do produto na Kiwify com o ID em destaque]
Copie esse ID — ele será o "Código do produto na plataforma" na integração criada na Ensinio.
[Imagem: campo "Código do produto na plataforma" na integração da Ensinio preenchido com o ID da Kiwify]
Configurando o webhook na Kiwify
Agora vamos cadastrar a URL de postback da Ensinio na Kiwify, para que ela saiba para onde enviar as notificações de venda.
No painel da Kiwify, clique em Apps no menu lateral e depois em Webhooks.
Clique em + Adicionar Webhook (ou equivalente).
[Imagem: tela de webhooks na Kiwify]
No campo de URL, cole a URL de postback gerada na sua integração na Ensinio.
Para encontrá-la, acesse no Admin Console da sua plataforma Ensinio: App Store > Checkouts externos, clique na integração criada e copie a URL exibida no campo "URL de postback".
Ela terá um formato semelhante a:
https://suaplataforma.ensinio.cloud/api/v2/postback/kiwify
[Imagem: campo de URL do webhook na Kiwify preenchido com a URL de postback da Ensinio]
Salve a configuração.
Configurando a Página de Obrigado (opcional, mas recomendado)
Para que o aluno saiba para onde ir após a compra, configure a Página de Obrigado do checkout da Kiwify com o link de acesso à sua plataforma Ensinio.
Nas configurações do produto na Kiwify, localize a seção de Checkout ou Página de Obrigado.
Insira a URL da sua plataforma Ensinio — normalmente a página de login ou de criação de senha.
[Imagem: campo de "Página de Obrigado" nas configurações do checkout da Kiwify]
Essa configuração melhora a experiência do aluno: logo após a compra, ele já é direcionado para criar a senha e acessar o conteúdo na Ensinio.
Verificando se a integração está funcionando
Após configurar o webhook, você pode acompanhar os envios diretamente na Kiwify:
No painel da Kiwify, acesse Apps > Webhooks.
Clique no webhook criado para ver o histórico de envios.
Verifique se os eventos aparecem com status de sucesso.
Caso apareçam com erro, revise a URL de postback cadastrada e certifique-se de que a integração na Ensinio está ativa.
[Imagem: histórico de envios do webhook na Kiwify]
Veja também:
Last updated