🇮🇹 IT

🛍️ Shopify Trigger

Lo Shopify Trigger avvia un workflow quando Shopify invia un evento webhook — come un nuovo ordine, un aggiornamento di prodotto o la registrazione di un cliente. Valida automaticamente la firma HMAC-SHA256 di Shopify, così puoi essere certo che ogni evento sia autentico prima di agire.

Categoria: Trigger · Identificatore tipo: shopify_trigger

Panoramica

Il sistema webhook di Shopify invia notifiche in tempo reale su tutto ciò che accade nel tuo negozio: ordini creati o evasi, clienti registrati, prodotti aggiunti o aggiornati, livelli di inventario modificati. Lo Shopify Trigger porta tutti questi eventi direttamente nei tuoi workflow Flusso senza richiedere codice personalizzato.

Ogni webhook inviato da Shopify include un header X-Shopify-Hmac-Sha256 — un hash HMAC-SHA256 codificato in base64 del corpo della richiesta, calcolato utilizzando il tuo shared secret. Lo Shopify Trigger verifica questa firma prima di avviare il workflow, rifiutando qualsiasi richiesta che non possa essere autenticata come evento genuino di Shopify.

Puoi opzionalmente filtrare il trigger su un topic Shopify specifico (come orders/create) in modo che il workflow venga eseguito solo per il tipo di evento che ti interessa. Se lasci il campo Topic vuoto, il trigger si attiva per tutti gli eventi che Shopify invia all'endpoint, e puoi usare un nodo Switch a valle per gestire topic diversi con logiche diverse.

Configurazione

Campo	Obbligatorio	Descrizione
Shared Secret	Obbligatorio	Il shared secret dalla configurazione webhook di Shopify. Per i webhook creati nel pannello di amministrazione Shopify, è il segreto mostrato quando configuri il webhook. Per i webhook delle app, è il client secret dell'app. Flusso lo utilizza per verificare l'header `X-Shopify-Hmac-Sha256` su ogni richiesta in arrivo.
Topic	Opzionale	Un topic webhook Shopify su cui filtrare (ad esempio, `orders/create`, `products/update`, `customers/create`). Se lasciato vuoto, il trigger si attiva per tutti i topic. Consulta il riferimento webhook Shopify per l'elenco completo dei topic disponibili.

Topic Shopify comuni

# Eventi ordine orders/create orders/updated orders/paid orders/cancelled orders/fulfilled # Eventi prodotto products/create products/update products/delete # Eventi cliente customers/create customers/update # Eventi inventario inventory_levels/update

Dati di Output

Variabile	Tipo	Descrizione
`trigger.output.payload`	Object	Il payload completo dell'evento Shopify. La struttura dipende dal topic dell'evento — consulta il riferimento webhook Shopify per i nomi dei campi.
`trigger.output.topic`	String	Il topic del webhook Shopify, come indicato nell'header `X-Shopify-Topic` (es. `orders/create`).
`trigger.output.headers`	Object	Tutti gli header della richiesta HTTP, inclusi `x-shopify-topic`, `x-shopify-shop-domain` e `x-shopify-hmac-sha256`.

// Accedere al topic dell'evento {{ trigger.output.topic }} // Creazione ordine: ID ordine e email del cliente {{ trigger.output.payload.id }} {{ trigger.output.payload.email }} {{ trigger.output.payload.total_price }} // Creazione ordine: primo articolo {{ trigger.output.payload.line_items.0.title }} {{ trigger.output.payload.line_items.0.quantity }} // Il dominio del negozio (utile per configurazioni multi-negozio) {{ trigger.output.headers.x-shopify-shop-domain }}

Esempio di Utilizzo

Inviare una notifica di evasione alla creazione di un ordine

Aggiungi uno Shopify Trigger. Inserisci il tuo shared secret e imposta il Topic su orders/create.
Aggiungi un nodo Agent per generare un messaggio di conferma personalizzato, utilizzando {{ trigger.output.payload.email }} e {{ trigger.output.payload.line_items }} come contesto.
Aggiungi un nodo Email Notification per inviare la conferma. Imposta il destinatario su {{ trigger.output.payload.email }} e l'oggetto su Ordine #{{ trigger.output.payload.order_number }} confermato.

Suggerimenti e Note

Ruota il tuo shared secret se viene compromesso. Se qualcuno ottiene il tuo shared secret, potrebbe inviare eventi Shopify falsi al tuo workflow. Aggiorna il segreto sia in Shopify che in Flusso immediatamente se sospetti che sia stato esposto.

I webhook Shopify hanno un timeout di consegna. Shopify si aspetta una risposta 200 entro 5 secondi. Flusso accoda l'esecuzione del workflow in modo asincrono e restituisce 200 immediatamente, quindi in pratica non dovrebbe essere un problema.
Shopify potrebbe inviare eventi duplicati. Sotto carico elevato, Shopify occasionalmente consegna lo stesso evento più di una volta. Se il tuo workflow non è idempotente (cioè eseguirlo due volte causerebbe problemi), aggiungi un nodo Set Variable all'inizio per tracciare gli ID degli ordini elaborati e un Logic Gate per saltare i duplicati.
Configurazioni multi-negozio: Se hai più negozi Shopify, puoi usare un singolo workflow Flusso per tutti — basta registrare lo stesso URL webhook in ogni negozio. Usa {{ trigger.output.headers.x-shopify-shop-domain }} a valle per distinguere quale negozio ha inviato l'evento.

Nodi Correlati

Webhook Trigger — trigger webhook generico per qualsiasi sorgente HTTP POST.
Stripe Trigger — trigger webhook con validazione integrata della firma Stripe.
GitHub Trigger — trigger webhook con validazione HMAC integrata di GitHub.