Een journey schrijven
Stappen, triggers en hoe de assistent weet dat een stap klaar is.
Een journey heeft een naam (hoe de assistent hem hardop noemt), een triggerzin en zijn stappen op volgorde. Je schrijft hem op de pagina Journeys; een coding agent die via MCP gekoppeld is, kan er ook een opzet voor maken — een concept draait nooit totdat je het publiceert.
De triggerzin#
De trigger wordt vergeleken met wat de bezoeker typte, dus schrijf een zin, geen menulabel: *"als de bezoeker iets wat hij heeft gekocht wil retourneren of terugsturen"*. Een losse term als "Retouren" past bij bijna niets.
Hoe een stap eindigt#
Elke stap zegt hoe we weten dat hij klaar is. Dit is een vaste lijst — er is geen voorwaarde in vrije tekst, want een voorwaarde die de engine niet kan controleren, is een voorwaarde die ongemerkt nooit afgaat.
| Eindigt als | Wat er nodig is |
|---|---|
click_self | Er is op het eigen doelelement van de stap geklikt. |
visible / hidden | Een doelelement verschijnt of verdwijnt. |
filled | Een doelveld heeft een waarde. |
url_change | Het adres verandert in iets wat je opgeeft. |
settled | Een doelelement verandert niet meer. |
attempts | Een aantal pogingen. |
user_continue | De bezoeker drukt op Continue. Verplicht voor hold-stappen. |
Regel: Een stap die een pagina opent, moet eindigen op iets wat de pagina kan tonen. Een pagina openen breekt het script af en bouwt het op de nieuwe pagina opnieuw op, dus een gebeurtenis die nog zou komen — een klik — kan nooit aankomen: de stap zou de pagina bij elke keer laden opnieuw openen. De editor biedt daarom voor een stap "pagina openen" alleen url_change, visible en filled aan, en de server weigert een plan dat iets anders zegt. De engine stopt een stap ook na twee navigaties, zodat een verkeerd plan je site nooit eindeloos kan laten herladen.
Nog één ding doet de engine voor je: hij wacht tot het doelelement van een stap verschijnt (een paar seconden, voortdurend controlerend) voordat hij besluit dat het ontbreekt. Een pagina die haar formulier pas een moment na het laden toont, is normaal, en dat hoort een journey niet te stoppen.
Publiceren#
Wat je publiceert, is een specifieke versie. Bewerk je een gepubliceerde journey, dan gaat hij weer offline, zodat een plan dat niemand heeft goedgekeurd nooit op je site kan draaien. Lees de stappen door en publiceer opnieuw.
Tip: Het meeste werk in een journey is de juiste elementen op je pagina benoemen. Het doel van een stap moet bij precies één element passen — #country-select of select[aria-label="Passport"] zijn allebei prima als maar één ding op de pagina ermee overeenkomt, terwijl een kale button wordt geweigerd: een verwijzing die veertig dingen kan betekenen, wijst niets aan. Heb je een coding agent gekoppeld (zie Coding agents), dan kan die je pagina's lezen en de stappen opzetten — jij controleert en publiceert.