Dokumentation · 🧭 Journeys

So läuft eine Journey ab

Wer handelt, was der Assistent sehen darf und was passiert, wenn ein Schritt nicht ausgeführt werden kann.

Bittet ein Besucher um etwas, das eine Journey abdeckt, startet der Assistent sie und tritt dann zurück. Ab diesem Moment werden die Schritte von einer Engine ausgeführt, die auf Ihrer eigenen Seite läuft – ohne Sprachmodell dazwischen. Der Assistent kommentiert; er steuert nicht.

Was der Assistent bekommt#

Der Assistent erhält zwei Dinge über eine Journey: ihren Namen und ihren Auslösesatz. Die Schritte und die Elemente, auf die sie zeigen, werden ihm nie geschickt – weder vorher noch währenddessen noch danach.

Regel: Deshalb ist *„Er führt nie einen Schritt aus, den niemand aufgeschrieben hat“* eine Tatsache und keine bloße Absicht. Ein Elementname, der das Modell erreicht, ist ein Elementname, von dem das Modell eine Variante erzeugen könnte. Er erreicht das Modell nie – also gibt es keine Variante, die es erzeugen könnte.

Was der Besucher sieht#

  • Eine kleine Karte im Chat, die zeigt, welcher Schritt von wie vielen gerade läuft.
  • Bei einem Guide-Schritt die Anweisung, diesen Schritt selbst zu erledigen, wobei die richtige Stelle auf der Seite markiert ist.
  • Bei einem Hold-Schritt eine Schaltfläche Continue – nichts bewegt sich, bis er darauf klickt.
  • Eine Möglichkeit, das Ganze bei jedem Schritt abzubrechen, ohne den Chat zu verlassen.

Wenn ein Schritt nicht ausgeführt werden kann#

Vor jeder Aktion prüft die Engine das Element, das sie gleich anfassen will: Ist es wirklich auf der Seite, ist es sichtbar, ist es bedienbar, und führt es zurück auf genau das Element, das ihr genannt wurde? Scheitert etwas davon, wird der Schritt verworfen – nicht versucht. Ein Schritt, bei dem sich die Engine nicht sicher ist, wird nicht ausgeführt.

Wird derselbe Schritt dreimal hintereinander verworfen, hält die Journey an und sagt, warum. Der Assistent übernimmt das Gespräch dann ganz normal wieder. Hat sich eine Seite unter einer Journey verändert, endet sie höflich; der Besucher muss nicht zusehen, wie etwas sich immer wieder neu versucht.

Wie sie endet#

Der Assistent erfährt das Ergebnis einmal pro Journey, nicht Schritt für Schritt, und erst, wenn sie vorbei ist – abgeschlossen oder abgebrochen. Bis diese Nachricht kommt, behauptet er nicht, dass etwas erledigt ist, denn er weiß es tatsächlich nicht.

Wo sie läuft#

Das Chatfenster liegt in einem separaten Frame auf unserer Domain; die Engine läuft auf Ihrer Seite. Nur vier Dinge überschreiten diese Grenze: der auszuführende Plan, *Weiter*, *Stopp* und welcher Schritt gerade wo ist. Wer der Besucher ist, seine Sitzung und der Gesprächstext bleiben auf unserer Seite und gelangen nie auf Ihre Seite.

Tipp: In einem Projekt ohne Journeys wird die Engine gar nicht erst heruntergeladen – keine zusätzliche Anfrage, nichts wird Ihrer Seite hinzugefügt.

Die Journey startet nie.
Entweder ist die Funktion für das Projekt nicht aktiv – prüfen Sie auf der Seite Journeys, ob eine Voraussetzung weggefallen ist –, oder der Auslösesatz ähnelt nicht dem, was der Besucher eingetippt hat. Auslöser werden mit echten Sätzen verglichen, nicht mit Menübeschriftungen.
Sie bricht mittendrin ab.
Ein Schritt hat dreimal nicht gefunden, worauf er klicken sollte. Meist heißt das, dass sich die Seite geändert hat: Ein Element wurde umbenannt, verschoben oder erscheint jetzt erst nach etwas anderem. Öffnen Sie die Journey, korrigieren Sie diesen Schritt und veröffentlichen Sie erneut.
Sie wartet und nichts passiert.
Sie steht bei einem Hold- oder Guide-Schritt – genau dort, wo sie auf den Besucher warten soll. Diese Schritte enden, wenn der Besucher handelt oder auf Continue klickt – nie von selbst.