# Een journey schrijven

> Journeys · 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.

---

Lees deze pagina op het web: [Een journey schrijven](/nl/docs/journeys/writing-a-journey)
