Workflow Transactional EmailWorkflow Transactional Email
Allegare un file da un metacampo relativo a un ordine o a un cliente

Allegare un file da un metacampo relativo a un ordine o a un cliente

Copia pagina

Allega automaticamente alle e-mail di Shopify Flow il PDF salvato in un metacampo dell'ordine o del cliente, senza caricamenti manuali.

Molte app salvano un file relativo all’ordine o al cliente: una fattura o una bolla di consegna in formato PDF proveniente da un’app di fatturazione, un certificato, un contratto firmato. L’Shopify lo archivia in un metacampo, sia come file nella sezione “Shopify Files”, sia come link al file. Questa app è in grado di allegare tale file all’e-mail inviata da un workflow Shopify Flow, senza che l’utente debba caricare o collegare nulla manualmente.

Come funziona

  1. Un’altra app (o voi stessi) inserisce il file, o un link ad esso, in un metacampo dell’ordine o del cliente. Nella vostra area di amministrazione di Shopify, si trova in Impostazioni > Dati personalizzati > Ordini (o Clienti): una definizione di tipo File, URL o un campo di testo in cui un’app inserisce un link.
  2. Nel layout di un’e-mail, quando si aggiunge un allegato e si seleziona “Metacampo” come origine, occorre poi scegliere quella definizione. Il selettore mostra il contenuto di ciascuna opzione: un file, un link o un elenco di entrambi.
  3. In Shopify Flow, la fase “Invia e-mail transazionale” o “Invia e-mail di marketing” presenta un campo “Ordine” e un campo “Cliente”. Shopify Flow li compila in base al trigger, pertanto un Workflow avviato dall’evento “Ordine creato” sa già a quale ordine si riferisce.
  4. Una volta inviata l’e-mail, l’app legge quel metacampo relativo all’ordine o al cliente, scarica il file (dalla sezione Shopify o dal link) e lo allega. Un metacampo di tipo “elenco” allega ogni voce.

Il layout indica solo il nome del metacampo. Il workflow specifica a quale ordine o cliente si riferisce, pertanto un unico layout è sufficiente per tutti gli ordini.

Un passaggio “Invia e-mail transazionale” appena aggiunto in Shopify Flow, con il campo “Ordine” impostato su order.id e il campo “Cliente” su order.customer.id, sopra i campi “A”, “CC” e “BCC”
Il passaggio in Shopify Flow: “Ordine” e “Cliente” vengono popolati dal trigger, in questo caso un workflow relativo agli ordini. Un passaggio aggiunto prima della versione 1.17 non dispone di tali campi; lo elimini e lo aggiunga nuovamente.
Il metacampo contiene Tipo di definizione Cosa fa l'app
Un file di Shopify File, Elenco dei file Segue il riferimento al file presente nella cartella “File” e lo scarica
Un link URL, elenco di URL o campo di testo Scarica il file da quel link. Funzionano solo i link di tipo https://; un link che non risponde o che rimanda a qualcosa di diverso da un PDF, un’immagine, un file CSV o un file di testo causa il fallimento dell’invio con la motivazione

In ogni caso, la dimensione viene verificata al momento dell’invio dell’e-mail, non nell’editor; pertanto, gli allegati dei metacampi non vengono conteggiati nel totale degli allegati dell’editor.

Configuratelo

Formattazione RTF e layout HTML

Nella scheda “Allegati” nella parte inferiore dell’editor, faccia clic su “Aggiungi da metacampo”. Selezioni “Ordine” o “Cliente”, quindi la definizione. La riga mostra il nome della definizione, il suo contenuto e il suo namespace.key; facendo clic su “Modifica” se ne seleziona un’altra.

La scheda “Allegati” di un layout in formato RTF con i pulsanti “Aggiungi allegato”, “Aggiungi da URL” e “Aggiungi da metacampo”
Scheda “Allegati” di un layout in formato RTF o HTML: “Aggiungi da metacampo” accanto ai pulsanti di caricamento e URL.

Disposizioni grafiche

Aggiunga un blocco “Allegato” (o ne apra uno) e imposti la sua origine su “Metacampo”. Selezionando “Metacampo” si aprirà lo stesso selettore.

Un blocco di allegati nel Visual Builder con la fonte impostata su Metacampo, il pulsante “Scegli metacampo”, la sostituzione del nome del file e la casella di controllo “Facoltativo”
Il blocco degli allegati con Metacampo come origine: selezionate la definizione, modificate il nome del file e stabilite se un metacampo vuoto comporti il blocco dell’invio dell’e-mail.
La finestra di dialogo “Allega un file da un metacampo” con “Ordine” selezionato come risorsa e le definizioni “PDF della fattura (File)” e “URL della fattura (Link)” elencate sotto un campo di ricerca
Il selettore: prima l’ordine o il cliente, poi le definizioni di tale risorsa, ciascuna con i relativi contenuti. È selezionato il PDF della fattura.
Il blocco degli allegati dopo aver selezionato il metacampo: PDF della fattura, File, Ordine custom.invoice_pdf, un pulsante “Modifica metacampo”, la sovrascrittura del nome del file e la casella di controllo “Facoltativo”
Il blocco successivo alla scelta: il nome della definizione, il suo contenuto e il suo namespace.key. La selezione del metacampo ne sceglie un altro.

L'autorizzazione

L'app viene installata senza alcun accesso ai dati del Suo negozio. La prima volta che seleziona un metacampo relativo a un ordine o a un cliente, il selettore richiede l'autorizzazione a leggere i metacampi di tale risorsa e i file a cui essi fanno riferimento. Shopify visualizza la propria finestra di dialogo di consenso; dopo aver cliccato su "Aggiorna", viene caricato l'elenco delle definizioni.

È possibile verificare e revocare ogni autorizzazione in qualsiasi momento dalla pagina “Autorizzazioni” dell’app. La revoca di un’autorizzazione comporta il blocco di tutte le e-mail che allegano un file proveniente da tale metacampo, fino a quando l’autorizzazione non venga nuovamente concessa. La descrizione dettagliata di ciascuna autorizzazione, con l’indicazione di ciò che essa consente e di ciò che non consente, è disponibile all’indirizzo Autorizzazioni: quali dati l’app può leggere dal vostro negozio.

La pagina “Autorizzazioni” che elenca “Ordini” e “File” come “Concessi” con i pulsanti “Revoca”, e “Clienti” e “Sconti” come “Non concessi” con i pulsanti “Concedi”, ciascuno con il proprio ambito di applicazione
La pagina “Autorizzazioni”: ogni autorizzazione facoltativa con il relativo ambito di applicazione, concessa o meno, e un pulsante per concederla o revocarla. In questo caso, le autorizzazioni relative a “Ordini” e “File” sono state concesse tramite il selettore.

Nome del file

Per impostazione predefinita, l’allegato mantiene il nome del file stesso: il nome presente nei Suoi file di Shopify o l’ultima parte del link. Il campo “Nome file” sovrascrive tale nome e supporta Liquid; ad esempio, invoice-{{ variables.order_name }}.pdf. Quando un metacampo di tipo “elenco” contiene più voci, alla seconda e alle successive viene aggiunto -2, -3 alla sovrascrittura.

Quando il metacampo è vuoto

L'app che scrive il file viene spesso eseguita alcuni secondi dopo il trigger, pertanto nel momento in cui viene eseguito il passaggio relativo all'e-mail il metacampo potrebbe essere ancora vuoto. Ciò che accade in tal caso dipende dalla casella di selezione “Opzionale” dell'allegato:

Facoltativo Comportamento
Disattivato (impostazione predefinita) L'e-mail non è ancora stata inviata. L'app richiede a Shopify Flow di riprovare a eseguire l'operazione e Shopify Flow provvede a inviarla nuovamente poco dopo; l'e-mail viene inviata non appena il file è disponibile.
Il L'e-mail viene inviata senza questo allegato.

Lo lasci disattivato per una fattura che deve essere presente. Lo attivi per un file presente solo in alcuni ordini.

Requisiti e limiti

  • Per il passaggio di Shopify Flow è necessario impostare il campo “Ordine” o “Cliente”. I passaggi aggiunti prima di questa versione non dispongono ancora di tali campi: elimini il passaggio nell’editor di Shopify Flow e lo aggiunga nuovamente.
  • File di dimensioni fino a 10 MB ciascuno; file PDF, immagini, CSV, testo semplice e file di calendario. I video e i modelli 3D vengono ignorati.
  • I link devono iniziare con https:// ed essere accessibili senza effettuare il login. Un link che reindirizzi a un indirizzo non https o a una rete privata verrà rifiutato.
  • Ordini degli ultimi 60 giorni. L’interfaccia di programmazione delle applicazioni (Shopify) consente alle app di leggere solo gli ordini recenti. Nel caso di un workflow relativo a un ordine più vecchio, l’invio fallisce con un messaggio chiaro.
  • Microsoft 365 rifiuta i messaggi con allegati di dimensioni complessive superiori a 4 MB; si veda Allegati e immagini.

Ciò che si vede nella Storia

Ogni risultato è riportato nella pagina “Cronologia”. Un’operazione senza ordine, un’autorizzazione revocata, un ordine che Shopify non riesce a individuare, un link che non risponde o un file che supera il limite vengono registrati come “Fallito”, con l’indicazione del motivo e delle modifiche da apportare. Un metacampo vuoto con l’opzione «Opzionale» disattivata non costituisce un errore: Shopify Flow mostra i tentativi di ripetizione e l’invio viene visualizzato non appena il file è disponibile. Una «Reinvio» dalla Cronologia rielabora lo stesso ordine o lo stesso cliente.

Un evento "History" relativo a un'e-mail contenente le istruzioni per il reso, i cui dati della richiesta riportano l'orderId dell'ordine da cui è stata estratta la fattura
Un’e-mail con un allegato proveniente da un metacampo nella Cronologia: i dati della richiesta registrano quale ordine è stato letto, pertanto la funzione “Invia nuovamente” lo legge nuovamente.

Provatelo

L'invio di un'e-mail di prova nell'editor di layout non dispone di un ordine o di un cliente da cui attingere, pertanto l'e-mail viene inviata senza allegati dei metacampi. Per testare l'allegato, esegua il workflow in Shopify Flow su un ordine che contenga già il file, oppure utilizzi l'opzione "Esegui su un flusso" con un ordine di questo tipo.

Correlati