Trigger del metacampo "Ordine"
Avvia un workflow Shopify Flow quando cambia un metacampo dell'ordine, con Workflow Trigger Extensions, e ottieni il valore precedente e quello nuovo.
Un cliente chiede all’assistenza di aggiungere un biglietto di auguri dopo aver effettuato l’ordine. L’assistenza lo inserisce nel metacampo dell’ordine denominato Messaggio di auguri (custom.gift_message) e il team addetto all’imballaggio deve prenderne visione prima che il pacco venga spedito.
In questa pagina viene illustrato come avviare un workflow Shopify Flow ogni volta che un metacampo di un ordine subisce una modifica, utilizzando Workflow Trigger Extensions. I passaggi sono gli stessi per ogni metacampo di questo tipo di risorsa; nell’esempio viene utilizzato il campo Messaggio regalo (custom.gift_message).
Cosa vi serve
- Una definizione di metacampo. La crei nella Sua area di amministrazione di Shopify alla voce Impostazioni > Metacampi e metaoggetti > Ordini. Un metacampo privo di definizione non può essere monitorato.
- L'autorizzazione Accesso ai dati. La si conceda nella pagina Autorizzazioni dell'app; si veda Autorizzazioni e accesso ai dati.
1. Monitorare il metacampo
- Apra la sezione Trigger dei metacampi nell'app e faccia clic su Aggiungi trigger.
- Selezioni il tipo di risorsa Ordine.
- Selezioni il metacampo, in questo caso Messaggio di accompagnamento al regalo. È possibile selezionarne più di uno contemporaneamente oppure utilizzare l’opzione Seleziona tutto.
- Fare clic su Aggiungi trigger.
Per monitorare tutti i metacampi di questo tipo di risorsa, compresi quelli che creerete in seguito, selezionate Tutti i metacampi anziché spuntare quelli singoli, quindi fate clic su Monitora tutti i metacampi.

Il nuovo trigger mostra il messaggio Inizializzazione mentre l’app legge il valore corrente del metacampo sugli ordini esistenti, per poi passare a Attivo. È proprio grazie a quella prima lettura che la primissima modifica viene già fornita con il valore precedente corretto.
Se il metacampo non è presente nell'elenco, faccia clic su Aggiorna metacampo nella pagina "Trigger dei metacampi": l'app memorizza l'elenco delle definizioni per un'ora.
2. Cosa riceve il workflow
Ogni modifica attiva il trigger Metacampo Update in Shopify Flow con i seguenti valori:
| Variabile | Valore |
|---|---|
resourceType |
ORDER |
resourceId |
L'ID dell'ordine, ad esempio gid://shopify/Order/1234567890 |
metafieldKey |
Spazio dei nomi e chiave, in questo caso custom.gift_message |
metafield.value |
Il nuovo valore |
metafield.previousValue |
Il valore precedente alla modifica; vuoto quando il metacampo è stato impostato per la prima volta |
metafield.type |
Il tipo del metacampo, ad esempio single_line_text_field |
Aggiornamento metafield dell’ordine è un secondo trigger per la stessa modifica. Si avvia in aggiunta all’“Aggiornamento metafield” e riporta l’ordine come riferimento nativo di Flow, pertanto le azioni relative agli ordini di Shopify funzionano su di esso senza necessità di un passaggio di ricerca. Entrambi condividono lo stesso evento, pertanto il loro utilizzo non viene conteggiato due volte. Attivatelo dalla pagina Trigger dell’app oppure attivate un workflow che lo utilizzi.
3. Creare il workflow
- In Shopify Flow, crei un workflow e selezioni il trigger Aggiornamento metacampo delle estensioni Workflow Trigger Extensions.
- Aggiunga una condizione:
resourceTypeè uguale aORDER. L'aggiornamento dei metacampi viene avviato per ogni tipo di risorsa che monitora, pertanto questa condizione limita il workflow agli ordini. Qualora monitori diversi metacampi di questo tipo, aggiunga come secondo criterio chemetafieldKeysia uguale acustom.gift_message. - Aggiunga l'azione desiderata. Nell'esempio viene inviata un'e-mail interna contenente il valore precedente e quello nuovo.

Si parta dall'esempio
- Scarichi il file
.flowallegato in fondo a questa pagina. - Nella dashboard di Shopify, apra Shopify Flow, faccia clic su Importa e selezioni il file.
- Apra la fase Invia e-mail interna e inserisca il destinatario. Il file non contiene alcun indirizzo, intenzionalmente.
- Attivi il workflow.
Lo renda suo
- Contrassegnare l'ordine: selezionare l'azione Aggiungi tag all'ordine e inserire
{{resourceId}}nel relativo campo. - Aggiunga la condizione "il campo
metafield.valuenon è vuoto", in modo che un messaggio rimosso non invii nulla. - Utilizzi l’aggiornamento del metacampo dell’ordine quando il workflow deve leggere gli articoli o l’indirizzo di spedizione.
Con quale rapidità reagisce
Shopify invia una notifica all'app quando viene salvato un ordine, pertanto il workflow si avvia solitamente nel giro di pochi secondi.
Buono a sapersi
- Per impostazione predefinita, l’app monitora gli ordini creati negli ultimi 60 giorni. Per gli ordini più vecchi è necessario disporre dell’accesso completo alla cronologia degli ordini nella pagina “Autorizzazioni” e impostare un intervallo di tempo più ampio nelle impostazioni relative alla cronologia degli ordini dell’app.
Altro
- Trigger dei metacampi: come funzionano i trigger dei metacampi, per ogni tipo di risorsa.
- Attiva Shopify Flow in caso di aggiornamenti dei metacampi dell'ordine: un esempio pratico corredato da un video.
- Cronologia degli eventi e risoluzione dei problemi: visualizza tutti gli eventi inviati dall'app, con il valore precedente e quello nuovo.
