# Kavoo

> Veja como conectar a sua plataforma com a Kavoo.

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

1. No painel, acesse **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, digite "Kavoo" no filtro e clique em **Kavoo**.
3. Dê um nome à entrega (ex.: "Curso X - Vitalício") e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. 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.
5. 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.
6. Clique em **Salvar**.
7. 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

1. Entre na sua conta da Kavoo.
2. No menu lateral, abra **Produtos › Meus Produtos**.
3. Localize o produto: o ID aparece logo abaixo do nome dele.

## 2. Configure o webhook na Kavoo

1. No menu lateral da Kavoo, acesse **Configurações › Webhooks**.
2. Clique em **Novo Webhook**.
3. Em **URL do Endpoint**, cole a URL de postback copiada da entrega.
4. Em **Eventos**, clique em **Selecionar Todos**.
5. Em **Filtro de Produtos**, escolha apenas os produtos desta entrega.
6. 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

1. 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).
2. Acesse **Vendas › Vendas**. A venda aparece em **Últimas** (enquanto é processada, fica em **Na Fila**).
3. 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**.
4. 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.

:::info 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.
:::