Kavoo
Veja como conectar a sua plataforma com a Kavoo.
Nesta página
Com a integração da Kavoo, cada venda aprovada libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso.
1. Crie a entrega na sua plataforma
- No painel, acesse Vendas › Entregas e clique em Nova Entrega.
- Na tela Selecione um Gateway, digite "Kavoo" no filtro e clique em Kavoo.
- Dê um nome à entrega (ex.: "Curso X - Vitalício") e escolha a Modalidade de Venda: Venda única ou Assinatura.
- Em Conexão com o gateway, cole no campo ID do Produto o ID do produto na Kavoo (veja abaixo onde encontrar). Se a entrega vale para mais de um produto, coloque um ID por linha.
- Em Conteúdo entregue, marque os cursos ou vitrines que a venda libera e, se quiser, defina o Tempo de acesso e a turma em Liberação. Em Tags, marque as tags que o aluno deve receber.
- Clique em Salvar.
- Depois de salvar, aparece o campo URL de Postback, no formato
https://<sua-plataforma>/api/postback/kavoo/<token>. Copie o endereço completo: o token no fim é o que autoriza as vendas.
Onde encontrar o ID do produto na Kavoo
- Entre na sua conta da Kavoo.
- No menu lateral, abra Produtos › Meus Produtos.
- Localize o produto: o ID aparece logo abaixo do nome dele.
2. Configure o webhook na Kavoo
- No menu lateral da Kavoo, acesse Configurações › Webhooks.
- Clique em Novo Webhook.
- Em URL do Endpoint, cole a URL de postback copiada da entrega.
- Em Eventos, clique em Selecionar Todos.
- Em Filtro de Produtos, escolha apenas os produtos desta entrega.
- Deixe a opção Webhook ativa ligada e clique em Criar Webhook.
Dica
Cada entrega tem a sua própria URL. Se você entrega produtos diferentes pela Kavoo, crie um webhook para cada entrega e filtre os produtos de cada um.
3. Teste
- Faça uma compra de teste com um e-mail que não seja de administrador da plataforma (vendas com e-mail de administrador são recusadas).
- Acesse Vendas › Vendas. A venda aparece em Últimas (enquanto é processada, fica em Na Fila).
- Abra a venda (menu ··· › Ver detalhes). A tela mostra o evento recebido, os IDs de produto/oferta no payload e, se algo deu errado, o Motivo do erro.
- Se o ID lido não for o que você cadastrou, corrija a entrega e clique em Reprocessar na venda. Para refazer todas as vendas com erro de uma vez, use Reprocessar › Reprocessar → Com erro no topo da lista.
Integração por leitura automática
A plataforma reconhece os campos mais comuns do envio da Kavoo (e-mail, código da venda, status e IDs do produto). Valide com uma venda real antes de abrir as vendas. Se algo não for reconhecido, a venda aparece em Vendas › Vendas, na aba Com erro, com o motivo.