# Webhook personalizado

::: warning En construcción
El webhook personalizado todavía se está construyendo. Esta página describe cómo va a funcionar.
:::

Usa el webhook personalizado cuando tu plataforma no está en la [lista de plataformas](/es/integracoes/#plataformas). Recibe cualquier evento en JSON, y tú le dices a LeadStalker dónde está cada dato.

## Configurar

1. En **Integraciones**, agrega una integración **Personalizado** y genera la URL.
2. En tu plataforma, registra un webhook de ventas con esa URL.
3. Haz una venta de prueba. Cuando llegue, la pantalla muestra el evento recibido.
4. Vincula cada campo de la venta con un valor del evento, haciendo clic en él.

## Campos de la venta

| Campo | Ejemplo de ruta en el evento |
|---|---|
| Id de la transacción | `data.id` |
| Correo del comprador | `data.customer.email` |
| Producto | `data.items[0].sku` |
| Nombre del producto | `data.items[0].title` |
| Monto | `data.total_cents`, dividido por 100 |
| Fecha | `data.paid_at` |
| Estado | `event` |

El monto puede venir en centavos: activa la conversión para dividir por 100.

## Traducción del estado

Cada plataforma nombra sus estados a su manera. La pantalla lista los valores que ya llegaron en el campo de estado, y tú eliges qué significa cada uno — por ejemplo, `order.paid` pasa a **Aprobada**, `order.refunded` pasa a **Reembolsada** y `order.created` se ignora.

## Reprocesar

Los eventos quedan guardados. Si cambias el mapeo, **Guardar y reprocesar** vuelve a leer los eventos que ya llegaron.

## Seguridad

La URL de la integración es única y firmada. Si tu plataforma permite enviar un encabezado fijo en cada webhook, configura un secreto allí y pega el mismo valor en **Secreto del encabezado**: LeadStalker pasa a rechazar los envíos sin él.
