Introduzione a Workflow Webhooks
Shopify Flow È potente, ma reagisce solo agli eventi all’interno di Shopify. Workflow Webhooks elimina tale limitazione. Vi fornisce un endpoint URL sicuro a cui i sistemi esterni possono inviare richieste POST e, quando lo fanno, il vostro workflow su Shopify Flow si attiva immediatamente, con i dati del payload trasmessi come variabili utilizzabili.
Come funziona
- Il Suo strumento esterno invia una richiesta HTTP POST all’URL del Suo webhook con un payload JSON (ad es. nome, indirizzo e-mail, domanda). Funziona con n8n, Make, Zapier o qualsiasi strumento compatibile con HTTP.
- Workflow Webhooks la riceve, ne verifica l'autenticità e la registra con le intestazioni complete e il payload, quindi attiva il trigger collegato Shopify Flow.
- Shopify Flow esegue la vostra automazione: tagga un cliente, invia un’e-mail, aggiorna un
metacampo - utilizzo dei dati del payload come variabili denominate (
{{fieldOne}},{{fieldTwo}},{{fieldThree}},{{fieldFour}}). È inoltre possibile inviare dati aggiuntivi selezionando la casella Sicurezza -> Consentire il corpo della richiesta personalizzato sul webhook. - Un unico endpoint webhook può alimentare qualsiasi automazione Shopify Flow.
Caratteristiche
| Caratteristica | Descrizione |
|---|---|
| Trigger webhook per Shopify Flow | Endpoint HTTP sicuri che avviano su richiesta qualsiasi automazione di Shopify Flow |
| Mappatura delle variabili | Assegnare i campi del payload alle variabili di Shopify Flow, facendo riferimento a {{fieldOne}}, {{fieldTwo}}, ecc. |
| Autenticazione | Token statico (semplice) o HMAC SHA256 (a prova di manomissione) |
| Cronologia delle invocazioni | Registro completo di ogni richiesta: data e ora, payload, intestazioni e stato |
| Assistenza CORS | Abilitare le integrazioni basate su browser o front-end |
| Corpo della richiesta personalizzato | Accettare strutture di payload flessibili provenienti da piattaforme di terze parti |
| Pannello di controllo dei webhook | Gestite, monitorate e testate tutti gli endpoint da un'unica piattaforma |
| Protezione contro i duplicati | Ignori le consegne ripetute che riportano un ID evento che ha già visto |
Autenticazione
| Metodo | Come funziona | Ideale per |
|---|---|---|
| Nessuno | Nessuna autenticazione | Solo a scopo di test, non per la produzione |
| Token statico ✓ | È stato corretto il token nell'intestazione X-Api-Key |
La maggior parte delle integrazioni (n8n, Make, Zapier) |
| HMAC SHA256 | Firma generata dal payload e dalla chiave segreta | Alta sicurezza o conformità |
Mappatura delle variabili
Workflow Webhooks Consente di associare i campi del payload JSON in entrata a variabili denominate che Shopify Flow può utilizzare. È possibile definire fino a 4 nomi di campo nella scheda “Impostazioni avanzate”. È inoltre possibile inviare dati aggiuntivi selezionando “Sicurezza” -> “Consenti corpo della richiesta personalizzato”.
| Campo nell'app | La Sua chiave di payload | Riferimento in Shopify Flow |
|---|---|---|
| Campo 1 | name |
{{fieldOne}} |
| Campo 2 | email |
{{fieldTwo}} |
| Campo 3 | question |
{{fieldThree}} |
| Campo 4 | other |
{{fieldFour}} |
Protezione contro le consegne duplicate
La maggior parte dei sistemi riprova a inviare un webhook quando non riceve una risposta immediata. Se il primo tentativo è effettivamente andato a buon fine, il workflow Flow viene eseguito due volte per lo stesso evento: una seconda e-mail, un secondo tag, una nota duplicata.
Se il Suo sistema di invio include un identificativo univoco per ogni evento, assegni tale nome all’intestazione nella sezione “Impostazioni avanzate” -> “Rilevamento delle consegne duplicate” nel webhook; in tal modo, le ripetizioni verranno ignorate.
| Comportamento | |
|---|---|
| Prima richiesta con un determinato ID | Se trattati normalmente, i fuochi scorrono |
| Ripetere entro 24 ore | 200 OK con duplicate: true - non inviato a Shopify Flow |
| ID diverso | Elaborato normalmente |
| Nella richiesta non è presente tale intestazione | Elaborato normalmente |
Nomi comuni delle intestazioni: Event-Id, Idempotency-Key, X-Request-Id. La corrispondenza non tiene conto delle maiuscole e delle minuscole.
# Second call with the same Event-Id is accepted but not re-sent to Flow
curl -X POST https://.../webhook/<short> \
-H "Content-Type: application/json" \
-H "Event-Id: evt_12345" \
-d '{"orderId":"1001"}'Casi d'uso comuni
- Assegnare un tag o aggiornare un cliente di Shopify quando viene inviato un modulo dall'esterno
- Attivare ordini o azioni di evasione da un workflow n8n o Make
- Sincronizzare i dati dei contatti da un CRM o da un helpdesk con Shopify ogni volta che un record viene modificato
- Avviare un’azione Shopify Flow al completamento di un’automazione Zapier
- Attivazione automatica di Fire tramite un modulo frontend (con CORS abilitato)
- Sostituite le numerose integrazioni monouso con un unico gestore di webhook unificato
Guide all’integrazione passo dopo passo
- Come collegare n8n a Workflow Webhooks
- Come collegare Make all'Workflow Webhooks
- Come collegare Zapier a Workflow Webhooks
Cosa dicono i merchant
"Questa app rende Shopify Flow cinque volte più utile. È semplicissimo contattare lo sviluppatore" "e di grande aiuto." - SuperFast Startup, Portogallo
"Il tassello mancante per Shopify Flow: basta un solo Shopify Flow per lavorare con tutti "i vostri webhook." - Senkels, Austria
"Proprio ciò che stavo cercando di risolvere utilizzando una serie di app di terze parti. Davvero "Lo consiglio." - Aloha Tinyboards, Stati Uniti
Installare
Installi Workflow Webhooks dall'App Store di Shopify
Assistenza
Ha bisogno di aiuto? Visiti il sito Assistenza oppure utilizzi la finestra di chat presente in qualsiasi pagina dell’app nella sua area di amministrazione su Shopify.