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.
Verbinden
- Öffnen Sie die TryOnCloud-App in Ihrem Shopify-Adminbereich.
- Gehen Sie zu Leads > Integrationen und klicken Sie in der Zeile „Webhook“ auf Verbinden.
- 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:
{
"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
| Kopfzeile | Bedeutung |
|---|---|
x-tryoncloud-event | lead_captured |
x-tryoncloud-shop | Die Domain Ihres Shops |
x-tryoncloud-delivery-id | Einzigartig pro Lieferung. Verwenden Sie diese Option, um Duplikate zu ignorieren. |
x-tryoncloud-timestamp | Unix-Sekunden beim Senden |
x-tryoncloud-signature-v2 | sha256= + HMAC-SHA256 von <timestamp>.<raw body> mit Ihrem geheimen Schlüssel. Überprüfen Sie diesen hier |
x-tryoncloud-signature | sha256= + 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.
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)Lieferung
- Ihr Endpunkt muss
httpslauten und sollte innerhalb von 8 Sekunden einen2xx-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-iddurch. - Weiterleitungen werden nicht verfolgt.