Vai al contenuto principale
— Riferimento

Azioni di Shopify Flow

Alva Courses aggiunge 7 azioni a Shopify Flow, così un flusso di lavoro può iscrivere un cliente, modificarne o rimuoverne l'accesso, inviargli le email, reimpostarne i progressi o consultarli. Questo riferimento descrive i campi di ogni azione, cosa fa e i messaggi che Flow mostra quando un passaggio viene eseguito.

Come si comportano le azioni di Alva

Ogni azione di Alva Courses cerca il corso solo nel tuo negozio, tramite ID Flow o handle URL, compreso un handle che il corso aveva prima che ne modificassi l'URL. Quando un passaggio non può svolgere il suo compito, non riesce e mostra un messaggio che spiega il motivo e cosa cambiare, e Flow non lo riprova. Quando Alva Courses ha un problema temporaneo, Flow riprova il passaggio automaticamente per un massimo di 36 ore.

Un passaggio che non trova nulla da fare riesce e lo segnala, ad esempio quando iscrive qualcuno che è già iscritto. Se Flow consegna due volte la stessa esecuzione, Alva Courses la riconosce e non ripete il lavoro. L'unica eccezione è rara: se Alva non è riuscita a registrare un'esecuzione terminata e Flow non ha mai ricevuto la risposta, Extend access by this many days o Resend course access email possono essere applicate due volte.

Messaggi che possono comparire in più di un'azione:

  • No course with ID or handle '…' in this store. Il campo Course non corrisponde a nessun corso di questo negozio. Copia di nuovo l'ID o l'handle da Impostazioni → Integrazioni → Shopify Flow.
  • Enter a course ID or URL handle in the Course field. Find them in Alva Courses → Settings → Integrations → Shopify Flow. Il campo Course è vuoto, oppure una variabile al suo interno è risultata vuota.
  • This action needs a customer. Use it after a trigger or step that provides one. In questo punto il flusso di lavoro non ha un cliente.
  • This customer isn't enrolled in "…". Use Enroll customer in course first. L'azione richiede un'iscrizione esistente.
  • Alva Courses hit a temporary error. Shopify Flow will retry this action automatically. Non devi fare nulla: Flow riprova.
  • Too many Alva Courses actions are running for this store at once. Shopify Flow will retry. Un flusso di lavoro ha avviato molte esecuzioni insieme; Flow le distribuisce nel tempo.
  • Already processed Flow ha inviato un'esecuzione già terminata, quindi nulla è stato fatto due volte.

Azioni di iscrizione e accesso

Queste azioni concedono, tolgono e regolano l'accesso ai corsi. Abbinale ai trigger di Shopify, come l'aggiunta di un tag cliente o il pagamento di un ordine, per gestire abbonamenti, gruppi di studenti e promozioni senza intervenire a mano su ogni studente.

Enroll customer in course

Concede a un cliente l'accesso a un corso di Alva.

Campo Tipo Obbligatorio Note
Cliente Cliente Shopify Obbligatorio Compilato da Flow a partire dal trigger o da un passaggio precedente che fornisce un cliente.
Course ID or URL handle Testo Obbligatorio Lo trovi in Alva Courses → Impostazioni → Integrazioni → Shopify Flow.
Access length in days Numero intero Facoltativo Lascialo vuoto per usare l'impostazione di accesso del corso.
Send the course access email Casella di controllo Facoltativo —

Iscrive il cliente al corso, aggiungendolo come membro in Alva Courses se è nuovo; deve già essere un cliente del tuo negozio Shopify. Lascia vuoto Access length in days per usare l'impostazione di accesso del corso, oppure inserisci da 1 a 36.500 giorni. I corsi gratuiti hanno sempre accesso illimitato. La nuova iscrizione attiva Course enrollment created con Enrollment source impostato su flow.

Spunta Send the course access email per inviare allo studente il suo link via email. Se l'email non può essere inviata, l'iscrizione resta valida e il messaggio del passaggio indica che l'email non è stata inviata. Uno studente a cui è stato revocato l'accesso non viene mai iscritto di nuovo da un'automazione.

  • Enrolled in "…". Fatto. Il messaggio indica anche se l'email di accesso al corso è stata inviata.
  • Already enrolled in "…". Non è cambiato nulla. Se il suo accesso è scaduto, il messaggio lo segnala; usa Extend or set course access per estenderlo.
  • This customer's access to "…" was revoked by a Flow action. Restore it from the customer's member page in Alva Courses. Vedi ripristinare l'accesso revocato da un flusso di lavoro.
  • This customer's access to "…" was revoked after a refund; automation won't restore it. Un corso rimborsato torna disponibile con un nuovo acquisto.
  • No Shopify customer with ID … in this store. Il cliente è stato eliminato, oppure l'ID proviene da un altro negozio.
  • Access length in days must be between 1 and 36,500 days. Lascia il campo vuoto per usare l'impostazione del corso.

Revoke course access

Rimuove l'accesso di un cliente a un corso di Alva. I suoi progressi, i tentativi di quiz e gli elaborati vengono conservati.

Campo Tipo Obbligatorio Note
Cliente Cliente Shopify Obbligatorio Compilato da Flow a partire dal trigger o da un passaggio precedente che fornisce un cliente.
Course ID or URL handle Testo Obbligatorio Lo trovi in Alva Courses → Impostazioni → Integrazioni → Shopify Flow.

Rimuove l'accesso del cliente senza eliminare nulla: le lezioni completate, i tentativi di quiz e gli elaborati vengono conservati. Alva Courses rimuove anche i tag di progresso del corso dal cliente, se li usi, e attiva Course access removed con Reason impostato su revoked by flow. Per restituire l'accesso, usa Ripristina accesso nella pagina dello studente in Membri; vedi ripristinare l'accesso revocato da un flusso di lavoro.

  • Access to "…" revoked. Progress and coursework are kept; restore access from the customer's member page in Alva Courses. Fatto.
  • This customer isn't enrolled in "…"; nothing to revoke. Il passaggio riesce senza modificare nulla.
  • Access to "…" was already revoked. Il passaggio riesce senza modificare nulla.

Extend or set course access

Modifica la data di scadenza dell'accesso di un cliente a un corso di Alva. Compila esattamente una delle tre opzioni.

Campo Tipo Obbligatorio Note
Cliente Cliente Shopify Obbligatorio Compilato da Flow a partire dal trigger o da un passaggio precedente che fornisce un cliente.
Course ID or URL handle Testo Obbligatorio Lo trovi in Alva Courses → Impostazioni → Integrazioni → Shopify Flow.
Extend access by this many days Numero intero Facoltativo Si aggiunge alla data di scadenza attuale, oppure a oggi se l'accesso è già scaduto.
Set the expiry date Testo Facoltativo AAAA-MM-GG, nel fuso orario del tuo negozio. L'accesso termina alla fine di quel giorno.
Give unlimited access Casella di controllo Facoltativo —

Modifica quando termina l'accesso del cliente. Compila esattamente un'opzione. Extend access by this many days aggiunge da 1 a 36.500 giorni alla data di scadenza attuale, oppure a oggi se l'accesso è già scaduto. Set the expiry date fa terminare l'accesso alla fine di quel giorno nel fuso orario del tuo negozio. Give unlimited access rimuove la data di fine.

Non restituisce mai un accesso revocato. Rifiuta inoltre una data di scadenza che Alva Courses non applicherebbe: sui corsi gratuiti e sull'accesso che deriva da un tag di iscrizione. Estendere un accesso illimitato lo lascia illimitato.

  • Access to "…" now ends at …. Fatto. La nuova data di fine è indicata in UTC.
  • Fill in exactly one option: Extend access by this many days, Set the expiry date, or Give unlimited access. Non ne è stata compilata nessuna, oppure più di una.
  • Set the expiry date as YYYY-MM-DD, such as 2026-12-31 (got '…'). Digita la data esattamente in quel formato, oppure assicurati che la variabile che hai usato la produca così.
  • Changing the expiry date wouldn't restore access, so nothing was changed. L'accesso dello studente è stato revocato; il messaggio inizia con il motivo.
  • This customer's access to "…" comes from a membership tag, which never expires. Remove the tag to end access instead.
  • "…" is a free course, and free courses have no access limit, so there's no expiry date to set. Nothing was changed.
  • Access to "…" is already unlimited; nothing to extend. Il passaggio riesce senza modificare nulla.

Azioni sui progressi

Queste azioni leggono o cancellano i progressi di uno studente. Get course progress è la base per promemoria e report; Reset course progress serve per ripetere un corso o rinnovare una certificazione, e non può essere annullata.

Reset course progress

Reimposta i progressi di un cliente in un corso di Alva. Elimina in modo permanente le lezioni completate, i tentativi di quiz e le valutazioni degli elaborati.

Campo Tipo Obbligatorio Note
Cliente Cliente Shopify Obbligatorio Compilato da Flow a partire dal trigger o da un passaggio precedente che fornisce un cliente.
Course ID or URL handle Testo Obbligatorio Lo trovi in Alva Courses → Impostazioni → Integrazioni → Shopify Flow.
I understand this permanently deletes progress Casella di controllo Obbligatorio Deve essere spuntata, altrimenti l'azione non fa nulla e segnala un errore.

Lo studente ricomincia il corso dall'inizio. Il suo accesso, l'acquisto, l'iscrizione, le note di riflessione e i commenti vengono conservati. Il passaggio non fa nulla se I understand this permanently deletes progress non è spuntata. Ogni reimpostazione compare nella scheda Reimpostazioni dei progressi della pagina membro dello studente, come eseguita dallo staff del negozio.

Poiché la reimpostazione cancella il completamento, terminare di nuovo il corso attiva di nuovo Course completed e invia un nuovo certificato, se il corso ne rilascia uno. Ogni lezione completata di nuovo attiva Course lesson completed con Repeat completion impostato su true.

  • Progress in "…" reset. Completed lessons, quiz attempts and evaluations were deleted; access is unchanged. Fatto.
  • Tick “I understand this permanently deletes progress” in this step to reset progress. Nothing was changed.

Get course progress

Consulta i progressi di un cliente in un corso di Alva, da usare nei passaggi successivi.

Campo Tipo Obbligatorio Note
Cliente Cliente Shopify Obbligatorio Compilato da Flow a partire dal trigger o da un passaggio precedente che fornisce un cliente.
Course ID or URL handle Testo Obbligatorio Lo trovi in Alva Courses → Impostazioni → Integrazioni → Shopify Flow.

Restituisce questi valori, che i passaggi successivi dello stesso flusso di lavoro possono usare:

Valore Tipo Significato
enrolled Vero o falso Indica se il cliente è iscritto e non revocato
percentComplete Numero Percentuale di lezioni pubblicate completate
completed Vero o falso Indica se il corso è completato
lessonsCompleted Numero intero Lezioni completate
accessExpiresAt Testo Scadenza dell'accesso, ISO 8601, vuoto se illimitato

Consulta i progressi del cliente senza modificare nulla, così una condizione successiva può diramarsi in base a essi: ad esempio, attendi 7 giorni dopo l'iscrizione, poi invia un'email agli studenti il cui percentComplete è inferiore a 10. Vedi sollecitare gli studenti che non hanno iniziato un corso.

Un cliente non iscritto restituisce enrolled false e valori pari a zero, e lo stesso vale per un cliente che Alva Courses non conosce ancora. Uno studente a cui è stato revocato l'accesso restituisce enrolled false con i progressi che aveva. percentComplete e lessonsCompleted contano solo le lezioni pubblicate nel corso, non le bozze.

  • Enrolled; 40% of "…" complete. Fatto; i valori sono pronti per i passaggi successivi.
  • Access revoked; 40% of "…" complete. Fatto; enrolled è false.
  • Not enrolled in "…". Fatto; enrolled è false e i numeri sono 0.

Vedi anche

È stato utile?

Ancora bloccato? Scrivici.

Ultimo aggiornamento 2026-10-01