Aller au contenu principal
— Référence

Déclencheurs Shopify Flow et leurs champs

Alva Courses envoie 12 déclencheurs à Shopify Flow. Cette référence indique quand chacun se déclenche et tous les champs qu'il transmet, pour que vous puissiez créer des conditions et renseigner les étapes d'action avec les bonnes données.

Utiliser les champs des déclencheurs

Chaque déclencheur Alva Courses commence par l'apprenant en tant que client Shopify, suivi de Course ID, Course title et Course URL. Les déclencheurs de leçon ajoutent Lesson ID, Lesson title et Lesson URL. Chaque champ est toujours envoyé : un texte sans objet est vide, et un nombre sans objet vaut 0.

Dans une Condition, choisissez le champ parmi les données du déclencheur. Dans le texte d'une action, insérez-le avec Ajouter une variable. Flow y écrit chaque nom de champ en camelCase : Course title devient donc {{ courseTitle }}. Utilisez le sélecteur plutôt que de taper les noms, pour que les champs dont le nom contient ID ou URL soient écrits exactement comme il faut.

Les liens de cours et de leçon ouvrent votre boutique en ligne, où l'apprenant se connecte pour voir le cours. Les dates et heures sont du texte au format ISO 8601 et en UTC, par exemple 2026-10-01T09:30:00.000Z.

Déclencheurs d'inscription et de progression

Ces déclencheurs suivent un apprenant tout au long d'un cours, de l'inscription à l'achèvement. Utilisez-les pour ajouter un tag aux apprenants ou les remercier, synchroniser leur progression avec un outil d'e-mailing, ou vous alerter quand un quiz se passe mal. Chacun se déclenche une fois par changement réel, jamais pour une requête répétée.

Course enrollment created

Un client a été inscrit à un cours Alva par un achat, par vous, ou par un import CSV, un tag d'adhésion, une inscription libre gratuite ou une action Flow.

Champ Type Contenu
Client Client Shopify L'apprenant inscrit, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Enrollment source Texte Comment l'apprenant a été inscrit : purchase, manual, import, membership tag, free ou flow
Order name Texte La commande qui a donné l'accès, par exemple #1001. Vide sauf en cas d'achat
Access expires at Texte Date d'expiration de l'accès (ISO 8601). Vide signifie illimité

Se déclenche une seule fois, à la création de l'inscription. Prolonger, renouveler ou rétablir l'accès ne le déclenche pas de nouveau ; retirer un apprenant puis le réinscrire le déclenche, car il s'agit d'une nouvelle inscription. Une inscription effectuée par l'action Enroll customer in course a Enrollment source défini sur flow.

Course lesson completed

Un apprenant a terminé une leçon d'un cours Alva. Se déclenche à nouveau s'il la termine encore après la réinitialisation de sa progression ; voir Repeat completion.

Champ Type Contenu
Client Client Shopify L'apprenant qui a terminé la leçon, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Lesson ID Texte L'ID de la leçon Alva
Lesson title Texte Le titre de la leçon
Lesson URL URL Lien vers la leçon sur la boutique en ligne
Lessons completed Nombre Nombre de leçons que l'apprenant a terminées dans ce cours
Total lessons Nombre Nombre de leçons du cours
Percent complete Nombre Progression dans le cours, de 0 à 100
Repeat completion Vrai ou faux Indique si l'apprenant avait déjà terminé cette leçon et si sa progression a été réinitialisée depuis. Ajoutez une condition sur ce champ pour ne récompenser chaque leçon qu'une seule fois

Se déclenche la première fois qu'un apprenant termine une leçon. La terminer de nouveau n'envoie rien, sauf si sa progression a été réinitialisée entre-temps : il se déclenche alors de nouveau avec Repeat completion défini sur true. Pour ne récompenser chaque leçon qu'une fois, ajoutez une condition indiquant que Repeat completion vaut false.

Course completed

Un apprenant a terminé un cours Alva : toutes les leçons, les quiz obligatoires éventuels et une évaluation réussie lorsque le cours en exige une.

Champ Type Contenu
Client Client Shopify L'apprenant qui a terminé le cours, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Completed at Texte Date d'achèvement du cours (ISO 8601)
Grade Texte La note en lettres de l'évaluation. Vide lorsque le cours n'en a pas
Final score Nombre Le score de l'évaluation. 0 lorsque le cours n'en a pas
Evaluation required Vrai ou faux Indique si un formateur devait valider les travaux de l'apprenant

Se déclenche la première fois qu'un apprenant termine le cours. Pour un cours qui exige une évaluation, c'est le moment où vous validez ses travaux, et non celui où il termine la dernière leçon. Si vous réinitialisez sa progression, ou si l'action Reset course progress le fait, terminer de nouveau le cours le déclenche de nouveau ; ce n'est pas le cas lorsqu'un apprenant réinitialise lui-même sa progression.

Course quiz graded

La tentative de quiz d'un apprenant dans un cours Alva a été réussie, échouée ou a expiré. Les quiz nécessitant une relecture manuelle se déclenchent une fois que vous les avez relus.

Champ Type Contenu
Client Client Shopify L'apprenant qui a passé le quiz, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Lesson ID Texte L'ID de la leçon Alva
Lesson title Texte Le titre de la leçon
Lesson URL URL Lien vers la leçon sur la boutique en ligne
Quiz ID Texte L'ID du quiz Alva
Quiz title Texte Le titre du quiz
Result Texte passed, failed ou expired
Passed Vrai ou faux Indique si l'apprenant a réussi
Score Nombre Le score en pourcentage
Passing score Nombre Le pourcentage nécessaire pour réussir
Attempt number Nombre Le numéro de la tentative, à partir de 1
Manually reviewed Vrai ou faux Indique si vous avez corrigé des réponses à la main
Answers Texte Une ligne par question : la question, la réponse de l'apprenant et si elle était correcte

Se déclenche lorsqu'une tentative est réussie ou échouée. Une tentative chronométrée dont le temps est écoulé se déclenche avec Result à expired dès qu'Alva Courses le constate : quand l'apprenant soumet, recommence le quiz ou que ses réponses sont enregistrées. Les quiz dont vous corrigez les réponses à la main se déclenchent après votre relecture, et faire passer une note de réussie à échouée, ou l'inverse, le déclenche de nouveau avec le nouveau résultat.

Answers contient une ligne par question avec la réponse de l'apprenant et si elle était correcte. Sur les quiz très longs, il peut être raccourci pour que le déclencheur reste dans la limite de taille de Shopify Flow.

Déclencheurs de commentaires, de travaux et de certificats

Ces déclencheurs couvrent les échanges et les travaux évalués : un apprenant commente, vous répondez, un apprenant soumet ses travaux, vous les évaluez, et un certificat est envoyé. Utilisez-les pour publier les commentaires dans Slack, envoyer vos réponses par e-mail aux apprenants ou conserver une trace des notes.

Course lesson comment posted

Un apprenant a publié un commentaire ou une réponse sur une leçon d'un cours Alva.

Champ Type Contenu
Client Client Shopify L'apprenant qui a publié le commentaire, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Lesson ID Texte L'ID de la leçon Alva
Lesson title Texte Le titre de la leçon
Lesson URL URL Lien vers la leçon sur la boutique en ligne
Comment ID Texte L'ID du commentaire Alva
Comment text Texte Le commentaire, tronqué à 2 000 caractères
Is reply Vrai ou faux Indique si le commentaire répond à un autre commentaire

Se déclenche pour les commentaires et réponses rédigés par les apprenants, qu'Alva Courses vous envoie ou non un e-mail pour les nouveaux commentaires. Vos propres réponses déclenchent Course instructor reply posted à la place.

Course instructor reply posted

Vous avez répondu au commentaire de leçon d'un apprenant dans un cours Alva. Le client est l'apprenant à qui vous avez répondu.

Champ Type Contenu
Client Client Shopify L'apprenant dont le commentaire a reçu une réponse, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Lesson ID Texte L'ID de la leçon Alva
Lesson title Texte Le titre de la leçon
Lesson URL URL Lien vers la leçon sur la boutique en ligne
Reply text Texte Votre réponse, tronquée à 2 000 caractères
Comment ID Texte L'ID Alva de votre réponse

Se déclenche lorsque vous répondez à un commentaire rédigé par un apprenant. Le client est cet apprenant : le workflow peut donc lui envoyer un e-mail. Alva Courses n'envoie pas lui-même d'e-mail aux apprenants au sujet de vos réponses, et c'est précisément le rôle de ce déclencheur.

Course coursework submitted

Un apprenant a soumis ses travaux pour évaluation dans un cours Alva.

Champ Type Contenu
Client Client Shopify L'apprenant qui a soumis ses travaux, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Submission number Nombre Le numéro de cette soumission, à partir de 1

Se déclenche chaque fois qu'un apprenant soumet ses travaux pour évaluation, y compris une nouvelle soumission après que vous avez demandé une révision.

Course coursework evaluated

Vous avez évalué les travaux d'un apprenant dans un cours Alva, en les validant ou en demandant une révision.

Champ Type Contenu
Client Client Shopify L'apprenant dont les travaux ont été évalués, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Outcome Texte pass ou revise
Grade Texte La note en lettres. Vide si aucune n'a été attribuée
Final score Nombre Le score. 0 si aucun n'a été attribué
Feedback visible to student Vrai ou faux Indique si l'apprenant peut voir votre commentaire d'évaluation
Submission number Nombre Le numéro de cette soumission, à partir de 1

Se déclenche lorsque vous validez les travaux ou demandez une révision. Une validation qui termine le cours déclenche aussi Course completed. Votre commentaire écrit n'est pas inclus, car il peut être long et personnel.

Course certificate issued

Un certificat de cours Alva a été envoyé par e-mail à un apprenant.

Champ Type Contenu
Client Client Shopify L'apprenant qui a reçu le certificat, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Issued at Texte Date d'envoi du certificat (ISO 8601)

Se déclenche lorsqu'Alva Courses envoie par e-mail son certificat à un apprenant, y compris un certificat envoyé par l'action Send course certificate. Renvoyer un certificat depuis la page du membre ne le déclenche pas de nouveau, et un certificat que l'apprenant se contente de télécharger ne déclenche rien.

Déclencheurs d'accès

Ces déclencheurs signalent qu'un apprenant perd son accès, ou est sur le point de le perdre. Utilisez-les pour des rappels de renouvellement, des offres de reconquête, ou pour faire le ménage dans les tags et les listes. Les déclencheurs d'expiration proviennent d'une vérification horaire : ils arrivent donc dans l'heure plutôt qu'à la minute près.

Course access removed

Un apprenant a perdu l'accès à un cours Alva : désinscrit, remboursé, supprimé en tant que membre ou révoqué par Flow. Le retrait d'un tag d'adhésion ne déclenche pas cet événement.

Champ Type Contenu
Client Client Shopify L'apprenant qui a perdu l'accès, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Reason Texte unenrolled, refunded, member deleted ou revoked by flow

Reason vaut unenrolled lorsque vous retirez l'apprenant du cours, refunded après un remboursement, member deleted lorsque vous supprimez le membre (une fois pour chacun de ses cours), ou revoked by flow. Le retrait d'un tag d'adhésion, la suppression d'un cours, la désinstallation d'Alva Courses et l'effacement des données client ne le déclenchent pas, et l'expiration de l'accès déclenche Course access expired à la place.

Course access expiring soon

L'accès d'un apprenant à un cours Alva expire dans 14, 7, 3 ou 1 jours. Ajoutez une condition sur Days until expiry pour choisir quand agir.

Champ Type Contenu
Client Client Shopify L'apprenant dont l'accès arrive à expiration, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Access expires at Texte Date d'expiration de l'accès (ISO 8601)
Days until expiry Nombre 14, 7, 3 ou 1

Se déclenche au plus une fois pour chacune des échéances de 14, 7, 3 et 1 jours avant la fin de l'accès, et uniquement pour la plus proche déjà atteinte : un apprenant inscrit avec 5 jours restants reçoit 7, jamais 14 et 7 en même temps. Prolonger son accès relance le compte à rebours. Les apprenants révoqués, l'accès par tag d'adhésion et les cours gratuits sont exclus.

Course access expired

L'accès d'un apprenant à un cours Alva a atteint sa date d'expiration, augmentée de votre délai de grâce.

Champ Type Contenu
Client Client Shopify L'apprenant dont l'accès a expiré, avec tous les champs client Shopify comme l'e-mail et les tags
Course ID Texte L'ID du cours Alva
Course title Texte Le titre du cours
Course URL URL Lien vers le cours sur la boutique en ligne (l'apprenant se connecte pour l'ouvrir)
Access expired at Texte Date à laquelle l'accès a expiré (ISO 8601)
Access enforced Vrai ou faux Indique si Alva bloque les apprenants dont l'accès a expiré. Si ce n'est pas le cas, l'apprenant peut toujours ouvrir le cours

Se déclenche une fois la date d'expiration et l'éventuel délai de grâce dépassés, que vous bloquiez ou non les apprenants dont l'accès a expiré ; Access enforced vous indique lequel des deux. Il ignore les échéances passées plus de 48 heures avant la vérification : activer un workflow ne rejoue donc jamais d'anciennes expirations. Access expired at correspond à la date d'expiration elle-même, sans le délai de grâce.

Voir aussi

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez-nous.

Dernière mise à jour 2026-10-01