# Voomp

> Veja como conectar a sua plataforma com a Voomp.

Com a integração da Voomp, cada venda paga (ou assinatura ativa) libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e assinatura cancelada, encerrada ou não paga 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 "Voomp" no filtro e clique em **Voomp**.
3. Dê um nome à entrega 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 Voomp (veja abaixo). Um por linha.
5. Em **Conteúdo entregue**, marque os cursos ou vitrines que a venda libera e, se quiser, 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. Copie o endereço completo do campo **URL de Postback**, no formato `https://<sua-plataforma>/api/postback/voomp/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o ID do produto na Voomp

1. No menu lateral da Voomp, clique em **Produtos** e depois no produto.
2. O ID aparece na barra de endereços, por exemplo `https://adm.voompcreators.com.br/produtos/edicao-produto/1234`. Nesse caso, o ID é `1234`.

## 2. Configure o webhook na Voomp

1. No menu lateral, clique em **Integrações › Webhook**.
2. Ao criar o webhook, selecione os produtos desta entrega.
3. Cole a URL de postback copiada da entrega.
4. Selecione **todas as variáveis**.
5. Marque os eventos:
   - Venda Paga
   - Venda Reembolsada
   - Chargeback Realizado
   - Assinatura Não Paga
   - Assinatura Ativa
   - Assinatura em Trial (opcional)
   - Assinatura Aguardando Pagamento
   - Assinatura Encerrada
   - Assinatura Cancelada
6. Clique em **Salvar integração**.

:::dica
Cada entrega tem a sua própria URL. Se você entrega produtos diferentes pela Voomp, crie um webhook para cada entrega e selecione os produtos de cada um.
:::

## 3. Teste

1. Na Voomp, abra **Produtos**, clique em **[ … ] › Editar Produto** e, no menu lateral do produto, em **Entregas**.
2. Escolha um webhook de **Venda Paga** ou **Assinatura Paga** e clique no ícone de raio para testar. O teste chega em **Vendas › Vendas**; com dados fictícios, pode aparecer na aba **Com erro**. Se apareceu, a URL está certa.
3. Antes de abrir as vendas, faça também uma compra real com um e-mail que **não** seja de administrador da plataforma.
4. Abra a venda (menu **···** › **Ver detalhes**) e confira o evento recebido, os **IDs de produto/oferta no payload** e, se houver, o **Motivo do erro**. Se precisar ajustar a entrega, corrija e clique em **Reprocessar**.

:::info Integração por leitura automática
A plataforma reconhece os campos mais comuns do envio da Voomp (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.
:::