# Webhooks para cualquier CRM

Envía los contactos de pruebas de productos desde la aplicación de Shopify TryOnCloud a cualquier URL: HubSpot, Zoho, Mailchimp, Brevo, ActiveCampaign, Salesforce, Zapier, Make, n8n o tu propio servidor.

> **Nota:** Esta página trata sobre los webhooks **de clientes potenciales** de la aplicación de Shopify. Para obtener información sobre los webhooks **de la API para desarrolladores** cuando finaliza una prueba asíncrona o un lote, consulta [Tareas asíncronas, lotes y webhooks](/docs/async#webhooks).

## Conectar

1. Abre la aplicación TryOnCloud en tu panel de administración de Shopify.
2. Ve a **Clientes potenciales > Integraciones** y haz clic en **Conectar** en la fila de «Webhook».
3. Pega la URL de tu punto final `https` y copia el secreto de firma.

## Evento

TryOnCloud envía una solicitud `POST` con un cuerpo JSON cuando un cliente deja su correo electrónico tras una prueba de ropa:

```json
{
  "event": "lead_captured",
  "shop": "yourstore.myshopify.com",
  "created_at": "2026-11-14T10:30:00.000Z",
  "data": {
    "email": "shopper@example.com",
    "customer_id": null,
    "product_id": "8812345678901",
    "product_title": "Floral Wrap Dress",
    "result_url": "https://www.tryoncloud.com/api/result/...",
    "product_url": "https://yourstore.com/products/floral-wrap-dress",
    "tagged_shopify": true
  }
}
```

## Encabezados

| Encabezado | Significado |
|---|---|
| `x-tryoncloud-event` | `lead_captured` |
| `x-tryoncloud-shop` | El dominio de tu tienda |
| `x-tryoncloud-delivery-id` | Único por entrega. Úsalo para ignorar los duplicados. |
| `x-tryoncloud-timestamp` | Segundos Unix al enviarse |
| `x-tryoncloud-signature-v2` | `sha256=` + HMAC-SHA256 de `<timestamp>.<raw body>` con tu clave secreta. Comprueba este. |
| `x-tryoncloud-signature` | `sha256=` + HMAC-SHA256 del cuerpo sin procesar únicamente. Se sigue enviando para que las integraciones existentes sigan funcionando |

## Comprueba la firma

Comprueba siempre los datos antes de darlos por fiables. Utiliza el cuerpo de la solicitud **sin procesar**, no el JSON reserializado. Verifica `x-tryoncloud-signature-v2`: también firma la marca de tiempo, por lo que puedes rechazar las entregas de más de 5 minutos de antigüedad y evitar que una solicitud capturada se pueda reproducir posteriormente. Cada reintento se firma de nuevo con su propia marca de tiempo.

```js
import crypto from "node:crypto"

function verify(rawBody, headers, secret) {
  const ts = headers["x-tryoncloud-timestamp"]
  const sig = headers["x-tryoncloud-signature-v2"]
  if (typeof ts !== "string" || typeof sig !== "string") return false
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false // too old: possible replay
  const expected = "sha256=" + crypto.createHmac("sha256", secret).update(`${ts}.${rawBody}`, "utf8").digest("hex")
  const a = Buffer.from(expected)
  const b = Buffer.from(sig)
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}
```

```python
import hmac, hashlib, time

def verify(raw_body: bytes, headers, secret: str) -> bool:
    ts = headers.get("x-tryoncloud-timestamp")
    sig = headers.get("x-tryoncloud-signature-v2")
    if not ts or not sig or not ts.isdigit():
        return False
    if abs(time.time() - int(ts)) > 300:  # too old: possible replay
        return False
    expected = "sha256=" + hmac.new(secret.encode(), ts.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)
```

## Entrega

- Tu punto final debe ser `https` y debe responder con un código `2xx` en un plazo de 8 segundos.
- Las entregas fallidas se vuelven a intentar al cabo de 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas y 24 horas.
- Las entregas pueden llegar más de una vez. Elimina las duplicadas según el identificador `x-tryoncloud-delivery-id`.
- No se siguen las redirecciones.
