Central de ajuda · Ligar vendas

Como ligar a Kiwify à Vozea

Cada compra aprovada na Kiwify vira um pedido de depoimento na Vozea — e um reembolso, chargeback ou assinatura cancelada para o pedido sozinho. A ligação é um webhook criado no painel da Kiwify; o token desse webhook vai colado na Vozea.

Leva uns 5 minutos · conferido na documentação oficial em 17/9/2026

O que você precisa

• Sua conta na Vozea, em Coletar › Vendas.
• Acesso de produtor ao painel da Kiwify.
• Duas abas abertas lado a lado: a Vozea e a Kiwify.

Passo a passo

1. 1

   Na Vozea, crie a conexão

   Em Coletar › Vendas, clique em Ligar no cartão da Kiwify. Deixe o Token do webhook em branco por enquanto (ele nasce na Kiwify no passo seguinte) e clique em Criar conexão. No cartão da conexão, clique em Copiar para copiar a URL do webhook.

   Atenção: Enquanto o token não estiver na Vozea, ela recusa as chamadas. É proposital: nada entra sem assinatura.

2. 2

   Na Kiwify, crie o webhook

   No painel da Kiwify, abra o menu Apps e depois Webhooks. Clique em Criar Webhook. No painel que abre à direita, dê um nome (por exemplo, Vozea), cole a URL copiada da Vozea no campo da URL, escolha o produto (ou todos) e marque os eventos da lista abaixo.

   Atenção: O token do webhook é mostrado nessa mesma tela, na criação (e depois na edição). Copie-o antes de clicar em criar — ou volte pela edição do webhook.

3. 3

   Cole o token na Vozea

   No cartão da conexão Kiwify, clique em Gerenciar, cole o token no campo Token do webhook e salve. A partir daqui a Vozea aceita as chamadas dessa conexão.

Eventos para marcar

• ✓ Compra aprovada
• ✓ Reembolso
• ✓ Chargeback
• ✓ Assinatura cancelada

Compra aprovada é a que vira pedido. Reembolso, Chargeback e Assinatura cancelada desfazem a venda: com eles marcados, a Vozea para o pedido pendente e não manda lembrete. Os outros (Pix gerado, Boleto gerado, Compra recusada, Carrinho abandonado, Assinatura atrasada, Assinatura renovada) podem ficar desmarcados — se vierem, a Vozea só ignora.

Como testar

1. Na Kiwify, depois de salvar o webhook, clique em Testar Webhook para disparar eventos de teste.
2. Na Vozea, em Coletar › Vendas › Últimas vendas, a chamada aparece em segundos. O teste usa dados de exemplo — se virar um pedido agendado, pare-o em Coletar › Na fila.
3. Para ver o que a Kiwify mandou e o que a Vozea respondeu: nos três pontinhos ao lado do webhook, Ver logs. Um envio que falhou pode ser reenviado por ali (Reenviar webhooks).

Depois de ligar

• Cada venda aparece em Coletar › Vendas › Últimas vendas em segundos, com o que a Vozea fez com ela: pedido agendado (e para quando), já estava na fila, evento ignorado, produto fora do filtro, venda desfeita.
• O pedido de depoimento sai 7 dias depois da compra (você muda em Gerenciar: outro prazo, ou o fim da garantia na Hotmart). Quem responde não recebe mais nada; quem não responde recebe até dois lembretes.
• Reembolso, chargeback e assinatura cancelada param o pedido pendente sozinhos — desde que esses eventos estejam marcados no webhook.
• Por e-mail o pedido sai sozinho a partir do plano Essencial. Por WhatsApp a Vozea monta a mensagem e o pedido entra na lista do dia em Coletar, para você mandar com um toque.
• A Kiwify não avisa o fim da garantia, então o gatilho é sempre "dias depois da compra" (7 por padrão; mude em Gerenciar).
• Em Gerenciar › Só estes produtos você escolhe de quais produtos pedir; a lista se monta com as vendas que chegam.

Problemas comuns

"Assinatura não confere" em Últimas vendas

O token colado na Vozea não é o mesmo da plataforma. Confira em Gerenciar, cole de novo sem espaços e salve. A plataforma reenvia a chamada sozinha (ou use o botão de teste dela).

"Só e-mail — sai sozinho no Essencial"

A venda veio só com e-mail e a conta está no Grátis: o pedido por e-mail automático é do plano Essencial. Vendas com telefone entram na lista do dia para você mandar pelo WhatsApp.

"Evento ignorado"

A plataforma mandou um evento que não é compra aprovada nem cancelamento (boleto gerado, pix gerado, carrinho abandonado…). É normal: só a compra aprovada vira pedido.

"Já estava na fila"

A mesma venda chegou duas vezes, ou o mesmo cliente comprou o mesmo produto enquanto o pedido anterior ainda estava aberto. A Vozea não pede duas vezes.

"Sem nome ou contato no JSON"

A chamada veio sem os dados do comprador. Como afiliado, isso acontece quando o produtor não liberou os dados do comprador para afiliados. Como produtor, confira no log da Kiwify se o objeto Customer veio preenchido.

Fontes

Os nomes de menus, botões e campos deste manual foram conferidos em:

• Ajuda Kiwify — Como funcionam os webhooks?
• Kiwify — Documentação dos webhooks (eventos, campos e assinatura)

Ficou com dúvida? Escreva para contato@vozea.io.