Plateformes
Webhooks vers n'importe quel CRM
Envoi des prospects vers HubSpot, Zoho, Zapier, Make ou votre serveur.
Les exemples de code, les points de terminaison et les codes d'erreur sont identiques dans tous les langages.
Envoyez les prospects issus des essais de l'application TryOnCloud pour Shopify vers n'importe quelle URL : HubSpot, Zoho, Mailchimp, Brevo, ActiveCampaign, Salesforce, Zapier, Make, n8n ou votre propre serveur.
Se connecter
- Ouvrez l'application TryOnCloud dans votre interface d'administration Shopify.
- Accédez à Prospects > Intégrations, puis cliquez sur Se connecter dans la ligne « Webhook ».
- Collez l'URL de votre point de terminaison
httpset copiez la clé de signature.
ĂvĂ©nement
TryOnCloud envoie une requĂȘte POST avec un corps JSON lorsqu'un client laisse son adresse e-mail aprĂšs un essayage :
{
"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
}
}En-tĂȘtes
| En-tĂȘte | Signification |
|---|---|
x-tryoncloud-event | lead_captured |
x-tryoncloud-shop | Le nom de domaine de votre boutique |
x-tryoncloud-delivery-id | Unique par livraison. Ă utiliser pour ignorer les doublons. |
x-tryoncloud-timestamp | Secondes Unix lors de l'envoi |
x-tryoncloud-signature-v2 | sha256= + HMAC-SHA256 de <timestamp>.<raw body> avec votre clé secrÚte. Vérifiez celui-ci |
x-tryoncloud-signature | sha256= + HMAC-SHA256 du corps brut uniquement. Toujours envoyé afin que les intégrations existantes continuent de fonctionner |
Vérifier la signature
VĂ©rifiez toujours les donnĂ©es avant de vous y fier. Utilisez le corps brut de la requĂȘte, et non le JSON resĂ©rialisĂ©. VĂ©rifiez la signature x-tryoncloud-signature-v2 : celle-ci signe Ă©galement l'horodatage, ce qui vous permet de rejeter les livraisons datant de plus de 5 minutes et d'empĂȘcher la relecture ultĂ©rieure d'une requĂȘte capturĂ©e. Chaque nouvelle tentative est signĂ©e Ă nouveau avec son propre horodatage.
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)Livraison
- Votre point de terminaison doit utiliser le protocole
httpset doit renvoyer un code de réponse2xxdans un délai de 8 secondes. - Les livraisons ayant échoué sont réessayées aprÚs 1 minute, 5 minutes, 30 minutes, 2 heures, 6 heures et 24 heures.
- Les livraisons peuvent apparaĂźtre plusieurs fois. Supprimez les doublons en vous basant sur l'
x-tryoncloud-delivery-id. - Les redirections ne sont pas prises en compte.