Zum Hauptinhalt springen
— Referenz

Shopify-Flow-Aktionen

Alva Courses fügt Shopify Flow 7 Aktionen hinzu, sodass ein Workflow einen Kunden einschreiben, seinen Zugang ändern oder entziehen, ihm E-Mails senden, seinen Fortschritt zurücksetzen oder abfragen kann. Diese Referenz beschreibt die Felder jeder Aktion, was sie tut und welche Meldungen Flow anzeigt, wenn ein Schritt ausgeführt wird.

So verhalten sich Alva-Aktionen

Jede Aktion von Alva Courses sucht den Kurs nur in Ihrem eigenen Shop, per Flow-ID oder URL-Handle, auch über einen Handle, den der Kurs hatte, bevor Sie seine URL geändert haben. Kann ein Schritt seine Aufgabe nicht erledigen, schlägt er mit einer Meldung fehl, die sagt, warum und was zu ändern ist, und Flow wiederholt ihn nicht. Hat Alva Courses ein vorübergehendes Problem, wiederholt Flow den Schritt automatisch bis zu 36 Stunden lang.

Ein Schritt, der nichts zu tun findet, ist erfolgreich und meldet das, etwa beim Einschreiben eines bereits eingeschriebenen Kunden. Liefert Flow dieselbe Ausführung zweimal, erkennt Alva Courses das und wiederholt die Arbeit nicht. Die einzige Ausnahme ist selten: Konnte Alva eine abgeschlossene Ausführung nicht festhalten und hat Flow nie die Antwort erhalten, können Extend access by this many days oder Resend course access email doppelt wirken.

Meldungen, die mehr als eine Aktion anzeigen kann:

  • No course with ID or handle '…' in this store. Das Feld „Course“ passt zu keinem Kurs in diesem Shop. Kopieren Sie die ID oder den Handle erneut unter Einstellungen → Integrationen → Shopify Flow.
  • Enter a course ID or URL handle in the Course field. Find them in Alva Courses → Settings → Integrations → Shopify Flow. Das Feld „Course“ ist leer, oder eine Variable darin wurde leer ausgegeben.
  • This action needs a customer. Use it after a trigger or step that provides one. Der Workflow hat an dieser Stelle keinen Kunden.
  • This customer isn't enrolled in "…". Use Enroll customer in course first. Die Aktion setzt eine bestehende Einschreibung voraus.
  • Alva Courses hit a temporary error. Shopify Flow will retry this action automatically. Nichts zu tun: Flow versucht es erneut.
  • Too many Alva Courses actions are running for this store at once. Shopify Flow will retry. Ein Workflow hat viele Ausführungen gleichzeitig gestartet; Flow verteilt sie zeitlich.
  • Already processed Flow hat eine bereits abgeschlossene Ausführung gesendet, daher wurde nichts doppelt erledigt.

Aktionen für Einschreibung und Zugang

Diese Aktionen gewähren, entziehen und ändern den Kurszugang. Kombinieren Sie sie mit Shopify-Triggern, etwa wenn ein Kunden-Tag hinzugefügt oder eine Bestellung bezahlt wird, um Mitgliedschaften, Kohorten und Aktionen zu steuern, ohne jeden Teilnehmer von Hand bearbeiten zu müssen.

Enroll customer in course

Gibt einem Kunden Zugang zu einem Alva-Kurs.

Feld Typ Erforderlich Hinweise
Kunde Shopify-Kunde Erforderlich Wird von Flow aus dem Trigger übernommen oder aus einem früheren Schritt, der einen Kunden liefert.
Course ID or URL handle Text Erforderlich Zu finden in Alva Courses → Einstellungen → Integrationen → Shopify Flow.
Access length in days Ganze Zahl Optional Leer lassen, um die Zugangseinstellung des Kurses zu verwenden.
Send the course access email Kontrollkästchen Optional —

Schreibt den Kunden in den Kurs ein und legt ihn in Alva Courses als Mitglied an, falls er neu ist; er muss bereits Kunde in Ihrem Shopify-Shop sein. Lassen Sie Access length in days leer, um die Zugangseinstellung des Kurses zu verwenden, oder geben Sie 1 bis 36.500 Tage ein. Kostenlose Kurse erhalten immer unbegrenzten Zugang. Die neue Einschreibung löst Course enrollment created aus, mit Enrollment source auf flow.

Haken Sie Send the course access email an, um dem Teilnehmer seinen Link per E-Mail zu senden. Kann die E-Mail nicht gesendet werden, bleibt die Einschreibung trotzdem bestehen, und die Meldung des Schritts weist darauf hin, dass die E-Mail nicht gesendet wurde. Ein Teilnehmer, dem der Zugang entzogen wurde, wird durch eine Automatisierung nie wieder eingeschrieben.

  • Enrolled in "…". Erledigt. Die Meldung sagt außerdem, ob die E-Mail mit dem Kurszugang gesendet wurde.
  • Already enrolled in "…". Nichts geändert. Ist sein Zugang abgelaufen, sagt die Meldung das; verwenden Sie Extend or set course access, um ihn zu verlängern.
  • This customer's access to "…" was revoked by a Flow action. Restore it from the customer's member page in Alva Courses. Siehe von einem Workflow entzogenen Zugang wiederherstellen.
  • This customer's access to "…" was revoked after a refund; automation won't restore it. Ein erstatteter Kurs wird durch einen neuen Kauf wieder freigeschaltet.
  • No Shopify customer with ID … in this store. Der Kunde wurde gelöscht, oder die ID stammt aus einem anderen Shop.
  • Access length in days must be between 1 and 36,500 days. Lassen Sie das Feld leer, um die Einstellung des Kurses zu verwenden.

Revoke course access

Entzieht einem Kunden den Zugang zu einem Alva-Kurs. Fortschritt, Quizversuche und Kursarbeiten bleiben erhalten.

Feld Typ Erforderlich Hinweise
Kunde Shopify-Kunde Erforderlich Wird von Flow aus dem Trigger übernommen oder aus einem früheren Schritt, der einen Kunden liefert.
Course ID or URL handle Text Erforderlich Zu finden in Alva Courses → Einstellungen → Integrationen → Shopify Flow.

Entzieht dem Kunden den Zugang, ohne etwas zu löschen: Abgeschlossene Lektionen, Quizversuche und Kursarbeiten bleiben erhalten. Alva Courses entfernt außerdem die Fortschritts-Tags des Kurses vom Kunden, falls Sie diese verwenden, und löst Course access removed mit Reason revoked by flow aus. Um den Zugang zurückzugeben, verwenden Sie Zugang wiederherstellen auf der Seite des Teilnehmers unter Mitglieder; siehe von einem Workflow entzogenen Zugang wiederherstellen.

  • Access to "…" revoked. Progress and coursework are kept; restore access from the customer's member page in Alva Courses. Erledigt.
  • This customer isn't enrolled in "…"; nothing to revoke. Der Schritt ist erfolgreich, ohne etwas zu ändern.
  • Access to "…" was already revoked. Der Schritt ist erfolgreich, ohne etwas zu ändern.

Extend or set course access

Ändert, wann der Zugang eines Kunden zu einem Alva-Kurs abläuft. Füllen Sie genau eine der drei Optionen aus.

Feld Typ Erforderlich Hinweise
Kunde Shopify-Kunde Erforderlich Wird von Flow aus dem Trigger übernommen oder aus einem früheren Schritt, der einen Kunden liefert.
Course ID or URL handle Text Erforderlich Zu finden in Alva Courses → Einstellungen → Integrationen → Shopify Flow.
Extend access by this many days Ganze Zahl Optional Wird zum aktuellen Ablaufdatum addiert, oder zu heute, wenn der Zugang bereits abgelaufen ist.
Set the expiry date Text Optional JJJJ-MM-TT (YYYY-MM-DD), in der Zeitzone Ihres Shops. Der Zugang endet am Ende dieses Tages.
Give unlimited access Kontrollkästchen Optional —

Ändert, wann der Zugang des Kunden endet. Füllen Sie genau eine Option aus. Extend access by this many days addiert 1 bis 36.500 Tage zum aktuellen Ablaufdatum, oder zu heute, wenn der Zugang bereits abgelaufen ist. Set the expiry date beendet den Zugang am Ende dieses Tages in der Zeitzone Ihres Shops. Give unlimited access entfernt das Enddatum.

Sie gibt entzogenen Zugang nie zurück. Außerdem lehnt sie ein Ablaufdatum ab, das Alva Courses nicht durchsetzen würde: bei kostenlosen Kursen und bei Zugang über ein Mitgliedschafts-Tag. Das Verlängern eines unbegrenzten Zugangs lässt ihn unbegrenzt.

  • Access to "…" now ends at …. Erledigt. Das neue Ende wird in UTC angezeigt.
  • Fill in exactly one option: Extend access by this many days, Set the expiry date, or Give unlimited access. Keine oder mehr als eine Option wurde ausgefüllt.
  • Set the expiry date as YYYY-MM-DD, such as 2026-12-31 (got '…'). Geben Sie das Datum genau in diesem Format ein, oder stellen Sie sicher, dass die verwendete Variable es so ausgibt.
  • Changing the expiry date wouldn't restore access, so nothing was changed. Dem Teilnehmer wurde der Zugang entzogen; die Meldung beginnt mit dem Grund.
  • 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. Der Schritt ist erfolgreich, ohne etwas zu ändern.

Fortschritts-Aktionen

Diese Aktionen lesen oder löschen den Fortschritt eines Teilnehmers. Get course progress ist der Baustein für Erinnerungen und Berichte; Reset course progress ist für Wiederholungen und Rezertifizierungen gedacht und lässt sich nicht rückgängig machen.

Reset course progress

Setzt den Fortschritt eines Kunden in einem Alva-Kurs zurück. Dabei werden abgeschlossene Lektionen, Quizversuche und Bewertungen von Kursarbeiten dauerhaft gelöscht.

Feld Typ Erforderlich Hinweise
Kunde Shopify-Kunde Erforderlich Wird von Flow aus dem Trigger übernommen oder aus einem früheren Schritt, der einen Kunden liefert.
Course ID or URL handle Text Erforderlich Zu finden in Alva Courses → Einstellungen → Integrationen → Shopify Flow.
I understand this permanently deletes progress Kontrollkästchen Erforderlich Muss angehakt sein, sonst tut die Aktion nichts und meldet einen Fehler.

Der Teilnehmer beginnt den Kurs wieder von vorn. Zugang, Kauf, Einschreibung, Reflexionsnotizen und Kommentare bleiben erhalten. Der Schritt tut nichts, solange I understand this permanently deletes progress nicht angehakt ist. Jedes Zurücksetzen erscheint in der Karte Fortschritts-Zurücksetzungen auf der Mitgliederseite des Teilnehmers, als vom Shop-Personal vorgenommen.

Weil das Zurücksetzen den Abschluss löscht, löst ein erneuter Kursabschluss Course completed erneut aus und sendet ein neues Zertifikat, falls der Kurs eines vergibt. Jede erneut abgeschlossene Lektion löst Course lesson completed mit Repeat completion auf true aus.

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

Get course progress

Fragt den Fortschritt eines Kunden in einem Alva-Kurs ab, zur Verwendung in späteren Schritten.

Feld Typ Erforderlich Hinweise
Kunde Shopify-Kunde Erforderlich Wird von Flow aus dem Trigger übernommen oder aus einem früheren Schritt, der einen Kunden liefert.
Course ID or URL handle Text Erforderlich Zu finden in Alva Courses → Einstellungen → Integrationen → Shopify Flow.

Sie gibt diese Werte zurück, die spätere Schritte im selben Workflow verwenden können:

Wert Typ Bedeutung
enrolled Wahr oder falsch Ob der Kunde eingeschrieben ist und ihm der Zugang nicht entzogen wurde
percentComplete Zahl Prozentsatz der abgeschlossenen veröffentlichten Lektionen
completed Wahr oder falsch Ob der Kurs abgeschlossen ist
lessonsCompleted Ganze Zahl Abgeschlossene Lektionen
accessExpiresAt Text Ablauf des Zugangs, ISO 8601, leer bei unbegrenztem Zugang

Fragt den Fortschritt des Kunden ab, ohne etwas zu ändern, sodass eine spätere Bedingung danach verzweigen kann: zum Beispiel 7 Tage nach der Einschreibung warten und dann Teilnehmern eine E-Mail senden, deren percentComplete unter 10 liegt. Siehe Teilnehmer anstoßen, die einen Kurs noch nicht begonnen haben.

Ein nicht eingeschriebener Kunde liefert enrolled false und Nullen, ebenso ein Kunde, den Alva Courses noch nicht kennt. Ein Teilnehmer mit entzogenem Zugang liefert enrolled false mit dem Fortschritt, den er hatte. percentComplete und lessonsCompleted zählen nur Lektionen, die im Kurs veröffentlicht sind, keine Entwürfe.

  • Enrolled; 40% of "…" complete. Erledigt; die Werte stehen für spätere Schritte bereit.
  • Access revoked; 40% of "…" complete. Erledigt; enrolled ist false.
  • Not enrolled in "…". Erledigt; enrolled ist false und die Zahlen sind 0.

Siehe auch

War das hilfreich?

Noch nicht weiter? Schreiben Sie uns.

Zuletzt aktualisiert 2026-10-01