Search docs

Search the TryOnCloud API docs

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.

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.

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

EncabezadoSignificado
x-tryoncloud-eventlead_captured
x-tryoncloud-shopEl dominio de tu tienda
x-tryoncloud-delivery-idÚnico por entrega. Úsalo para ignorar los duplicados.
x-tryoncloud-timestampSegundos Unix al enviarse
x-tryoncloud-signature-v2sha256= + HMAC-SHA256 de <timestamp>.<raw body> con tu clave secreta. Comprueba este.
x-tryoncloud-signaturesha256= + 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.