Search docs

Search the TryOnCloud API docs

Plattformen

Webhooks für jedes CRM

Leads an HubSpot, Zoho, Zapier, Make oder Ihren Server übertragen.

Code-Beispiele, Endpunkte und Fehlercodes sind in jeder Sprache identisch.

Senden Sie „Try-On“-Leads aus der TryOnCloud-Shopify-App an eine beliebige URL: HubSpot, Zoho, Mailchimp, Brevo, ActiveCampaign, Salesforce, Zapier, Make, n8n oder Ihren eigenen Server.

Hinweis: Auf dieser Seite geht es um Lead-Webhooks aus der Shopify-App. Informationen zu Entwickler-API-Webhooks, die beim Abschluss einer asynchronen Anprobe oder eines Batches ausgelöst werden, findest du unter Asynchrone Jobs, Batches und Webhooks.

Verbinden

  1. Öffnen Sie die TryOnCloud-App in Ihrem Shopify-Adminbereich.
  2. Gehen Sie zu Leads > Integrationen und klicken Sie in der Zeile „Webhook“ auf Verbinden.
  3. Fügen Sie die URL Ihres https-Endpunkts ein und kopieren Sie das Signaturschlüssel.

Veranstaltung

TryOnCloud sendet eine POST-Anfrage mit einem JSON-Body, wenn ein Kunde nach einer Anprobe seine E-Mail-Adresse hinterlässt:

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
  }
}

Überschriften

KopfzeileBedeutung
x-tryoncloud-eventlead_captured
x-tryoncloud-shopDie Domain Ihres Shops
x-tryoncloud-delivery-idEinzigartig pro Lieferung. Verwenden Sie diese Option, um Duplikate zu ignorieren.
x-tryoncloud-timestampUnix-Sekunden beim Senden
x-tryoncloud-signature-v2sha256= + HMAC-SHA256 von <timestamp>.<raw body> mit Ihrem geheimen Schlüssel. Überprüfen Sie diesen hier
x-tryoncloud-signaturesha256= + HMAC-SHA256, ausschließlich für den Rohtext des Hauptteils. Wird weiterhin gesendet, damit bestehende Integrationen weiterhin funktionieren

Überprüfen Sie die Unterschrift

Überprüfen Sie die Daten stets, bevor Sie ihnen vertrauen. Verwenden Sie den Rohtext des Anfrage-Hauptteils und nicht das erneut serialisierte JSON. Überprüfen Sie x-tryoncloud-signature-v2: Dieser Wert signiert auch den Zeitstempel, sodass Sie Übermittlungen, die älter als 5 Minuten sind, ablehnen können und eine aufgezeichnete Anfrage später nicht erneut abgespielt werden kann. Jeder erneute Versuch wird erneut mit einem eigenen Zeitstempel signiert.

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)

Lieferung

  • Ihr Endpunkt muss https lauten und sollte innerhalb von 8 Sekunden einen 2xx-Status zurückgeben.
  • Bei fehlgeschlagenen Zustellungen erfolgt ein erneuter Versuch nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden und 24 Stunden.
  • Lieferungen können mehrmals eingehen. Führen Sie eine Dublettenprüfung anhand von x-tryoncloud-delivery-id durch.
  • Weiterleitungen werden nicht verfolgt.