Vai al contenuto principale
— Riferimento

Trigger di Shopify Flow e relativi campi

Alva Courses invia 13 trigger a Shopify Flow. Questo riferimento elenca quando si attiva ciascuno e tutti i campi che porta con sé, così puoi creare condizioni e compilare i passaggi delle azioni con i dati giusti.

Usare i campi dei trigger

Ogni trigger di Alva Courses inizia con lo studente come cliente Shopify, seguito da Course ID, Course title e Course URL. I trigger delle lezioni aggiungono Lesson ID, Lesson title e Lesson URL. Ogni campo viene sempre inviato: un testo non pertinente è vuoto e un numero non pertinente è 0.

In una Condizione, scegli il campo dai dati del trigger. Nel testo di un'azione, inseriscilo con Aggiungi una variabile. Lì Flow scrive il nome di ogni campo in camelCase, quindi Course title diventa {{ courseTitle }}. Usa il selettore invece di digitare i nomi, così i campi con ID o URL nel nome risultano esattamente corretti.

I link ai corsi e alle lezioni aprono la tua vetrina, dove lo studente accede per vedere il corso. Date e orari sono testo in formato ISO 8601 e in UTC, ad esempio 2026-10-01T09:30:00.000Z.

Trigger di iscrizione e progressi

Questi trigger seguono uno studente lungo un corso, dall'iscrizione al completamento. Usali per assegnare tag o ringraziare gli studenti, sincronizzare i progressi con uno strumento email o ricevere un avviso quando un quiz va male. Ognuno si attiva una volta per ogni cambiamento reale, mai per una richiesta ripetuta.

Course enrollment created

Un cliente è stato iscritto a un corso di Alva tramite acquisto, da te, oppure con un'importazione CSV, un tag di iscrizione, l'iscrizione gratuita in autonomia o un'azione di Flow.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente iscritto, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Enrollment source Testo Come è stato iscritto lo studente: purchase, manual, import, membership tag, free o flow
Order name Testo L'ordine che ha concesso l'accesso, ad esempio #1001. Vuoto se non acquistato
Access expires at Testo Scadenza di accesso dello studente (ISO 8601). Vuoto significa nessuna scadenza

Si attiva una volta, quando viene creata l'iscrizione. Estendere, rinnovare o ripristinare l'accesso non lo attiva di nuovo; rimuovere uno studente e iscriverlo di nuovo sì, perché si tratta di una nuova iscrizione. Un'iscrizione creata dall'azione Enroll customer in course ha Enrollment source impostato su flow.

Course lesson completed

Uno studente ha completato una lezione in un corso di Alva. Si attiva di nuovo se la completa ancora dopo la reimpostazione dei suoi progressi; vedi Repeat completion.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha completato la lezione, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Lesson ID Testo L'ID della lezione di Alva
Lesson title Testo Il titolo della lezione
Lesson URL URL Link alla lezione nella vetrina
Lessons completed Numero Lezioni che lo studente ha completato in questo corso
Total lessons Numero Lezioni del corso
Percent complete Numero Avanzamento del corso, da 0 a 100
Repeat completion Vero o falso Indica se lo studente aveva già completato questa lezione e i suoi progressi sono stati reimpostati nel frattempo. Aggiungi una condizione su questo campo per premiare ogni lezione una sola volta

Si attiva la prima volta che uno studente completa una lezione. Completarla di nuovo non invia nulla, a meno che nel frattempo i suoi progressi non siano stati reimpostati: in quel caso si attiva di nuovo con Repeat completion impostato su true. Per premiare ogni lezione una sola volta, aggiungi una condizione in cui Repeat completion è false.

Course completed

Uno studente ha completato un corso di Alva: tutte le lezioni, gli eventuali quiz obbligatori e una valutazione superata, se il corso la richiede.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha completato il corso, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Completed at Testo Quando è stato completato il corso (ISO 8601)
Grade Testo Il voto in lettere della valutazione. Vuoto se il corso non lo prevede
Final score Numero Il punteggio della valutazione. 0 se il corso non lo prevede
Evaluation required Vero o falso Indica se un docente ha dovuto approvare l'elaborato dello studente

Si attiva la prima volta che uno studente completa il corso. Per un corso che richiede una valutazione, è il momento in cui approvi il suo elaborato, non quando termina l'ultima lezione. Se reimposti i suoi progressi, o lo fa l'azione Reset course progress, completare di nuovo il corso lo attiva di nuovo; uno studente che reimposta da solo i propri progressi no.

Course quiz graded

Il tentativo di quiz di uno studente in un corso di Alva è risultato superato, non superato o scaduto. I quiz che richiedono una revisione manuale si attivano dopo che li hai revisionati.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha svolto il quiz, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Lesson ID Testo L'ID della lezione di Alva
Lesson title Testo Il titolo della lezione
Lesson URL URL Link alla lezione nella vetrina
Quiz ID Testo L'ID del quiz di Alva
Quiz title Testo Il titolo del quiz
Result Testo passed, failed o expired
Passed Vero o falso Indica se lo studente ha superato il quiz
Score Numero Il punteggio in percentuale
Passing score Numero La percentuale necessaria per superarlo
Attempt number Numero Il numero del tentativo, a partire da 1
Manually reviewed Vero o falso Indica se hai valutato a mano qualche risposta
Answers Testo Una riga per domanda: la domanda, la risposta dello studente e se era corretta

Si attiva quando un tentativo viene superato o non superato. Un tentativo a tempo che scade si attiva con Result impostato su expired non appena Alva Courses se ne accorge: quando lo studente invia le risposte, riavvia il quiz o le sue risposte vengono salvate. I quiz con risposte che correggi a mano si attivano dopo che li hai revisionati, e cambiare un esito da superato a non superato, o viceversa, lo attiva di nuovo con il nuovo risultato.

Answers contiene una riga per domanda con la risposta dello studente e se era corretta. Nei quiz molto lunghi può essere accorciato, così il trigger resta entro il limite di dimensione di Shopify Flow.

Trigger di commenti, elaborati e certificati

Questi trigger riguardano le conversazioni e il lavoro valutato: uno studente commenta, tu rispondi, uno studente consegna un elaborato, tu lo valuti e viene inviato un certificato. Usali per pubblicare i commenti su Slack, inviare via email le tue risposte agli studenti o tenere un registro dei voti.

Course contact form submitted

Uno studente ha inviato un messaggio tramite un modulo di contatto in una lezione di un corso Alva.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha inviato il messaggio, con tutti i campi cliente Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Lesson ID Testo L'ID della lezione di Alva
Lesson title Testo Il titolo della lezione
Lesson URL URL Link alla lezione nella vetrina
Message ID Testo L’ID Alva del messaggio
Message subject Testo L’oggetto inserito dallo studente. Vuoto se non è stato fornito un oggetto
Message text Testo Il messaggio dello studente, limitato a 2.000 caratteri
Identity verified Vero o falso Indica se l’identità dello studente era verificata al momento dell’invio del messaggio

Si attiva una volta quando viene salvato un nuovo messaggio di contatto, indipendentemente dall’esito dell’email di notifica. Un nuovo tentativo di invio dello stesso messaggio o il reinvio di una notifica non crea un altro evento. Usalo per creare un ticket di assistenza, avvisare il team o registrare un messaggio in Google Sheets.

Titoli e testo provengono dal messaggio salvato. I link sono vuoti se il corso o la lezione non esiste più. Il messaggio completo rimane in Alva Courses → Messaggi; solo i primi 2.000 caratteri vengono inviati a Flow. Questi campi contengono corrispondenza privata degli studenti: scegli di conseguenza le destinazioni del flusso di lavoro.

Course lesson comment posted

Uno studente ha pubblicato un commento o una risposta in una lezione di un corso di Alva.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha pubblicato il commento, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Lesson ID Testo L'ID della lezione di Alva
Lesson title Testo Il titolo della lezione
Lesson URL URL Link alla lezione nella vetrina
Comment ID Testo L'ID del commento di Alva
Comment text Testo Il commento, troncato a 2.000 caratteri
Is reply Vero o falso Indica se il commento risponde a un altro commento

Si attiva per i commenti e le risposte scritti dagli studenti, indipendentemente dal fatto che Alva Courses ti invii email sui nuovi commenti. Le tue risposte attivano invece Course instructor reply posted.

Course instructor reply posted

Hai risposto al commento di uno studente in una lezione di un corso di Alva. Il cliente è lo studente a cui hai risposto.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente al cui commento è stata data risposta, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Lesson ID Testo L'ID della lezione di Alva
Lesson title Testo Il titolo della lezione
Lesson URL URL Link alla lezione nella vetrina
Reply text Testo La tua risposta, troncata a 2.000 caratteri
Comment ID Testo L'ID Alva della tua risposta

Si attiva quando rispondi a un commento scritto da uno studente. Il cliente è quello studente, quindi il flusso di lavoro può inviargli un'email. Alva Courses non invia di per sé email agli studenti sulle tue risposte: è proprio a questo che serve questo trigger.

Course coursework submitted

Uno studente ha consegnato il suo elaborato per la valutazione in un corso di Alva.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha consegnato, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Submission number Numero Il numero della consegna, a partire da 1

Si attiva ogni volta che uno studente consegna un elaborato per la valutazione, compresa una nuova consegna dopo che hai chiesto una revisione.

Course coursework evaluated

Hai valutato l'elaborato di uno studente in un corso di Alva, come superato o come richiesta di revisione.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente il cui elaborato è stato valutato, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Outcome Testo pass o revise
Grade Testo Il voto in lettere. Vuoto se non è stato assegnato
Final score Numero Il punteggio. 0 se non è stato assegnato
Feedback visible to student Vero o falso Indica se lo studente può vedere il tuo feedback
Submission number Numero Il numero della consegna, a partire da 1

Si attiva quando approvi l'elaborato o chiedi una revisione. Un'approvazione che completa il corso attiva anche Course completed. Il tuo feedback scritto non è incluso, perché può essere lungo e personale.

Course certificate issued

Il certificato di un corso di Alva è stato inviato via email a uno studente.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha ricevuto il certificato, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Issued at Testo Quando è stato inviato il certificato (ISO 8601)

Si attiva quando Alva Courses invia via email a uno studente il suo certificato, compreso quello inviato dall'azione Send course certificate. Inviare di nuovo un certificato dalla pagina del membro non lo attiva di nuovo, e un certificato che lo studente si limita a scaricare non attiva nulla. L'email del certificato all'inizio è disattivata, quindi questo trigger si attiva solo dopo che spunti Abilita email nella pagina Certificati (Impostazioni → Impostazioni email → Modifica modello certificato).

Trigger di accesso

Questi trigger segnalano che uno studente perde l'accesso o raggiunge la propria scadenza di accesso. Usali per terminare l'accesso alla scadenza, inviare offerte per riconquistare gli studenti o riordinare tag ed elenchi. I trigger di scadenza derivano da un controllo orario, quindi arrivano entro l'ora e non al minuto esatto.

A meno che il supporto di Alva non abbia attivato l'applicazione delle scadenze per il tuo negozio (per impostazione predefinita è disattivata), una scadenza non termina l'accesso da sola. Course access expiring soon e Course access expired si attivano in ogni caso alla data memorizzata per lo studente, ma con l'applicazione disattivata lo studente può ancora aprire il corso dopo che è stata superata. Per terminare l'accesso alla data, aggiungi Revoke course access a un flusso di lavoro su Course access expired; Ricorda agli studenti una scadenza del corso in arrivo mostra come.

Course access removed

Uno studente ha perso l'accesso a un corso di Alva: disiscritto, rimborsato, eliminato come membro o revocato da Flow. Non si attiva rimuovendo un tag di iscrizione.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente che ha perso l'accesso, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Reason Testo unenrolled, refunded, member deleted o revoked by flow

Reason è unenrolled quando rimuovi lo studente dal corso, refunded dopo un rimborso, member deleted quando elimini il membro (una volta per ogni corso a cui era iscritto) oppure revoked by flow. La rimozione di un tag di iscrizione, l'eliminazione di un corso, la disinstallazione di Alva Courses e la cancellazione dei dati dei clienti non lo attivano, e la scadenza dell'accesso attiva invece Course access expired.

Course access expiring soon

La scadenza di accesso di uno studente a un corso di Alva cade tra 14, 7, 3 o 1 giorni. Aggiungi una condizione su Days until expiry per scegliere quando agire.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente la cui scadenza di accesso è vicina, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Access expires at Testo Scadenza di accesso (ISO 8601), prima di qualsiasi periodo di tolleranza
Days until expiry Numero 14, 7, 3 o 1
Access enforced Vero o falso Indica se applichi le scadenze di accesso. Se è true, lo studente viene bloccato una volta superati la scadenza e l'eventuale periodo di tolleranza. Se è false, mantiene l'accesso

Si attiva al massimo una volta per ciascuna soglia di 14, 7, 3 e 1 giorni prima della scadenza dello studente, e solo per la più vicina tra quelle già raggiunte, quindi uno studente iscritto con 5 giorni rimanenti riceve 7, mai 14 e 7 insieme. Estendere il suo accesso fa ripartire il conto alla rovescia. Sono esclusi gli studenti revocati, l'accesso tramite tag di iscrizione e i corsi gratuiti. Access enforced indica se lo studente verrà bloccato una volta superati la scadenza e l'eventuale periodo di tolleranza, quindi una condizione su questo campo permette al promemoria di corrispondere a ciò che succederà davvero.

Course access expired

La scadenza di accesso di uno studente a un corso di Alva, più l'eventuale periodo di tolleranza, è stata superata. Access enforced indica se ora è bloccato.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente la cui scadenza di accesso è stata superata, con tutti i campi cliente di Shopify come email e tag
Course ID Testo L'ID del corso di Alva
Course title Testo Il titolo del corso
Course URL URL Link al corso nella vetrina (lo studente accede per aprirlo)
Access expired at Testo Scadenza di accesso superata (ISO 8601), senza l'eventuale periodo di tolleranza
Access enforced Vero o falso Indica se applichi le scadenze di accesso. Se è true, lo studente ora è bloccato. Se è false, mantiene l'accesso finché non viene revocato

Si attiva una volta trascorsa la data di scadenza più l'eventuale periodo di tolleranza, indipendentemente dal fatto che Alva Courses blocchi o meno gli studenti con accesso scaduto; Access enforced ti dice quale dei due casi. Quando è false, lo studente può ancora aprire il corso finché un flusso di lavoro non esegue Revoke course access o finché non lo rimuovi. Ignora le scadenze passate da più di 48 ore al momento del controllo, quindi attivare un flusso di lavoro non ripropone mai vecchie scadenze. Access expired at è la data di scadenza vera e propria, senza il periodo di tolleranza.

Vedi anche

È stato utile?

Ancora bloccato? Scrivici.

Ultimo aggiornamento 2026-10-13