Piattaforme
Webhook verso qualsiasi CRM
Invia i lead a HubSpot, Zoho, Zapier, Make o al tuo server.
Gli esempi di codice, gli endpoint e i codici di errore sono gli stessi in ogni linguaggio.
Invia i lead relativi alle prove d'abito dall'app TryOnCloud per Shopify a qualsiasi URL: HubSpot, Zoho, Mailchimp, Brevo, ActiveCampaign, Salesforce, Zapier, Make, n8n o al tuo server.
Connettiti
- Apri l'app TryOnCloud nella tua area di amministrazione di Shopify.
- Vai su Lead > Integrazioni e fai clic su Connetti nella riga relativa al webhook.
- Incolla l'URL dell'endpoint
httpse copia il segreto di firma.
Evento
TryOnCloud invia un POST con un corpo JSON quando un cliente inserisce il proprio indirizzo e-mail dopo aver provato un capo:
{
"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
}
}Intestazioni
| Intestazione | Significato |
|---|---|
x-tryoncloud-event | lead_captured |
x-tryoncloud-shop | Il dominio del tuo negozio |
x-tryoncloud-delivery-id | Uno per ogni consegna. Utilizzarlo per ignorare i duplicati |
x-tryoncloud-timestamp | Secondi Unix al momento dell'invio |
x-tryoncloud-signature-v2 | sha256= + HMAC-SHA256 di <timestamp>.<raw body> con il tuo segreto. Verifica questo |
x-tryoncloud-signature | sha256= + HMAC-SHA256 solo del corpo grezzo. Viene comunque inviato, in modo che le integrazioni esistenti continuino a funzionare |
Verifica la firma
Verifica sempre i dati prima di considerarli attendibili. Utilizza il corpo della richiesta grezzo, non il JSON riserializzato. Verifica x-tryoncloud-signature-v2: questo campo firma anche il timestamp, quindi puoi rifiutare le consegne risalenti a più di 5 minuti fa e impedire che una richiesta intercettata possa essere riprodotta in un secondo momento. Ogni nuovo tentativo viene nuovamente firmato con il proprio timestamp.
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)Consegna
- Il tuo endpoint deve utilizzare il protocollo
httpse dovrebbe restituire un codice di risposta2xxentro 8 secondi. - Le consegne non andate a buon fine vengono riprovate dopo 1 minuto, 5 minuti, 30 minuti, 2 ore, 6 ore e 24 ore.
- Le consegne possono essere effettuate più di una volta. Eliminare i duplicati in base all'
x-tryoncloud-delivery-id. - I reindirizzamenti non vengono seguiti.