Wie richte ich die Schritte Integrationsaktion und Tool-Aufruf ein?

Wofür sind sie da?

Beide Schritte erledigen an einer Stelle im Agenten Arbeit in einem externen System; Besucher sehen keinen von beiden.

• „Integrationsaktion“ führt eine fertige Aktion einer verbundenen Integration aus (zum Beispiel eine Trello-Karte erstellen oder Slack oder Teams benachrichtigen).
• „Tool-Aufruf“ ruft ein Tool auf, das Sie auf der Seite „Tools“ für Ihr eigenes System definiert haben (zum Beispiel den Status einer Bestellung abfragen).

Beide haben die Ausgänge „Wenn fertig“ und „Bei Fehler“, und „Bei Fehler wiederholen“ funktioniert bei beiden gleich.

Integrationsaktion

Besucher sehen diesen Schritt nicht: Der Flow führt hier eine Aktion einer verbundenen Integration aus (zum Beispiel eine Trello-Karte erstellen oder Slack oder Teams benachrichtigen) und geht weiter.

1. Öffnen Sie in der Palette „Schritt hinzufügen“ die Kategorie „Integrationen“, klicken Sie auf die Integration und dann auf die Aktion; der Schritt wird der Arbeitsfläche hinzugefügt.
2. Prüfen Sie im Schrittpanel die „Aktion“ und füllen Sie ihre Felder aus. Wählen Sie Werte aus einer Liste („Aus der Liste wählen“) oder tippen Sie sie („Selbst eingeben“); nutzen Sie {variable} für frühere Antworten.
3. Um das Ergebnis in späteren Schritten zu nutzen, geben Sie ihm unter „In Variablen speichern“ einen Variablennamen. Variablen liegen im Browser des Besuchers, wählen Sie also keine Werte, die privat bleiben müssen.

Der Schritt hat zwei Ausgänge: „Wenn fertig“ und „Bei Fehler“. Ist die Integration nicht verbunden oder gibt der Anbieter einen Fehler zurück, nimmt der Flow „Bei Fehler“. Ist „Bei Fehler“ leer, schließt das Gespräch mit einer Meldung, dass etwas schiefgelaufen ist. Soll der Agent auch nach einem Fehler weiterlaufen, verbinden Sie „Bei Fehler“ mit demselben Schritt wie „Wenn fertig“. Ist ein Pflichtfeld leer, wird der Anbieter gar nicht aufgerufen und der Schritt nimmt „Bei Fehler“. Die „Schrittnotiz“ ist nur für Sie; Besucher sehen sie nicht.

Eine Aktion, die Daten ändert, läuft nicht erneut, wenn der Besucher die Zurück-Taste drückt oder eine Nachricht erneut sendet. Passiert das Gespräch diesen Schritt noch einmal (zum Beispiel beim Zurückgehen über ein Menü), läuft sie erneut.

Während der Schritt läuft, sieht der Besucher statt „Denkt nach“, was gerade passiert: einen passenden Text („Ihre Anfrage wird bearbeitet…“, „Details werden geprüft…“); bei interner Arbeit wie dem Benachrichtigen Ihres Teams nur „Einen Moment…“. Unter „Text während des Wartens“ können Sie Ihren eigenen Text schreiben (z. B. „Ihr Termin wird erstellt…“); er wird in Ihre anderen Sprachen übersetzt.

Aktionen, die etwas dauerhaft löschen oder stornieren, laufen erst, wenn Sie „Mir ist klar, dass dieser Schritt etwas Unumkehrbares tut“ anhaken; Aktionen, die von Ihrem Konto senden, brauchen „Mir ist klar, dass dieser Schritt von meinem Konto aus sendet“. Löschungen laufen höchstens 20-mal und Versände höchstens 100-mal pro Stunde je Arbeitsbereich. Der zu löschende Datensatz darf nicht aus einer Besucherantwort stammen.

Tool-Aufruf

Ruft ein auf der Seite „Tools“ definiertes Tool genau an dieser Stelle im Agenten auf, ohne KI. Besucher sehen diesen Schritt nicht; sein Text ist nur Ihre Notiz.

1. Fügen Sie einen Schritt Tool-Aufruf hinzu und wählen Sie das Tool aus der Liste.
2. Geben Sie den Feldern des Tools einen Wert: einen festen Wert, eine Variable aus einer früheren Antwort (zum Beispiel {order_no}) oder den Pfad zu einem Feld einer früheren Antwort (zum Beispiel {order.no}).
3. Speichern Sie unter „In Variablen speichern“ die vollständige Antwort oder den Fehlercode in einer Variable; in späteren Schritten nutzen Sie sie als {variable}.
4. Verbinden Sie die Zweige „Wenn fertig“ und „Bei Fehler“. Antwortet das Tool nicht oder gibt einen Fehler zurück, nimmt der Flow den Zweig „Bei Fehler“. Ist „Bei Fehler“ leer, schließt das Gespräch mit einer Meldung, dass etwas schiefgelaufen ist. Soll der Agent auch nach einem Fehler weiterlaufen, verbinden Sie „Bei Fehler“ mit demselben Schritt wie „Wenn fertig“.

Während das Tool läuft, sieht der Besucher einen Text wie „Details werden geprüft…“ oder „Ihre Anfrage wird bearbeitet…“ (bei Shop-Tools die Arbeit selbst, etwa „Produkte werden gesucht…“). Unter „Text während des Wartens“ können Sie Ihren eigenen Text schreiben.

Die Unterfelder der Objekt-Felder eines Tools werden in eigenen Feldern ausgefüllt. Bei einer Liste, deren Einträge Objekte sind, tragen Sie zuerst unter „Listenquelle“ eine Listenvariable ein (zum Beispiel die Liste einer Aktion oder das Ergebnis eines Schritts Liste bearbeiten) und ordnen dann unter „Felder jedes Eintrags“ die Felder des Eintrags zu, etwa {item.sku}. Jeder Eintrag der Quelle wird zu einer Zeile in der Liste; bleibt die Zuordnung leer, werden die Einträge unverändert gesendet.

Ein Tool, das Daten ändert, läuft nicht erneut, wenn der Besucher die Zurück-Taste drückt oder eine Nachricht erneut sendet. Passiert das Gespräch diesen Schritt noch einmal (zum Beispiel beim Zurückgehen über ein Menü), läuft es erneut. Ein Tool, das Daten liest, wird jedes Mal aufgerufen, wenn der Besucher den Schritt erreicht.

Ist ein Pflichtfeld leer oder passt ein Wert nicht zum Typ seines Felds, wird das Tool nicht aufgerufen und der Schritt nimmt „Bei Fehler“. Der Editor zeigt einen festen Wert, der nicht zu seinem Typ passt, als Warnung am Schritt. Aufrufe erscheinen auf der Seite „Tools“ › „Aufrufstatistik“.

Bei Fehler wiederholen

Schalten Sie „Bei Fehler wiederholen“ in einem Schritt Integrationsaktion oder Tool-Aufruf ein, läuft der Schritt bei einem vorübergehenden Fehler erneut. Sind die Versuche aufgebraucht, geht der Flow bei „Bei Fehler“ weiter; ist dieser Zweig leer, schließt das Gespräch mit einer Meldung, dass etwas schiefgelaufen ist.

• „Max. Versuche“: 2 bis 5; standardmäßig 3.
• „Wartezeit zwischen Versuchen (s)“: 0 bis 5 Sekunden; standardmäßig 1.

Alle Versuche dauern zusammen höchstens 18 Sekunden; läuft die Zeit ab, werden die restlichen übersprungen.

Wiederholt werden nur vorübergehende Fehler: Zeitüberschreitungen, Verbindungsfehler, Ausfälle des Anbieters und Ratenlimits. Bei Fehlern wie fehlender Berechtigung oder einem leeren Feld geht der Schritt direkt zu „Bei Fehler“.

Nutzen Sie die Option vorsichtig bei Schritten, die einen Datensatz erstellen oder eine Nachricht senden: Bei einer Zeitüberschreitung kann die Anfrage den Anbieter erreicht haben, sodass derselbe Datensatz oder dieselbe Nachricht zweimal entstehen kann.