# Webhook verso qualsiasi CRM

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.

> **Nota:** questa pagina riguarda i webhook relativi **ai lead** generati dall'app Shopify. Per i webhook **dell'API per sviluppatori** relativi al completamento di una prova asincrona o di un batch, consulta la sezione [Operazioni asincrone, batch e webhook](/docs/async#webhooks).

## Connettiti

1. Apri l'app TryOnCloud nella tua area di amministrazione di Shopify.
2. Vai su **Lead > Integrazioni** e fai clic su **Connetti** nella riga relativa al webhook.
3. Incolla l'URL dell'endpoint `https` e 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:

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

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

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

## Consegna

- Il tuo endpoint deve utilizzare il protocollo `https` e dovrebbe restituire un codice di risposta `2xx` entro 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.
