Search docs

Search the TryOnCloud API docs

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.

Remarque : cette page concerne les webhooks de prospects de l'application Shopify. Pour en savoir plus sur les webhooks de l'API développeur déclenchés à la fin d'un essai asynchrone ou d'un traitement par lots, consultez la section Tùches asynchrones, traitements par lots et webhooks.

Se connecter

  1. Ouvrez l'application TryOnCloud dans votre interface d'administration Shopify.
  2. Accédez à Prospects > Intégrations, puis cliquez sur Se connecter dans la ligne « Webhook ».
  3. Collez l'URL de votre point de terminaison https et 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 :

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

En-tĂȘtes

En-tĂȘteSignification
x-tryoncloud-eventlead_captured
x-tryoncloud-shopLe nom de domaine de votre boutique
x-tryoncloud-delivery-idUnique par livraison. À utiliser pour ignorer les doublons.
x-tryoncloud-timestampSecondes Unix lors de l'envoi
x-tryoncloud-signature-v2sha256= + HMAC-SHA256 de <timestamp>.<raw body> avec votre clé secrÚte. Vérifiez celui-ci
x-tryoncloud-signaturesha256= + 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.

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)

Livraison

  • Votre point de terminaison doit utiliser le protocole https et doit renvoyer un code de rĂ©ponse 2xx dans 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.