Snippet für den Bot-Sitzungsstatus

Dieses Snippet ist zur Verwendung mit Aktionen vorgesehen, die die Eigenschaft botSessionState haben, wie beispielsweise Textbot Exchange und Voicebot Exchange (im Folgenden werden beide Aktionen einfach als Exchange bezeichnet). Die Eigenschaft botSessionState muss ordnungsgemäß konfiguriert sein, damit Ihre virtuellen Agenten Eine Softwareanwendung, die Kundeninteraktionen anstelle eines Live-Mitarbeiters abwickelt. wie erwartet funktionieren.

Die botSessionState-Eigenschaft muss konfiguriert werden mit der Variablen, die die eindeutige ID für das Gespräch zwischen dem Kontakt und dem virtuellen Agenten aufweist. Sie wird automatisch vom Anbieter des virtuellen Agenten zugewiesen. Die ID verhindert, dass bei jeder Gesprächsrunde eine neue Sitzung erstellt wird, und unterstützt den virtuellen Agenten den Zusammenhang zwischen den Runden beibehalten.

Der Anbieter erstellt die ID beim Beginn des Gesprächs und übergibt sie mit der ersten Antwort an das Skript. Das Skript speichert die ID in der Variablen, die in der botSessionStateVarName (out)-Eigenschaft der Exchange-Aktion angegeben ist. Abschließend übergibt das Skript die ID aus der botSessionStateVarName (out)-Eigenschaft der vorherigen Gesprächsrunde an die botSessionState-Eigenschaft.

Ihre Skripte sollten nie in diese Eigenschaft oder ihre Variable schreiben. Ihr Skript muss so eingerichtet sein, dass die ID für den Bot-Sitzungsstatus verwendet wird.

Einrichtung des Skripts

Wenn Sie eine Exchange-Aktion verwenden, muss Ihr Skript mindestens zwei Instanzen der Aktion enthalten. Die botSessionState-Eigenschaft in jeder Exchange-Aktion muss unterschiedlich konfiguriert sein:

• Die erste Instanz der Exchange-Aktion befindet sich direkt nach der Begin-Aktion am Anfang des Skripts. Konfigurieren Sie sie wie folgt:
  • botSessionState: Dies muss leer sein.
  • botSessionStateVarName (out): Konfigurieren Sie dies mit dem Namen der Variablen, in der das Skript die ID speichern soll.
• Die zweite Exchange-Aktion befindet sich weiter hinten im Skript. Konfigurieren Sie sie wie folgt: 
  • botSessionState: Konfigurieren Sie dies mit der Variablen, die in botSessionStateVarName (out) in der ersten Instanz der Exchange-Aktion verwendet wird. Die Variable muss die ID für den Bot-Sitzungsstatus im JSON-Format enthalten.
  • botSessionStateVarName (out): Konfigurieren Sie dies mit dem Namen der Variablen, in der das Skript die ID speichern soll.
• Die dritte und weitere Instanzen der Exchange-Aktion sind optional. Wenn Ihr Skript diese Instanzen enthält, konfigurieren Sie sie wie folgt:
  • botSessionState: Konfigurieren Sie dies mit der Variablen, die in botSessionStateVarName (out) in der vorherigen Instanz der Exchange-Aktion verwendet wird. Die Variable muss die ID für den Bot-Sitzungsstatus im JSON-Format enthalten. Die ID für den Bot-Sitzungsstatus ändert sich normalerweise zwischen Runden nicht. Wenn sie sich jedoch ändert, sollte die Aktion so konfiguriert sein, dass sie die Änderung erfasst.
  • botSessionStateVarName (out): Konfigurieren Sie dies mit dem Namen der Variablen, in der das Skript die ID speichern soll.

Diese Konfiguration ist für alle virtuelle Agenten erforderlich.

ID für den Bot-Sitzungsstatus in das JSON-Format konvertieren

Der Inhalt der in der botSessionStateVarName (out)-Eigenschaft verwendeten Variablen muss in das JSON-Format konvertiert und an die botSessionState-Eigenschaft der zweiten Exchange-Aktion in Ihrem Skript übergeben werden. Zu diesem Zweck können Sie Code in eine Snippet-Aktion einbeziehen oder Sie können die Eigenschaft direkt konfigurieren. Beide Herangehensweisen sind akzeptabel. Der Vorteil der Erstellung einer Variablen in einem Snippet, die das umgewandelte Objekt enthält, besteht jedoch darin, dass leichter zu sehen ist, wo die Umwandlung passiert.

Snippet-Aktion verwenden

1. Konfigurieren Sie die botSessionStateVarName (out)-Eigenschaft der Exchange-Aktion mit dem Namen der Variablen, die die ID für den Sitzungsstatus enthält. Zum Beispiel botSessionState.

2. Fügen Sie folgende Zeile einem Snippet hinzu, das sich vor der Exchange-Aktion in Ihrem Skript befindet:

   ASSIGN botSessionStateOut = botSessionStateOut.asJSON()

   Verwenden Sie den Namen der Variablen, die in Ihrem Skript enthalten ist.

3. Konfigurieren Sie die botSessionState-Eigenschaft in der Exchange-Aktion mit dem Namen der Variablen, die Sie in der ASSIGN-Anweisung verwendet haben. Zum Beispiel botSessionStateOut.

Eigenschaft umwandeln

Wenn Sie die Variable in der Eigenschaft botSessionState konvertieren, verwenden Sie die Variable botSessionStateVarName (out) mit der asJSON()-Funktion. Beispiel:

• botSessionStateVarName (out):botSessionState
• botSessionState: botSessionState.asJSON()