Skripteingabe- und -ausgabevariablen

String-, numerische und boolesche Variablen haben die Eigenschaften Input und Output . Wenn die Eigenschaft einer Variablen Input Jaist, kann ihr Wert von einer externen Datenquelle festgelegt werden Wenn die Eigenschaft einer Variablen Output Jaist, wird ihr Wert auf dem Gesprächsobjekt gespeichert und kann nach Beendigung des Anrufs programmatisch abgerufen werden Diese Eigenschaften schließen sich nicht gegenseitig aus. Für eine Variable kann entweder eine oder beides aktiviert werden.

Variablen, bei denen diese Eigenschaften aktiviert sind, werden als Eingangsvariablen, Ausgangsvariablen oder beides bezeichnet. Hier erfahren Sie, wie Sie diese Begriffe verstehen:

  • Eine Variable ist eine -Eingangsvariable , wenn ihre Input-Eigenschaft Ja lautet Sein Wert kann von einer externen Quelle, z. B. einem Architect Call Flow, eingegeben werden

  • Eine Variable, deren Output-Eigenschaft Ja ist, ist eine Ausgangsvariable. Wenn das Skript ausgeführt wird, wird jeder der Variablen zugewiesene Wert zur Verwendung außerhalb des Skripts gespeichert. Sein Wert ist und wird bei der Ausführung des Skripts in den externen Speicher ausgegeben

  • Da beide Eigenschaften auf Ja gesetzt werden können, kann eine Variable sowohl eine Eingabe- als auch eine Ausgabevariable sein.

  • Wenn eine Listenvariable als Eingabe verwendet wird, wird der Wert in der Konversation durch ein Komma getrennt.
  • Wenn eine Listenvariable als Ausgabe verwendet wird, wird die Liste durch ein Komma in der Konversation zusammengefügt.

Sie können keine dynamischen Variablen als Ein- oder Ausgangsvariablen verwenden.

Bei neuen Variablen sind sowohl Eingabe als auch Ausgabe standardmäßig auf nein eingestellt. Wenn Sie bestehende Skripte haben, die Variablen verwenden, dann setzt Genesys Cloud die Ein- und Ausgabe für diese Variablen auf ja, so dass die Skripte abwärtskompatibel sind.

Eigenschaft ausgeben

Die Eigenschaft Output ermöglicht es, den Wert einer Skriptvariablen zur Verwendung nach Beendigung eines Anrufs zu speichern, ohne eine Datenaktion einrichten oder zusätzliche Spalten zu einer Kontaktliste hinzufügen zu müssen Wenn Ausgabe auf Ja gesetzt ist, wird der Wert dieser Skriptvariablen in das Konversationsobjekt geschrieben. Der gespeicherte Wert kann von einem externen Prozess des Kunden programmatisch abgerufen werden. Um eine Variable als Ausgangsvariable zu verwenden, aktivieren Sie Output. Wenn sich der Wert dieser Variablen während der Ausführung eines Skripts ändert, wird das Konversationsobjekt innerhalb von 3 Sekunden aktualisiert.

Schlüssel/Wertpaare im Konversationsobjekt

Variablen werden als Schlüssel/Wert-Paare in das Konversationsobjekt geschrieben. Sie können sie über die Endpunkte der Plattform-API Conversationsabrufen. Abfrage des Objekts "Teilnehmerattribute" der Konversation unter Verwendung des Variablennamens als Schlüssel:

"participants": [
  {
    "attributes": {
      "scripterOutputVariable1": "value",
      "scripterOutputVariable2": "value"
    },
],
  • Wenn die Variable nur ausgegeben wird, wendet Genesys Cloud den Wert dieser Variable auf den Agenten-Teilnehmer an, es sei denn, sie sieht diese Variablendaten auf einem anderen Teilnehmer; in diesem Fall aktualisiert Genesys Cloud den anderen Teilnehmer, um die Daten synchron zu halten.
  • Wenn die Variable sowohl Eingabe als auch Ausgabe ist, ordnet das Skript die Daten dem Teilnehmer zu, für den es die Daten gefunden hat, was in den meisten Fällen der Teilnehmer Kunde ist. Andernfalls ist der Standardstandort der Teilnehmer des Agenten.

Zum Beispiel, wenn die Daten von Architekt durch eine Eingangsvariable kommen, dann Architekt stellt die variablen Daten auf den Kundenteilnehmer, und zukünftige Aktualisierungen auf dass Variable überschreibt den Wert auf den Kundenteilnehmer.

Hinweis: Genesys Cloud fügt Ausgabevariablen zu v2/conversations hinzu, nicht zu v2/analytics/conversations. 

Datenaktionen vs. Ausgangsvariablen

Die externe Datenaktionsmethode zum Speichern von Daten aus Skripten eignet sich für Kunden, die komplexe Informationen ausgeben und diese dann über gespeicherte Prozeduren in eine Datenbank leiten müssen. Die Eigenschaft Ausgabe bietet eine einfachere Möglichkeit, die in einem Skript erfassten Daten zu speichern.

  • Wenn die Ausgabe auf Ja eingestellt ist, werden String-, numerische oder boolesche Variablen als Schlüssel/Wert-Paare in den Konversions-Endpunkt der öffentlichen API geschrieben, die leicht durchsucht, abgerufen und korreliert werden können.

  • Dynamische und Objektvariablen können mit diesem Verfahren nicht gespeichert werden. Um komplexe Objektdaten oder dynamische Variablen zu speichern, verwenden Sie stattdessen eine Datenaktion.

Eingabe-Eigenschaft

Die Eigenschaft Input gibt an, ob der Wert dieser Variablen von einer externen Quelle, wie z.B. einem Architect Call Flow, gesetzt werden kann. Setzen Sie Input für alle Variablen, für die Sie eingehende Daten empfangen möchten, auf Ja. Wenn Eingabe auf Nein eingestellt ist, akzeptiert die Variable keine externen Werte, selbst wenn die externe Quelle einen Wert sendet. Um eine Variable als Eingangsvariable zu verwenden, aktivieren Sie Input. 

Kundengeschützte Daten

Ausgabe der Konversationseinstellungen für Get Secure Data und Set Secure Data

Wenn die Option Output für die Variable aktiviert ist, wird der Wert dieser Skriptvariablen in das Konversationsobjekt geschrieben Der Kunde kann den Wert der Variablen programmatisch abrufen, um die Ausgabe sensibler Daten während der Kundeninteraktion zu ermöglichen. Stellen Sie sicher, dass Sie die Option Output für die Variable deaktivieren, damit die in diese Variable eingegebenen Daten nicht auf unsichere Weise während der Kundeninteraktionen verwendet werden Weitere Informationen finden Sie unter Verfügbare Skriptaktionen. Die Funktionen Get Secure Data und Set Secure Data der Funktion Customer Secured Data sind der richtige Weg, um die sensiblen Kundendaten abzufragen und zu aktualisieren. Weitere Informationen finden Sie unter Get Secured Data action und Set Secured Data action