Registro delle modifiche

L'app parla la vostra lingua

L'intera app ora adotta la lingua che utilizzate nell'area di amministrazione di Shopify. È disponibile in inglese, tedesco, francese, spagnolo, italiano, olandese, danese, portoghese (Brasile e Portogallo), giapponese e cinese (semplificato e tradizionale). Modificate la lingua dell'area di amministrazione e l'app si adeguerà al successivo caricamento della pagina.

• Ogni pagina, finestra di dialogo e messaggio è tradotto, compresi l’editor dei webhook, lo strumento di verifica delle firme e la relativa diagnostica passo dopo passo, la Cronologia e la pagina della Guida.
• I modelli di workflow mostrano il titolo, la descrizione e le note di configurazione nella Sua lingua in Shopify Flow.
• Le date e i numeri vengono visualizzati secondo le convenzioni di scrittura della Sua lingua.
• Anche questo centro assistenza è stato tradotto. Tutte le guide sono disponibili nelle stesse lingue; selezionate la vostra dal menu delle lingue.
• I nomi dei trigger e delle azioni rimangono in inglese. Shopify Flow mostra i nomi dei passaggi in inglese, pertanto anche l’app li riporta in inglese: il nome visualizzato nell’app è sempre quello che si trova in Shopify Flow. Anche i nomi dei campi del payload, come ad esempio fieldOne, non subiscono alcuna modifica.

Sette workflow predefiniti in Shopify Flow

Apra Flow, selezioni "Sfoglia modelli" e cerchi "webhook". Ogni modello rappresenta un workflow completo basato sul trigger Webhook; è sufficiente creare il webhook e configurare il proprio sistema in modo che vi si colleghi.

• Ordine dei tag al ricevimento di un webhook: un 3PL, un ERP o uno strumento no-code contrassegna gli ordini come spediti, fatturati o verificati.
• Aggiungere una nota all’ordine alla ricezione di un webhook - aggiungere un messaggio proveniente da uno strumento di assistenza o da un sistema ERP alla nota dell’ordine.
• Contrassegnare l'ordine come pagato al ricevimento del webhook, ovvero quando la Sua banca, il sistema di fatturazione o il sistema di pagamento confermano il pagamento.
• Assegnare un tag al prodotto alla ricezione del webhook: un fornitore, un sistema PIM o un ERP mantiene sincronizzate le collezioni e i badge.
• Creare un cliente alla ricezione di un webhook: acquisire i lead dalle pagine di destinazione e dai moduli.
• Aggiornamento del metacampo del cliente alla ricezione di un webhook: un sistema di fidelizzazione, CRM o a punti memorizza un numero associato al cliente.
• Restituire lo stato dell’ordine alla ricezione del webhook: fornire a un chatbot, a un servizio di assistenza o a un portale clienti informazioni sullo stato del pagamento e dell’evasione di un ordine, utilizzando la risposta sincrona.

Le note di configurazione di ciascun modello indicano quali campi mappare. Si veda Modelli di workflow.

Il nuovo design dell’area di amministrazione di Shopify

Shopify sta introducendo un nuovo design per l'area di amministrazione. Nei negozi in cui è già disponibile, Workflow Webhooks utilizza ora gli stessi colori, lo stesso stile tipografico e le stesse icone, in modo che l'app abbia lo stesso aspetto del resto della vostra area di amministrazione. Nei negozi in cui non è ancora disponibile, non cambia nulla.

I Suoi webhook possono ora essere eseguiti a intervalli prestabiliti, verificare la firma di quasi tutti i mittenti e accettare formati diversi dal JSON.

Eseguire un workflow a intervalli prestabiliti da qualsiasi API

Una nuova scheda “Pianificazione” su ogni webhook e un accesso diretto: selezionate “Crea webhook” e rispondete alla domanda “Cosa attiverà questo webhook?” con “Nulla - eseguirlo secondo una pianificazione”. L’app recupera un URL ogni 5 minuti, fino a una volta al giorno, e invia la risposta al webhook; in questo modo, un workflow di tipo Shopify Flow può essere eseguito a intervalli prestabiliti da qualsiasi API.

• Eseguire “fire” ad ogni recupero, oppure solo quando la risposta è cambiata.
• Aggiunga le intestazioni della richiesta qualora l'API le richieda. Esse vengono memorizzate in forma crittografata.
• L'esecuzione ora effettua una sola richiesta e Le mostra la risposta.
• Questa scheda mostra come il programma si allinea al vostro piano. Le sessioni di corsa compaiono nella Cronologia come “In programma”.
• Una pianificazione che fallisce 20 volte di seguito si sospende automaticamente.

Si veda Interrogazione periodica degli URL.

Verifica della firma per quasi tutti i mittenti

22 impostazioni predefinite integrate, rispetto alle precedenti 6, ciascuna verificata in base alla documentazione fornita dal rispettivo fornitore: Stripe, GitHub, Shopify, Slack, Typeform, Calendly, Webhook standard (OpenAI, Supabase), Svix (Clerk, Resend), Paddle, Linear, WooCommerce, Square, Sentry, Vercel, Zendesk, Lemon Squeezy, Razorpay, Paystack, Customer.io, Sendcloud, Mollie e Sanity.

• Un mittente privo di impostazioni predefinite è coperto da una firma personalizzata: si scelgono l’intestazione, l’algoritmo, la codifica, un timestamp con protezione contro la riproduzione e il testo esatto da firmare.
• Un tester di firme presente nell'editor indica quale fase di verifica non ha avuto esito positivo ed è in grado di generare una richiesta di esempio valida.
• Per creare un webhook occorre innanzitutto stabilire quali dati vi verranno inviati.

Si veda Verifica dei webhook firmati, dove è disponibile una guida dettagliata per ciascun mittente.

Ulteriori modalità di autenticazione

• Un token statico può ora essere fornito come token Bearer, tramite autenticazione Basic (nome utente e password) o come parametro URL, per i mittenti che non sono in grado di impostare un’intestazione personalizzata. Un token presente nell’URL viene mascherato nella Cronologia e non viene mai trasmesso a Shopify Flow.
• Eseguire la rotazione di una chiave segreta senza tempi di inattività. Una seconda chiave segreta viene accettata parallelamente alla prima, per i token statici e per ogni schema di firma.
• Lista bianca degli indirizzi IP. Limitate l’accesso all’URL agli indirizzi o agli intervalli da voi specificati, oltre a qualsiasi procedura di autenticazione. Si veda Elenchi di indirizzi IP autorizzati.

Si veda il sito Autenticazione.

Moduli e corpi XML, nonché la suddivisione degli array

• I moduli di invio, i moduli per il caricamento di file e i dati XML vengono ora letti in campi mappabili esattamente come il JSON. Un corpo del messaggio che sia JSON valido continua a essere letto come JSON, pertanto il comportamento dei mittenti esistenti non subisce alcuna modifica.
• Suddividere gli array in esecuzioni. Indicare alla nuova impostazione un elenco contenuto nel payload e ogni elemento avvierà una propria esecuzione di Shopify Flow, fino a un massimo di 100 per richiesta. Ogni elemento conta come una singola chiamata.

Si veda il sito Formati del corpo e suddivisione degli array.

Un’app più veloce, riprogettata sulla base dei componenti web di Shopify

L’intera app ora funziona sui componenti web della stessa area di amministrazione di Shopify, anziché su una libreria di interfaccia separata. I dati da caricare sono minori, pertanto le pagine si aprono più rapidamente e ogni campo, menu e finestra di dialogo presenta lo stesso aspetto e lo stesso comportamento del resto della vostra area di amministrazione.

• L'editor dei webhook è uno strumento di creazione. A sinistra si trovano le impostazioni; a destra, la scheda "Endpoint" con l'URL e l'ID del webhook, mentre in alto sono presenti le opzioni "Anteprima in tempo reale", "Prova" e "Utilizzo": in questo modo è possibile modificare un'impostazione e osservare contemporaneamente l'arrivo di una richiesta.
• L'elenco dei webhook mostra ciascun webhook con il numero di invocazioni, le modalità di autenticazione dei chiamanti e la data dell'ultima modifica, con un menu per ogni riga che consente di modificare, abilitare, disabilitare o eliminare il webhook.
• Collegamento di un mittente autenticato. Un webhook per Stripe, GitHub o un altro fornitore mostra i passaggi necessari per collegarlo e un pulsante che rimanda alla relativa guida alla configurazione, anziché una richiesta di esempio che non potrebbe mai essere verificata.

Inoltre, in questa versione

• Richieste bloccate nella dashboard. Le richieste respinte a causa del raggiungimento del limite del Suo piano in precedenza non lasciavano traccia. La dashboard ora mostra quante sono state bloccate negli ultimi 30 giorni e la scheda del piano funge da contatore di utilizzo.
• L'impaginazione nell'elenco dei webhook funziona correttamente e l'opzione “Cancella tutto” nella Cronologia cancella anche il filtro “Riprodotti”.
• Ogni pagina rimanda alla relativa guida nel Centro assistenza, mentre la pagina "Aiuto" elenca le nostre altre app per Shopify Flow.
• Manutenzione ordinaria dei sistemi di sicurezza. Non è richiesta alcuna azione.

Finora un webhook poteva solo confermare la ricezione di una richiesta: il workflow su Shopify Flow veniva eseguito successivamente e il richiedente non veniva mai a conoscenza del risultato. La risposta sincrona cambia questa situazione: l’app mantiene aperta la richiesta fino a quando il workflow non restituisce i dati, per poi trasmetterli al richiedente.

Utile ogni volta che il chiamante necessita di una risposta piuttosto che di una conferma - un modulo che mostri un risultato, un sistema in attesa di un valore calcolato, una ricerca.

Come funziona

Attivi l’opzione “Risposta sincrona” nelle Impostazioni avanzate del webhook. Successivamente, crei il workflow basandolo sul nuovo trigger “Sync Webhook” e lo concluda con la nuova azione “Risposta al webhook di ritorno”.

Scriva il corpo della risposta direttamente nell'azione utilizzando le variabili del trigger:

{"ok": true, "orderId": "{{fieldOne}}", "email": "{{fieldTwo}}"}

oppure creare qualcosa di più complesso nell'azione "Esegui codice" e associarvi il risultato.

La durata tipica di una richiesta di andata e ritorno è compresa tra due e quattro secondi. Se il Suo workflow non risponde entro 15 secondi, il chiamante riceve semplicemente la risposta standard: mai un messaggio di errore e mai un blocco del sistema.

Guida completa: Risposta sincrona

Nulla cambia a meno che non lo accenda

Disattivata per impostazione predefinita su tutti i webhook. I webhook esistenti continuano a rispondere immediatamente e a utilizzare il trigger Webhook standard, esattamente come in precedenza.

L'API REST e il server MCP dispongono ora di una sede fissa tutta loro:

https://shopify.workflow-webhooks.app

Pertanto, l'API è disponibile all'indirizzo https://shopify.workflow-webhooks.app/api/v1 e il server MCP all'indirizzo https://shopify.workflow-webhooks.app/api/mcp. Entrambi sono indicati con un pulsante "Copia" nella pagina "Sviluppatori".

In precedenza, questi erano ospitati sull’URL incorporato nell’app. Separarli significa che l’indirizzo che incollate in uno script, in un processo di CI o in un assistente AI è stabile e indipendente dal modo in cui l’app è incorporata nella vostra area di amministrazione. Il nuovo nome host serve esclusivamente per l’API: l’app stessa rimane dove si trovava e non è necessario modificare nulla di quanto abbiate già configurato.

Molta più documentazione

Sono state pubblicate nove nuove pagine ai seguenti indirizzi: , docs.workflow-webhooks.app e:

• Creare il proprio primo webhook: una guida completa, che include anche la configurazione del lato Shopify Flow
• Autenticazione: token statico, HMAC e impostazioni predefinite per Stripe, GitHub, Shopify, Slack, Typeform e Calendly
• Mappatura del payload e variabili di flusso: percorsi “dot”, valori annidati e cosa fare quando quattro campi non sono sufficienti
• Protezione contro le consegne duplicate
• Cronologia e risoluzione dei problemi: tutti i codici di errore e come risolverli
• Chiamata di un webhook da Shopify Flow
• Piani e utilizzo: cosa viene conteggiato ai fini del raggiungimento del limite e cosa no
• Sidekick e assistenti basati sull’intelligenza artificiale
• Domande frequenti

È stata pubblicata anche la guida alle API per sviluppatori e all’MCP.

La maggior parte dei sistemi riprova a inviare un webhook se non riceve una risposta immediata. Se il primo tentativo è effettivamente andato a buon fine, il Suo workflow Shopify Flow viene eseguito due volte per lo stesso evento: una seconda e-mail, un secondo tag, una nota d’ordine duplicata.

La protezione contro le consegne duplicate risolve il problema. Se il vostro sistema di invio include un ID univoco per ogni evento, indicateci in quale intestazione è contenuto e noi ignoreremo i duplicati.

Lo configuri in Impostazioni avanzate -> Duplicazione dell'invio su qualsiasi webhook. Inserisca il nome dell'intestazione utilizzato dal mittente - solitamente Event-Id, Idempotency-Key o X-Request-Id.

• La prima richiesta con un determinato ID viene eseguita normalmente.
• Qualsiasi ripetizione entro 24 ore riceve una normale risposta di tipo 200 OK, pertanto il mittente interrompe l’invio si sta riprovando, ma il messaggio non viene inviato nuovamente a Shopify Flow.
• I duplicati eliminati non vengono conteggiati ai fini del limite del Suo piano.
• È ancora possibile visualizzarle: Live Request Inspector mostra la richiesta e la contrassegna come ha eliminato il duplicato, in modo che non sembri mai che la chiamata sia scomparsa.

Se lascia il campo vuoto, non cambia nulla: ogni richiesta viene elaborata esattamente come prima. Questa opzione è disattivata per impostazione predefinita su tutti i webhook esistenti.

Gestite i vostri webhook direttamente dal vostro codice oppure tramite un assistente basato sull’intelligenza artificiale, come Claude o Cursor.

• Nuova pagina per gli sviluppatori: create chiavi API con ambito limitato e ottenete comandi Connect pronti per essere copiati per Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI e OpenAI Codex.
• API REST all'indirizzo /api/v1: elenca e gestisce i webhook, consente di consultare la cronologia delle chiamate e le statistiche, nonché di elencare i modelli.
• Il server MCP all'indirizzo /api/mcp, in modo che un assistente AI possa fare lo stesso durante una conversazione.
• Tre livelli di accesso. Le chiavi di lettura consentono solo la consultazione. Le chiavi di scrittura consentono inoltre di creare, aggiornare ed eliminare i webhook. Le chiavi di esecuzione consentono inoltre di avviare una chiamata di prova o di riprodurre una chiamata precedente, il che consente effettivamente di eseguire i vostri workflow Shopify Flow.
• I Suoi dati rimangono protetti. Il token di autenticazione di un webhook non è mai leggibile tramite l’API e i dati personali contenuti nei payload delle richieste (indirizzi e-mail, numeri di telefono, nomi, numeri di carta) vengono mascherati prima di lasciare il server.

Flow Webhooks Ora si chiama Workflow Webhooks. Stessa app, stessa installazione, stessi webhook: un nuovo nome, in linea con il resto della nostra gamma Workflow.

• Nuovo sito di documentazione all'indirizzo docs.workflow-webhooks.app, con le guide complete su n8n, Make e Zapier, comprese le guide video.
• Nuovo Centro assistenza: segnalate un bug, richiedete una funzionalità o contattateci tramite un apposito modulo che ci raggiunge direttamente, allegando degli screenshot.
• Chat integrata nell'app: il fumetto della chat è ora presente su ogni pagina dell'app e si nasconde con discrezione quando è aperta una finestra di dialogo.
• Guida alla configurazione disponibile nella dashboard, che La accompagna dal Suo primo webhook fino alla creazione di un workflow Shopify Flow funzionante. La guida ricorda se l’ha compressa o meno.

Manutenzione ordinaria della sicurezza: aggiornamenti delle dipendenze e rafforzamento della sicurezza in tutta l’applicazione. Non è richiesta alcuna azione da parte vostra.

• Notifiche via e-mail: riceva un avviso quando si avvicina al limite del Suo piano, quando lo raggiunge e quando i Suoi webhook iniziano a fallire più del solito. Aggiunga destinatari aggiuntivi oltre al titolare del negozio, ciascuno con il proprio link per annullare l'iscrizione.
• Impostazioni predefinite per la firma HMAC: si adattano allo schema di firma dei mittenti più comuni senza dover definire manualmente il formato.
• Attivare l’invio di ulteriori dati relativi alle richieste: per ciascun webhook, scegliere se inoltrare a Shopify Flow le intestazioni della richiesta, i parametri della stringa di query e il corpo della richiesta non elaborato.
• Cercare nella cronologia delle chiamate in base al contenuto del payload.

Sidekick è ora in grado di rispondere direttamente alle domande relative a questa app. Potete porre domande del tipo: «Ho un webhook per il mio modulo di contatto?», «Il mio webhook n8n è abilitato?», «Quante volte è stato attivato questa settimana?» oppure «Perché la mia ultima chiamata non è andata a buon fine?».

Solo lettura - Sidekick può visualizzare i Suoi webhook, la loro configurazione e la cronologia delle loro chiamate, ma non può apportare alcuna modifica.

Workflow Webhooks ora è ospitato su una nuova piattaforma cloud europea. Non cambia nulla per quanto riguarda il suo utilizzo, ma a livello tecnico:

• L'elaborazione dei webhook è stata trasferita in una coda gestita dotata di gestione dei messaggi non recapitabili, pertanto una richiesta non viene mai ignorata.
• I database e le cache sono gestiti a livello regionale all’interno dell’UE e sono sottoposti a crittografia in fase di archiviazione.
• I segreti commerciali - i vostri token statici e le chiavi HMAC - vengono ora crittografati tramite un servizio dedicato alla gestione delle chiavi, anziché essere semplicemente archiviati in forma crittografata a livello di disco.
• Istanze ridondanti distribuite tra le zone di disponibilità.

Il risultato è una minore latenza nella ricezione dei webhook e un comportamento decisamente migliore sotto carico.

• Intestazione con token statico personalizzata: l'intestazione del token non deve più essere necessariamente X-Api-Key. Impostate il nome desiderato per ciascun webhook nelle “Impostazioni avanzate”, in modo che corrisponda a quello già inviato dal sistema di origine. I nomi delle intestazioni riservati e controllati dal proxy vengono rifiutati per motivi di sicurezza.
• Aggiornamento automatico della sessione: i token di accesso vengono ora aggiornati in background, pertanto i negozi di lunga durata non registrano più errori di consegna a seguito della scadenza di un token.
• Tentativi di riinvio più intelligenti: in caso di consegne non andate a buon fine, si effettua un nuovo tentativo con un intervallo di attesa; in caso di errori permanenti, i tentativi vengono interrotti immediatamente, evitando così di esaurire il numero di tentativi a disposizione.

• Sono stati aggiunti indici al database per velocizzare le query relative alla cronologia e alle statistiche nei negozi con elevato traffico.
• È stato aggiunto il monitoraggio delle prestazioni da parte degli utenti reali, in modo da individuare le pagine lente nell’area di amministrazione.
• Verifica della sicurezza nell'app: aggiornamenti delle dipendenze ed eliminazione del rendering HTML non sicuro.

• Abbiamo riorganizzato la dashboard incentrandola sulle schede metriche, su un selettore di intervallo di date e su un grafico delle invocazioni.
• Le modifiche non salvate sono ora protette. Quando si modifica un webhook, viene visualizzata la barra di salvataggio di Shopify; inoltre, se si cambia scheda o si preme il pulsante “Indietro” mentre sono presenti modifiche in sospeso, verrà visualizzata una richiesta di conferma prima che tali modifiche vengano automaticamente ignorate.

Cronologia dei webhook reindicizzata. I negozi con elevati volumi di richiami noteranno che la pagina della cronologia e la dashboard si caricano in modo notevolmente più veloce.

• Riproduci: aprite qualsiasi invocazione precedente e inviatela nuovamente con un solo clic. Questo è il modo più rapido per configurare un workflow in Shopify Flow: registrate gli eventi in Shopify Flow, quindi riproducete una chiamata effettiva anziché riattivare il sistema di origine.
• Modelli di webhook: punti di partenza preconfigurati per n8n, Make, Zapier, moduli di contatto e integrazioni personalizzate.

• È stato risolto un caso limite relativo all'autenticazione che poteva comportare il rifiuto di richieste valide.
• È stata risolta la questione relativa al percorso del proxy, in modo che gli URL del proxy dell’applicazione vengano instradati correttamente.
• È stato corretto un errore di visualizzazione nell'elenco dei webhook.

• Azione di Shopify Flow: direzione inversa. Un workflow di Shopify Flow può ora richiamare un webhook come fase dell’azione, consentendo a Shopify Flow non solo di inviare dati, ma anche di essere attivato da essi.
• Statistiche della dashboard: numero totale di richiami, percentuale di successo e un grafico relativo all'intervallo di date da Lei selezionato.
• Tracciamento dell’origine delle chiamate: la cronologia ora registra se una chiamata proviene da Shopify Flow, da un test, da curl o da un sistema esterno, ed è possibile filtrare i dati in base a tale criterio.

Shopify Flow Le variabili sono stringhe piatte, pertanto in passato gli oggetti e gli array annidati risultavano inutilizzabili.

I valori che sono oggetti o array vengono ora rilevati automaticamente e trasmessi a Shopify Flow come stringhe JSON, in modo che nulla vada perso silenziosamente durante il trasferimento.

Sono stati introdotti piani di abbonamento con un limite mensile di invocazioni e un monitoraggio dell'utilizzo sulla dashboard, in modo da poter verificare a quanto ammontano le invocazioni effettuate rispetto al limite previsto.

Ogni piano include tutti i metodi di autenticazione, la mappatura dei campi, il CORS, la cronologia e la riproduzione; i piani si differenziano solo per il volume mensile.

• Endpoint del proxy dell'app: ogni webhook è ora raggiungibile anche tramite un URL del proxy dell'app Shopify, il che consente di evitare problemi di cross-origin per gli utenti che effettuano le richieste tramite browser.
• Filtro per intervallo di date nella pagina della cronologia, che consente di individuare con precisione il giorno in cui si è verificato un problema, evitando di dover scorrere la pagina.

Quattro campi mappati non sono sempre sufficienti. Attivando l'opzione "Consenti corpo della richiesta personalizzato" nelle impostazioni di sicurezza di un webhook, l'intero payload in entrata verrà inoltrato a Shopify Flow, oltre ai quattro campi specificati.

Utile quando non è possibile controllare la struttura del payload del sistema mittente.

• La configurazione dei webhook viene ora memorizzata nella cache, pertanto la ricezione di una chiamata richiede meno risorse e garantisce una risposta più rapida.
• Webhook disattivati sono chiaramente contrassegnati nell'elenco, pertanto è immediatamente evidente il motivo per cui uno di essi non si attiva.
• È stata rielaborata la pagina dei dettagli dei webhook, oltre a una serie di correzioni minori.

La prima versione. Shopify Flow reagisce solo agli eventi all’interno di Shopify: questa versione elimina tale limitazione.

• Endpoint dei webhook: ogni webhook dispone di un proprio URL sicuro a cui qualsiasi sistema esterno può inviare una richiesta POST.
• Tre modalità di autenticazione: "Nessuna" per i test, un token statico nell’intestazione X-Api-Key oppure HMAC SHA256 per una firma a prova di manomissione.
• Mappatura del payload: mappi fino a quattro campi del JSON in entrata e li utilizzi in Shopify Flow come {{fieldOne}} a {{fieldFour}}.
• Cronologia delle chiamate: ogni chiamata viene registrata con le relative intestazioni, il payload, lo stato e i tempi.
• Supporto CORS: attivatelo per accettare le chiamate direttamente da un browser o da un modulo della vetrina online.
• Dashboard dei webhook: create, attivate, disattivate e gestite in blocco tutti gli endpoint da un'unica interfaccia, grazie a un generatore di token con un solo clic.