Plataformas
Webhooks para cualquier CRM
Envía los eventos de clientes potenciales a HubSpot, Zoho, Zapier, Make o tu servidor.
Los ejemplos de código, los puntos finales y los códigos de error son los mismos en todos los idiomas.
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.
Conectar
- Abre la aplicación TryOnCloud en tu panel de administración de Shopify.
- Ve a Clientes potenciales > Integraciones y haz clic en Conectar en la fila de «Webhook».
- Pega la URL de tu punto final
httpsy 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:
{
"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.
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)
}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
httpsy debe responder con un código2xxen 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.