# Webhooks vers n'importe quel CRM

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](/docs/async#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ê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.

```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.
