Documentatie · 🧭 Journeys

Hoe een journey verloopt

Wie er handelt, wat de assistent mag zien en wat er gebeurt als een stap niet kan worden uitgevoerd.

Vraagt een bezoeker om iets waar een journey voor bestaat, dan start de assistent die en doet hij daarna een stap terug. Vanaf dat moment worden de stappen uitgevoerd door een engine die op je eigen pagina draait, zonder model ertussen. De assistent vertelt; hij stuurt niet.

Wat de assistent krijgt#

De assistent krijgt twee dingen over een journey: de naam en de triggerzin. De stappen, en de elementen waar die stappen naar wijzen, worden nooit naar hem gestuurd — niet ervoor, niet tijdens, niet erna.

Regel: Daarom is *"hij zet nooit een stap die niemand heeft vastgelegd"* een feit en geen voornemen. Een elementnaam die het model bereikt, is een elementnaam waar het model een variant op kan maken. Hij bereikt het model nooit, dus er is geen variant om te maken.

Wat de bezoeker ziet#

  • Een kleine kaart in de chat die laat zien welke stap er loopt, en van hoeveel.
  • Bij een guide-stap een instructie om die stap zelf te doen, met het juiste element op de pagina aangewezen.
  • Bij een hold-stap een knop Continue (Doorgaan) — er beweegt niets totdat ze erop drukken.
  • Een manier om het geheel bij elke stap te stoppen, zonder de chat te verlaten.

Als een stap niet kan worden uitgevoerd#

Voor elke handeling controleert de engine het element dat hij gaat aanraken: staat het echt op de pagina, is het zichtbaar, is het interactief, en verwijst het terug naar hetzelfde element waarover hij is geïnformeerd. Faalt een van die controles, dan wordt de stap overgeslagen — niet geprobeerd. Een stap waar de engine niet zeker van is, voert hij niet uit.

Wordt dezelfde stap drie keer achter elkaar overgeslagen, dan stopt de journey en zegt hij waarom. De assistent pakt het gesprek daarna gewoon weer op. Een pagina die onder een journey is veranderd, beëindigt die netjes; de bezoeker hoeft niet te kijken naar iets wat zichzelf steeds opnieuw probeert.

Hoe het afloopt#

De assistent hoort het resultaat één keer per journey, niet per stap, en pas als het voorbij is — voltooid of gestopt. Totdat dat bericht binnenkomt, beweert hij niet dat iets klaar is, want hij weet het echt niet.

Waar het draait#

Het chatpaneel zit in een apart frame op ons domein; de engine draait op jouw pagina. Slechts vier dingen gaan over die grens: het plan dat moet draaien, *doorgaan*, *stoppen* en welke stap waar is. Wie de bezoeker is, zijn sessie en de tekst van het gesprek blijven aan onze kant en komen nooit op jouw pagina.

Tip: Bij een project zonder journeys wordt de engine niet eens gedownload — geen extra verzoek, niets toegevoegd aan je pagina.

De journey start nooit.
Ofwel de functie is niet actief voor het project — kijk op de pagina Journeys of er een vereiste is vervallen — ofwel lijkt de triggerzin niet op wat de bezoeker typte. Triggers worden vergeleken met echte zinnen, niet met menulabels.
Hij stopt halverwege.
Een stap kon drie keer niet vinden waarop hij moest klikken. Meestal betekent dat dat de pagina is veranderd: een element heeft een andere naam gekregen, is verplaatst of verschijnt nu pas na iets anders. Open de journey, repareer die stap en publiceer opnieuw.
Hij wacht en er gebeurt niets.
Hij staat bij een hold- of guide-stap, en dat is precies waar hij hoort te wachten op de bezoeker. Die stappen eindigen als de bezoeker iets doet of op Continue drukt — nooit vanzelf.