Vai al contenuto principale
— Riferimento

Trigger di Shopify Flow e relativi campi

Alva Courses invia 12 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 Quando scade l'accesso (ISO 8601). Vuoto significa illimitato

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 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.

Trigger di accesso

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

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

L'accesso di uno studente a un corso di Alva scade 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 il cui accesso sta per scadere, 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 Quando scade l'accesso (ISO 8601)
Days until expiry Numero 14, 7, 3 o 1

Si attiva al massimo una volta per ciascuna soglia di 14, 7, 3 e 1 giorni prima della fine dell'accesso, 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.

Course access expired

L'accesso di uno studente a un corso di Alva ha raggiunto la data di scadenza, più il tuo periodo di tolleranza.

Campo Tipo Contenuto
Cliente Cliente Shopify Lo studente il cui accesso è scaduto, 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 Quando è scaduto l'accesso (ISO 8601)
Access enforced Vero o falso Indica se Alva blocca gli studenti con accesso scaduto. Se disattivato, lo studente può ancora aprire il corso

Si attiva una volta trascorsa la data di scadenza più l'eventuale periodo di tolleranza, indipendentemente dal fatto che tu blocchi o meno gli studenti con accesso scaduto; Access enforced ti dice quale dei due casi. 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-01