Wie richte ich den Schritt Schleife ein?

Wofür ist er da?

„Schleife“ führt dieselben Schritte für jeden Eintrag einer Liste aus. Der Schritt hat zwei Ausgänge: „Für jeden Eintrag“ und „Wenn fertig“.

Besucher sehen diesen Schritt nicht, und der Avatar sagt nichts; der Agent läuft weiter, ohne auf den Besucher zu warten.

Um ihn hinzuzufügen, klicken Sie im Tab „Editor“ auf „Schritt hinzufügen“ und dann in der Kategorie „Logik“ auf „Schleife“; der Schritt wird in der Mitte der Arbeitsfläche hinzugefügt. Seine Einstellungen liegen im Tab „Inhalt“ des Schrittpanels, das sich rechts öffnet, wenn Sie auf den Schritt klicken.

Dieser Schritt hat keinen „Text auf dem Bildschirm“; stattdessen gibt es unten im Panel eine „Schrittnotiz“. Die Notiz ist nur für Sie: Besucher sehen sie nicht, und sie wird weder gesprochen noch übersetzt.

In Werten nutzen Sie Variablen aus früheren Schritten wie {city}. Für ein Feld in einer Antwort fügen Sie den Feldnamen nach einem Punkt an: {order.status}. Der Knopf „Variable einfügen“ in den Feldern listet die an dieser Stelle nutzbaren Variablen auf. Eine noch nicht gefüllte Variable zählt als leerer Text.

Den Schritt einrichten

1. Wählen Sie unter „Woher die Einträge kommen“ eine Quelle und tragen Sie die Einträge ein (siehe unten).
2. Tragen Sie einen „Variablenname“ ein (z. B. service). In jedem Durchlauf wird der Eintrag dieses Durchlaufs in diese Variable geschrieben.
3. Verbinden Sie die Schritte, die für jeden Eintrag laufen sollen, mit dem Ausgang „Für jeden Eintrag“. Lassen Sie den Ausgang des letzten Schritts im Zweig leer: Endet der Zweig, beginnt der nächste Eintrag. Sie können den letzten Schritt auch selbst zurück mit dem Schritt Schleife verbinden.
4. Verbinden Sie den Schritt, zu dem es nach dem letzten Eintrag geht, mit dem Ausgang „Wenn fertig“.

Woher die Einträge kommen

• „Liste in einer Variable“: Schreiben Sie unter „Liste“ eine Listenvariable: eine Mehrfachauswahl-Antwort, die Liste eines Tools oder einer Aktion oder das Ergebnis von Liste bearbeiten.
• „Von Ihnen eingegebene Einträge“: ein Durchlauf pro Zeile; fügen Sie Zeilen mit „Eintrag hinzufügen“ hinzu. Zeilen können auch Variablen enthalten.
• „Zahlenbereich“: „Start“, „Ende“ und „Schritt“ (1, wenn leer). Das Ende ist eingeschlossen; zum Rückwärtszählen nutzen Sie einen negativen Schritt (-1). Die Werte können auch Variablen sein: {guests}.
• „Text teilen“: Der „Text“ wird am „Trennzeichen“ geteilt: „Komma“, „Semikolon“, „Jede Zeile“, „Senkrechter Strich (|)“ oder „Andere“ (ein eigenes Zeichen). Jeder Teil ist ein Durchlauf; leere Teile werden übersprungen. „Leerzeichen entfernen“ entfernt die Leerzeichen am Anfang und Ende jedes Teils.

Variablen, die in jedem Durchlauf geschrieben werden

Ist der Variablenname service, schreibt jeder Durchlauf: {service} den Eintrag, {service.field} ein Feld des Eintrags, {service_index} die Durchlaufnummer, {service_total} die Zahl der Einträge, {service_last} ob es der letzte Durchlauf ist (true/false). Diese Variablen werden am Ende der Schleife entfernt. „Zähler beginnt bei“ legt den Wert von {service_index} im ersten Durchlauf fest (standardmäßig 1), „Maximale Durchläufe“ die Höchstzahl verarbeiteter Einträge; ein Zahlenbereich hat keine dieser Einstellungen.

Durchläufe und die Schritte im Zweig

Eine Schleife läuft höchstens 100 Durchläufe; der Rest einer längeren Liste wird nicht verarbeitet. Ist die Liste leer, geht der Agent direkt zu „Wenn fertig“. Verbinden Sie einen Schritt im Zweig mit einem Schritt nach „Wenn fertig“, verlässt der Agent die Schleife vorzeitig; ein Schritt Ende im Zweig beendet das Gespräch. Schleifen lassen sich verschachteln: Ist der Ausgang „Wenn fertig“ der inneren Schleife leer, geht die äußere Schleife zum nächsten Eintrag.

Sie können auch Schritte in den Zweig setzen, die der Besucher sieht (Nachricht, Frage, Formular). Eine Integrationsaktion oder ein Tool-Aufruf im Zweig läuft in jedem Durchlauf einzeln: „eine Karte für jeden Eintrag erstellen“ erstellt eine Karte pro Eintrag. Die Antwort auf eine Frage im Zweig wird in jedem Durchlauf in dieselbe Variable geschrieben; jede neue Antwort ersetzt die vorherige.

Beispiel

In einem Schritt Auswahl vom Typ „Mehrfach“ hat der Besucher die Leistungen angekreuzt, die ihn interessieren; die Antwort steht in {services}. In der Schleife ist „Woher die Einträge kommen“ auf „Liste in einer Variable“, „Liste“ auf {services} und „Variablenname“ auf service gesetzt. Eine Integrationsaktion am Ausgang „Für jeden Eintrag“ sendet Ihrem Team für jede Leistung eine eigene Benachrichtigung („Neue Bewerbung für {service}“); der Ausgang „Wenn fertig“ führt zu einem Danke-Schritt Nachricht.

Worauf Sie achten sollten

Der Editor warnt, wenn: die Einträge nicht festgelegt sind; der Zahlenbereich ungültig ist (Start, Ende und Schritt müssen Zahlen sein, und der Schritt darf nicht 0 sein); der Variablenname ungültig ist (bis zu 50 Zeichen); „Für jeden Eintrag“ nicht verbunden ist (die Schleife führt nichts aus); oder „Wenn fertig“ nicht verbunden ist (der Flow endet nach dem letzten Eintrag). Leere Ausgänge von Schritten im Zweig lösen keine Warnung aus: Sie führen zurück zur Schleife.

Variablennamen dürfen nur die Buchstaben a–z, Ziffern und Unterstriche (_) enthalten; Akzentbuchstaben und Leerzeichen fallen beim Tippen weg. „system“ ist für Systemvariablen reserviert, wählen Sie also einen anderen Namen.

Logikschritte warten nicht auf den Besucher. Verbinden Sie sie (oder andere nicht wartende Schritte wie Nachricht, Tool-Aufruf oder Integrationsaktion) zu einem Ring, läuft der Agent immer im Kreis: Der Editor warnt „In einer Schleife, die nie auf den Besucher wartet; der Flow bleibt hier hängen.“, und im Gespräch endet der Agent mit einem Fehler. Um etwas zu wiederholen, nutzen Sie den Schritt Schleife oder setzen Sie einen Schritt, der auf den Besucher wartet (Frage, Auswahl, Formular), in den Ring.

Probleme verhindern das Speichern nicht: Der Agent wird gespeichert, aber der unvollständige Schritt funktioniert im Gespräch nicht wie erwartet. Beheben Sie die markierten Schritte und testen Sie den Agenten dann mit „Vorschau“. Wie Sie markierte Schritte finden, steht unter der Flow-Editor.