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 the deadline 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.
Days until the access deadline 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 Days until the access deadline 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 seine Zugriffsfrist verstrichen, sagt die Meldung das; verwenden Sie Extend or set course access, um sie 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.
  • Days until the access deadline 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 oder entfernt die Zugriffsfrist eines Kunden für einen Alva-Kurs. 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 the deadline by this many days Ganze Zahl Optional Wird zur aktuellen Frist addiert, oder zu heute, wenn die Frist bereits verstrichen ist.
Set the access deadline Text Optional JJJJ-MM-TT (YYYY-MM-DD), in der Zeitzone Ihres Shops. Die Frist läuft bis zum Ende dieses Tages.
Give unlimited access Kontrollkästchen Optional —

Ändert die Zugriffsfrist des Kunden: das Datum, das Alva Courses erfasst, auf seiner Mitgliederseite anzeigt und auf das Course access expiring soon herunterzählt. Füllen Sie genau eine Option aus. Extend the deadline by this many days addiert 1 bis 36.500 Tage zur aktuellen Frist, oder zu heute, wenn sie bereits verstrichen ist. Set the access deadline verschiebt die Frist auf das Ende dieses Tages in der Zeitzone Ihres Shops. Give unlimited access entfernt die Frist.

Sie gibt entzogenen Zugang nie zurück. Außerdem lehnt sie eine Frist bei kostenlosen Kursen und bei Zugang über ein Mitgliedschafts-Tag ab, die nie eine haben. Das Verlängern eines unbegrenzten Zugangs lässt ihn unbegrenzt.

Sofern der Alva-Support die Fristdurchsetzung für Ihren Shop nicht aktiviert hat (standardmäßig ist sie aus), beendet eine Frist allein den Zugang nicht: Nachdem sie verstrichen ist, kann der Teilnehmer den Kurs weiterhin öffnen. Um den Zugang zum Datum zu beenden, fügen Sie Revoke course access zu einem Workflow mit Course access expired hinzu; siehe Teilnehmer vor einer Kursfrist erinnern.

  • The access deadline for "…" is now …. Erledigt. Die neue Frist wird in UTC angezeigt.
  • Fill in exactly one option: Extend the deadline by this many days, Set the access deadline, or Give unlimited access. Keine oder mehr als eine Option wurde ausgefüllt.
  • Set the access deadline 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 access deadline 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 has no access deadline. Remove the tag to end access instead.
  • "…" is a free course, and free courses have no access limit, so there's no access deadline 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 Die Zugriffsfrist (ISO 8601), vor einer etwaigen Nachfrist. Leer bedeutet keine Frist

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