# Webhook personalizado

::: warning Em construção
O webhook personalizado ainda está sendo construído. Esta página descreve como ele vai funcionar.
:::

Use o webhook personalizado quando a sua plataforma não está na [lista de plataformas](/integracoes/#plataformas). Ele recebe qualquer evento em JSON, e você diz ao LeadStalker onde está cada informação.

## Configurar

1. Em **Integrações**, adicione uma integração **Personalizado** e gere a URL.
2. Na sua plataforma, cadastre um webhook de vendas com essa URL.
3. Faça uma venda de teste. Quando ela chegar, a tela mostra o evento recebido.
4. Ligue cada campo da venda a um valor do evento, clicando nele.

## Campos da venda

| Campo | Exemplo de caminho no evento |
|---|---|
| Id da transação | `data.id` |
| E-mail do comprador | `data.customer.email` |
| Produto | `data.items[0].sku` |
| Nome do produto | `data.items[0].title` |
| Valor | `data.total_cents`, dividido por 100 |
| Data | `data.paid_at` |
| Status | `event` |

O valor pode vir em centavos: marque a conversão para dividir por 100.

## Tradução do status

Cada plataforma chama o status de um jeito. A tela lista os valores que já chegaram no campo de status, e você escolhe o que cada um significa — por exemplo, `order.paid` vira **Aprovada**, `order.refunded` vira **Reembolsada** e `order.created` é ignorado.

## Reprocessar

Os eventos ficam guardados. Se você mudar o mapeamento, **Salvar e reprocessar** lê de novo os eventos que já chegaram.

## Segurança

A URL da integração é única e assinada. Se a sua plataforma permite enviar um cabeçalho fixo em cada webhook, cadastre um segredo nela e cole o mesmo valor em **Segredo do cabeçalho**: o LeadStalker passa a recusar envios sem ele.
