TryOnCloud
PrincipianteConfigurazione: 3 minutesOutbound HTTPS webhook (HMAC-SHA256 signed)

Invia i lead relativi alle prove di abbigliamento a qualsiasi CRM tramite un webhook firmato

Il webhook in uscita di TryOnCloud invia ogni lead acquisito tramite la funzione di prova virtuale a un URL di tua scelta, in tempo reale. Collega Zoho, Mailchimp, HubSpot, Salesforce, Brevo, ActiveCampaign, Zapier, Make o il tuo backend. Ogni invio è firmato con HMAC-SHA256, viene riprovato fino a quando non va a buon fine ed è limitato all'indirizzo e-mail dell'acquirente e al prodotto che ha provato.

New to this? Read the full webhook integration guide

Metodo

Outbound HTTPS webhook (HMAC-SHA256 signed)

Autore

HMAC-SHA256 signature with a per-store secret

Lingua

No code (Zapier/Make) or any language

Ideale per

Any Shopify fashion store with a CRM or automation tool

Perché utilizzare TryOnCloud con Webhook

  • Accedi dalla scheda "Lead" con due clic, quindi incolla l'URL del tuo endpoint
  • Funziona con qualsiasi CRM o strumento: Zoho, Mailchimp, HubSpot, Salesforce, Brevo, ActiveCampaign, Zapier, Make, n8n o il tuo server
  • In tempo reale: il lead viene registrato nel tuo CRM pochi secondi dopo la prova
  • Sicurezza predefinita: firma HMAC-SHA256, chiave segreta crittografata, solo HTTPS, protezione contro il replay, rafforzamento della sicurezza contro gli attacchi SSRF
  • Consegna garantita almeno una volta con tentativi ripetuti nell'arco di diverse ore, in modo che un breve periodo di interruzione non comporti mai la perdita di un potenziale cliente

Come configurare TryOnCloud su Webhook

Tempo di montaggio stimato: 3 minutes. Difficoltà: Principiante.

  1. 1

    Installa TryOnCloud su Shopify

    Aggiungi l'app TryOnCloud dall'App Store di Shopify. Il webhook va configurato all'interno dell'app, nella scheda "Lead".

  2. 2

    Apri la scheda "Lead", quindi "Integrazioni"

    Individua la riga relativa al webhook nella tabella "Integrazioni" e clicca su "Connetti".

  3. 3

    Inserisci l'URL del tuo endpoint e copia la chiave segreta

    Inserisci il tuo endpoint HTTPS (l'URL del webhook in entrata del tuo CRM, un hook di intercettazione di Zapier o Make, oppure il tuo server). Copia il segreto di firma visualizzato una sola volta e conservalo in un luogo sicuro.

  4. 4

    Verifica da parte tua

    Aggiungi i controlli della firma HMAC e del timestamp al tuo endpoint, oppure mappa i campi in Zapier o Make senza scrivere codice.

  5. 5

    Pubblica

    Ogni lead generato durante la fase di prova viene ora inviato al tuo endpoint in tempo reale, con tentativi di ricontatto garantiti in caso di interruzioni temporanee del servizio.

Esempio di codice

Verifica la firma di un webhook sul tuo endpoint (Node)

javascript
import crypto from "crypto"

// rawBody = the exact bytes of the request body (do not re-serialize)
const expected = crypto
  .createHmac("sha256", YOUR_STORE_SECRET)
  .update(rawBody)
  .digest("hex")

const sent = req.headers["x-tryoncloud-signature"].replace("sha256=", "")

const ok = crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(sent)
)
if (!ok) return res.status(401).end()   // forged or tampered

// also reject if x-tryoncloud-timestamp is too old,
// then dedupe on x-tryoncloud-delivery-id (at-least-once delivery)

Cose da sapere

  • È necessario che l'app TryOnCloud sia installata sul tuo negozio Shopify
  • Il tuo endpoint deve essere HTTPS; TryOnCloud non accetta URL non HTTPS
  • Per verificare le firme è necessario un piccolo endpoint oppure si può passare tramite Zapier o Make senza scrivere codice

Domande frequenti

A quali CRM posso collegare il webhook?

Qualsiasi CRM, piattaforma di posta elettronica o strumento di automazione che accetti richieste HTTP POST in entrata: Zoho CRM, Mailchimp, HubSpot, Salesforce, Brevo, ActiveCampaign, Omnisend, Sendlane, GoHighLevel, Pipedrive e Constant Contact, oltre a Zapier, Make e n8n, che consentono l'integrazione con migliaia di altre app.

Come posso verificare che un webhook provenga effettivamente da TryOnCloud?

Ogni richiesta viene firmata con HMAC-SHA256 sul corpo grezzo utilizzando la chiave segreta del tuo negozio, inviata nell'intestazione x-tryoncloud-signature. Ricalcola l'HMAC ed esegui un confronto timing-safe. Si tratta dello stesso schema utilizzato da Shopify e Stripe.

Cosa succede se il mio endpoint non funziona?

Nulla va perso. Ogni evento viene prima salvato in una coda di invio permanente, poi recapitato da un processo in background che effettua nuovi tentativi con un backoff esponenziale nell'arco di diverse ore. La consegna avviene almeno una volta; la deduplicazione avviene in base all'ID x-tryoncloud-delivery-id.

Quali dati sono contenuti nel payload?

Solo l'essenziale: l'indirizzo e-mail dell'acquirente (che ha acconsentito a fornirlo) e il prodotto che ha provato (titolo e URL). Nessun dato di pagamento e nessuna foto caricata. Tu sei il titolare del trattamento; TryOnCloud è il responsabile del trattamento.

Ho bisogno di uno sviluppatore?

Per connettersi, no. Per verificare ed elaborare gli eventi, uno sviluppatore aggiunge un piccolo endpoint, oppure è possibile instradare il webhook tramite Zapier o Make e mappare i campi senza scrivere codice.

Sei pronto ad aggiungere la funzione di prova virtuale al tuo negozio Webhook?

Unisciti alle centinaia di negozi di moda che stanno riducendo i resi e aumentando le conversioni grazie a TryOnCloud. Inizia gratuitamente: non serve la carta di credito.

Inizia gratuitamente

Altre integrazioni