Naar hoofdinhoud
— Referentie

Shopify Flow-acties

Alva Courses voegt 7 acties toe aan Shopify Flow, zodat een workflow een klant kan inschrijven, zijn toegang kan wijzigen of verwijderen, zijn e-mails kan versturen, en zijn voortgang kan resetten of opzoeken. Deze referentie beschrijft de velden van elke actie, wat hij doet en de berichten die Flow toont wanneer een stap wordt uitgevoerd.

Hoe Alva-acties zich gedragen

Elke actie van Alva Courses zoekt de cursus alleen in je eigen winkel op, via de Flow-ID of URL-handle, inclusief een handle die de cursus had voordat je de URL wijzigde. Kan een stap zijn werk niet doen, dan mislukt hij met een bericht dat uitlegt waarom en wat je moet aanpassen, en Flow probeert hem niet opnieuw. Heeft Alva Courses een tijdelijk probleem, dan probeert Flow de stap tot 36 uur lang automatisch opnieuw.

Een stap die niets te doen vindt, slaagt en meldt dat, bijvoorbeeld wanneer je iemand inschrijft die al is ingeschreven. Levert Flow dezelfde run twee keer af, dan herkent Alva Courses dat en doet het het werk niet nog eens. Er is één zeldzame uitzondering: als Alva een afgeronde run niet kon vastleggen en Flow nooit het antwoord kreeg, kunnen Extend access by this many days of Resend course access email twee keer worden toegepast.

Berichten die meer dan één actie kan tonen:

  • No course with ID or handle '…' in this store. Het veld Course komt niet overeen met een cursus in deze winkel. Kopieer de ID of handle opnieuw via Instellingen → Integraties → Shopify Flow.
  • Enter a course ID or URL handle in the Course field. Find them in Alva Courses → Settings → Integrations → Shopify Flow. Het veld Course is leeg, of een variabele erin leverde een lege waarde op.
  • This action needs a customer. Use it after a trigger or step that provides one. De workflow heeft op dit punt geen klant.
  • This customer isn't enrolled in "…". Use Enroll customer in course first. De actie heeft een bestaande inschrijving nodig.
  • Alva Courses hit a temporary error. Shopify Flow will retry this action automatically. Je hoeft niets te doen: Flow probeert het opnieuw.
  • Too many Alva Courses actions are running for this store at once. Shopify Flow will retry. Een workflow heeft veel runs tegelijk gestart; Flow spreidt ze.
  • Already processed Flow stuurde een run die al was afgerond, dus er is niets dubbel gedaan.

Acties voor inschrijving en toegang

Deze acties geven, ontnemen en wijzigen cursustoegang. Combineer ze met Shopify-triggers, zoals een klanttag die wordt toegevoegd of een bestelling die wordt betaald, om lidmaatschappen, cohorten en promoties te draaien zonder elke student met de hand te bewerken.

Enroll customer in course

Geef een klant toegang tot een Alva-cursus.

Veld Type Verplicht Opmerkingen
Klant Shopify-klant Verplicht Door Flow ingevuld vanuit de trigger, of vanuit een eerdere stap die een klant levert.
Course ID or URL handle Tekst Verplicht Te vinden in Alva Courses → Instellingen → Integraties → Shopify Flow.
Access length in days Geheel getal Optioneel Laat leeg om de eigen toegangsinstelling van de cursus te gebruiken.
Send the course access email Selectievakje Optioneel —

Schrijft de klant in voor de cursus en voegt hem als lid toe in Alva Courses als hij nieuw is; hij moet al klant zijn in je Shopify-winkel. Laat Access length in days leeg om de eigen toegangsinstelling van de cursus te gebruiken, of vul 1 tot 36.500 dagen in. Gratis cursussen krijgen altijd onbeperkte toegang. De nieuwe inschrijving laat Course enrollment created afgaan met Enrollment source op flow.

Vink Send the course access email aan om de student zijn link te mailen. Kan de e-mail niet worden verstuurd, dan blijft de inschrijving staan en meldt het bericht van de stap dat de e-mail niet is verstuurd. Een student van wie de toegang is ingetrokken, wordt nooit door automatisering opnieuw ingeschreven.

  • Enrolled in "…". Klaar. Het bericht vermeldt ook of de toegangsmail voor de cursus is verstuurd.
  • Already enrolled in "…". Er is niets veranderd. Is de toegang verlopen, dan staat dat in het bericht; gebruik Extend or set course access om haar te verlengen.
  • This customer's access to "…" was revoked by a Flow action. Restore it from the customer's member page in Alva Courses. Zie toegang herstellen die een workflow heeft ingetrokken.
  • This customer's access to "…" was revoked after a refund; automation won't restore it. Een terugbetaalde cursus komt terug met een nieuwe aankoop.
  • No Shopify customer with ID … in this store. De klant is verwijderd, of de ID komt uit een andere winkel.
  • Access length in days must be between 1 and 36,500 days. Laat het veld leeg om de eigen instelling van de cursus te gebruiken.

Revoke course access

Trek de toegang van een klant tot een Alva-cursus in. Zijn voortgang, quizpogingen en cursuswerk blijven bewaard.

Veld Type Verplicht Opmerkingen
Klant Shopify-klant Verplicht Door Flow ingevuld vanuit de trigger, of vanuit een eerdere stap die een klant levert.
Course ID or URL handle Tekst Verplicht Te vinden in Alva Courses → Instellingen → Integraties → Shopify Flow.

Verwijdert de toegang van de klant zonder iets te wissen: afgeronde lessen, quizpogingen en cursuswerk blijven bewaard. Alva Courses haalt ook de voortgangstags van de cursus van de klant af als je die gebruikt, en laat Course access removed afgaan met Reason revoked by flow. Wil je de toegang teruggeven, gebruik dan Toegang herstellen op de pagina van de student onder Leden; zie toegang herstellen die een workflow heeft ingetrokken.

  • Access to "…" revoked. Progress and coursework are kept; restore access from the customer's member page in Alva Courses. Klaar.
  • This customer isn't enrolled in "…"; nothing to revoke. De stap slaagt zonder iets te veranderen.
  • Access to "…" was already revoked. De stap slaagt zonder iets te veranderen.

Extend or set course access

Wijzig wanneer de toegang van een klant tot een Alva-cursus verloopt. Vul precies één van de drie opties in.

Veld Type Verplicht Opmerkingen
Klant Shopify-klant Verplicht Door Flow ingevuld vanuit de trigger, of vanuit een eerdere stap die een klant levert.
Course ID or URL handle Tekst Verplicht Te vinden in Alva Courses → Instellingen → Integraties → Shopify Flow.
Extend access by this many days Geheel getal Optioneel Opgeteld bij de huidige vervaldatum, of bij vandaag als de toegang al is verlopen.
Set the expiry date Tekst Optioneel YYYY-MM-DD, in de tijdzone van je winkel. De toegang eindigt aan het einde van die dag.
Give unlimited access Selectievakje Optioneel —

Wijzigt wanneer de toegang van de klant eindigt. Vul precies één optie in. Extend access by this many days telt 1 tot 36.500 dagen op bij de huidige vervaldatum, of bij vandaag als de toegang al is verlopen. Set the expiry date beëindigt de toegang aan het einde van die dag in de tijdzone van je winkel. Give unlimited access verwijdert de einddatum.

Deze actie geeft ingetrokken toegang nooit terug. Ze weigert ook een vervaldatum die Alva Courses niet zou handhaven: bij gratis cursussen en bij toegang die uit een lidmaatschapstag komt. Onbeperkte toegang verlengen laat haar onbeperkt.

  • Access to "…" now ends at …. Klaar. Het nieuwe einde wordt in UTC getoond.
  • Fill in exactly one option: Extend access by this many days, Set the expiry date, or Give unlimited access. Er is geen of meer dan één optie ingevuld.
  • Set the expiry date as YYYY-MM-DD, such as 2026-12-31 (got '…'). Typ de datum precies in die notatie, of zorg dat de variabele die je gebruikt hem zo oplevert.
  • Changing the expiry date wouldn't restore access, so nothing was changed. De toegang van de student is ingetrokken; het bericht begint met de reden.
  • 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. De stap slaagt zonder iets te veranderen.

Voortgangsacties

Deze acties lezen of wissen de voortgang van een student. Get course progress is de bouwsteen voor aansporingen en rapportages; Reset course progress is voor herkansingen en hercertificering, en kan niet ongedaan worden gemaakt.

Reset course progress

Reset de voortgang van een klant in een Alva-cursus. Dit verwijdert definitief zijn afgeronde lessen, quizpogingen en beoordelingen van cursuswerk.

Veld Type Verplicht Opmerkingen
Klant Shopify-klant Verplicht Door Flow ingevuld vanuit de trigger, of vanuit een eerdere stap die een klant levert.
Course ID or URL handle Tekst Verplicht Te vinden in Alva Courses → Instellingen → Integraties → Shopify Flow.
I understand this permanently deletes progress Selectievakje Verplicht Moet aangevinkt zijn, anders doet de actie niets en meldt hij een fout.

De student begint de cursus opnieuw vanaf het begin. Zijn toegang, aankoop, inschrijving, reflectienotities en reacties blijven bewaard. De stap doet niets tenzij I understand this permanently deletes progress is aangevinkt. Elke reset verschijnt in de kaart Voortgangsresets op de ledenpagina van de student, als uitgevoerd door winkelpersoneel.

Omdat de reset de afronding wist, laat het opnieuw afronden van de cursus Course completed opnieuw afgaan en wordt er een nieuw certificaat verstuurd als de cursus er een uitreikt. Elke les die opnieuw wordt afgerond, laat Course lesson completed afgaan met Repeat completion op true.

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

Get course progress

Zoek de voortgang van een klant in een Alva-cursus op, om in latere stappen te gebruiken.

Veld Type Verplicht Opmerkingen
Klant Shopify-klant Verplicht Door Flow ingevuld vanuit de trigger, of vanuit een eerdere stap die een klant levert.
Course ID or URL handle Tekst Verplicht Te vinden in Alva Courses → Instellingen → Integraties → Shopify Flow.

De actie geeft deze waarden terug, die latere stappen in dezelfde workflow kunnen gebruiken:

Waarde Type Betekenis
enrolled Waar of onwaar Of de klant is ingeschreven en de toegang niet is ingetrokken
percentComplete Getal Percentage van de gepubliceerde lessen dat is afgerond
completed Waar of onwaar Of de cursus is afgerond
lessonsCompleted Geheel getal Afgeronde lessen
accessExpiresAt Tekst Vervaldatum van de toegang, ISO 8601, leeg bij onbeperkte toegang

Zoekt de voortgang van de klant op zonder iets te veranderen, zodat een latere voorwaarde erop kan vertakken: wacht bijvoorbeeld 7 dagen na de inschrijving en mail dan studenten van wie percentComplete onder de 10 ligt. Zie studenten aansporen die nog niet aan een cursus zijn begonnen.

Een klant die niet is ingeschreven, geeft enrolled false en nullen terug, en dat geldt ook voor een klant die Alva Courses nog niet kent. Een student van wie de toegang is ingetrokken, geeft enrolled false terug met de voortgang die hij had. percentComplete en lessonsCompleted tellen alleen lessen die in de cursus gepubliceerd zijn, geen concepten.

  • Enrolled; 40% of "…" complete. Klaar; de waarden staan klaar voor latere stappen.
  • Access revoked; 40% of "…" complete. Klaar; enrolled is false.
  • Not enrolled in "…". Klaar; enrolled is false en de getallen zijn 0.

Zie ook

Was dit nuttig?

Nog vastgelopen? Stuur ons een e-mail.

Laatst bijgewerkt 2026-10-01