Anpassen des Skript-Widgets in der Zoom-App

Das Skript-Widget kann von Contact-Center-Administratoren hinzugefügt und bearbeitet werden. Mit diesem Skript-Widget können Sie einen Flow erstellen, indem Sie die gewünschten Aktionen an das Widget selbst senden, sodass Sie sich beim Erstellen eines Flows nicht auf die Benutzeroberfläche verlassen müssen. Standardmäßig verbergen Skript-Widgets Schlüssel, Geheimnisse und andere Anmeldeinformationen, die ihnen zugeordnet sind.

Wichtig:

• Zoom Contact Center gab bekannt, dass es am 17. September 2022 eine neue Skript-Engine einführen wird, die Folgendes einführt: neu Syntax für Skripte. Diese Änderung hat keine Auswirkungen auf bestehende Skripte. Allerdings gibt es bei der Entwicklung einige Regeln, die beachtet werden müssen neu Skript-Widgets. Dieser Artikel enthält Beispiele für neu Skriptsyntax im Abschnitt „Neue Version“.

• Die folgenden Beispielkonfigurationen helfen Ihnen, die Verwendung des Skript-Widgets besser zu verstehen.

Voraussetzungen für die Anpassung des Skript-Widgets

• Eigentums- oder Administratorrechte des Kontos

• Egal, ob Sie ein Business-, Education- oder Pro-Konto besitzen

• Eine Lizenz für Zoom Contact Center ist erforderlich

• Erstellen Sie ganz nach Ihren Wünschen Sprach-, Video-, Web-, In-App- oder SMS-Flows

• Ein fortgeschrittenes Verständnis von Javascript ist erforderlich

So fügen Sie das Skript-Widget hinzu oder bearbeiten es

1. Auf das Webportal von Zoom kann nach Anmeldung zugegriffen werden.

2. Klicken Sie im Navigationsmenü auf Contact Center Management und dann in der Dropdown-Liste auf Flows.

3. Der Anzeigename eines Flows kann durch Anklicken bearbeitet werden.

4. Das Skript kann an die gewünschte Stelle im Flow gezogen werden, indem Sie auf das Widget im linken Widget-Bereich klicken und es ziehen.

5. Sie müssen das Widget namens „Skript“ auswählen.

6. Das Widget kann umbenannt werden, um es für den Endbenutzer verständlicher zu machen. Klicken Sie auf Umbenennen, um Ihren Namen zu erstellen ändern.

7. Das Hinzufügen eines neuen Skripts zu einem Widget kann durch Klicken auf die Schaltfläche „Skript hinzufügen“ und anschließendes Festlegen der folgenden Optionen erfolgen:

8. Klicken Sie bitte auf die Schaltfläche „Hinzufügen“.

9. Wenn Sie JavaScript verwenden, geben Sie bitte den folgenden Code ein.

10. Über das Bedienfeld „Eingabeparameter“ können Sie auf der rechten Seite des Bildschirms Parameter für das Skript im JSON-Format eingeben. Dies wird verwendet, um das Skript lokal zu testen. Die Schlüssel/Wert-Paare müssen entsprechend dem JavaScript-Code eingefügt werden. Stellen Sie daher sicher, dass Sie sie einschließen. Der Eingabeparameter, den Sie angeben müssen, sollte alle Schlüssel/Wert-Paare enthalten, die Sie beim lokalen Testen Ihres Codes erwarten.

11. Klicken Sie auf die Schaltfläche Ausführen.
    Im Abschnitt „Ergebnisse“ können Sie die Ergebnisse sehen.

12. Schließen Sie das Fenster, indem Sie darauf klicken.

13. Um das Skript zu speichern, klicken Sie auf die Schaltfläche Speichern.

14. Klicken Sie auf der Registerkarte „Einstellungen“ auf die folgenden Optionen (optional):

15. Sie können Ihre Exit-Einstellungen anpassen, indem Sie auf klicken Ausgänge Tab.

    • Erfolg: Falls das Skript erfolgreich ausgeführt wurde, wählen Sie das Ziel-Widget aus.

    • Scheitern: Wenn die Ausführung des Skripts fehlschlägt, wählen Sie das Widget aus, das das Ziel sein soll

Notiz: Sehen Sie sich Beispielkonfigurationen des Skript-Widgets an, um besser zu verstehen, wie es funktioniert.

Zuordnung von Skriptvariablen

Es ist möglich, einen Skriptvariablenwert einer Flussvariablen zuzuordnen, nachdem das Skript-Widget konfiguriert und ausgeführt wurde.

• Im Skript var_set() werden alle Variablen in eine Flussvariable namens widget gesetzt, die dann dem Skript var_set() zugeordnet wird. Es ist möglich, diese Variable als lokale Variable zu betrachten.

• Unter dem Widget-Namen gibt es eine Flussvariable namens „value“, die den vom Skript zurückgegebenen Wert enthält, wenn das Widget aufgerufen wird.

• Global Benutzerdefinierte Variablen sollten für alle Variablen definiert werden, die durch global_var_set festgelegt werden, um in globalen Variablen verwendet zu werden. Es ist möglich, auf den vollständigen Namen der globalen Variablen im Skript-Widget zu verweisen und ihn mithilfe von global_var_set im Skript-Widget zu ändern.

Beispiel für eine Skriptzuordnung

Weitere Informationen zu Kontonummern finden Sie im folgenden Beispiel.

So programmieren Sie Skripte

1. Ihr Code sollte alle Abhängigkeiten enthalten, die Sie benötigen. Sie können den Beispielcode unten sehen In Zeilen 2 bis 4.

2. Damit die Code-Engine Ihre JS-Funktion extrahieren kann, übergeben Sie Ihre Funktion an module.exports. Async sollte nur verwendet werden, wenn in Ihrer Funktion „await“ erforderlich ist. Die Funktion muss nicht über das Codefeld aufgerufen werden, es besteht also keine Notwendigkeit, sie dort aufzurufen.
   Notiz: Ein automatischer Schalter wird aktiviert, um den strengen Modus zu aktivieren.

Beispiel für Skriptprogrammierung

Neue Version

async function main () {
  // your code starts here
}

Note: 
#### Supported built-in functions: (no need to import again)

## Variable Get/Set:
var_get()(string); var_set(string, string); global_var_set(string, string)

## Http Requests:
req.get(url(, config)); req.delete(url(, config)); req.head(url(, config)); req.options(url(, config))
req.post(url(, data(, config))); req.put(url(, data(, config))); req.patch(url(, data(, config)))

## Logging
log.debug(string), log.info(string), log.warn(string), log.error(string)

Alte Version

// Using Lambda

const log = require('./utils/log');
const req = require('axios'); // this is needed only if you plan to use Axios in your function
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

module.exports = async () => {

// add your script logic. See two examples above.

return
}

Notiz: Das Javascript-Skript-Widget bietet derzeit nur Zugriff auf das externe Axios-Modul, das derzeit das einzige verfügbare ist.

So verwenden Sie die Protokollierung

Mit der folgenden Funktion können Sie die Abhängigkeit importieren:

const log = require(‘./utils/log’);

Notiz: Da ist ein neu Version der Skript-Engine, die dies bereits enthält, sodass Sie es nicht erneut importieren müssen, da es integriert ist

Beispiel für die Protokollierung

Die folgenden Funktionen können verwendet werden, um die Protokollierung in Ihrer Anwendung zu implementieren:

log.debug(“Debugging aktiviert“) log.error („Fehler erkannt“) log.info („Info: Ja“) log.warn („WARNUNGEN:“)

So implementieren Sie HTTP-Anfragen

Die HTTP-Requests können mit Axios über die HTTP-Request-Bibliothek umgesetzt werden. Weitere Informationen zum Axios Support finden Sie auf der Website des Unternehmens.

Mit der folgenden Funktion können Sie die Abhängigkeit importieren:

const req = require('axios');

Notiz:

• Sie müssen es nicht erneut importieren, da dies bereits in integriert ist neu Version der Skript-Engine.

• Das HTTP-Aufruf-Widget ist ein Standard-Widget, mit dem Sie mithilfe von JavaScript-Funktionen HTTP-Anfragen stellen können, ohne JavaScript schreiben zu müssen. Für fortgeschrittenere Anwendungsfälle können Sie das Axios-Modul auch in Verbindung mit einem Skript verwenden, das HTTP-Anfragen ausführt.

So erhalten Sie Variablen im Skript-Widget

1. Ihr Flow sollte ein Skript-Widget enthalten, das Sie hinzufügen und konfigurieren können.

2. Der Variablenabhängigkeitsimport muss zur JavaScript-Datei hinzugefügt werden.

   Beispiel:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set}
      = require('./utils/variable');

Notiz: Sie müssen es nicht erneut importieren, da dies bereits in integriert ist neu Version der Skript-Engine.

1. Um herauszufinden, was der Wert einer Variablen ist, können Sie uns kontaktierenetdie var_get-Funktion. Mit der Funktion var_get kann sowohl auf lokale Widget-Variablen als auch auf globale Variablen zugegriffen werden. Zusätzlich zu den global definierten Systemvariablen müssen Sie Ihre eigenen globalen Variablen definieren, bevor Sie diese verwenden können.
   Beispiel:

var_get()("global_system.Consumer.firstName")

Notiz: VaDer Umfang von Risiken innerhalb von Flows ist auf das aktive Engagement beschränkt, obwohl globale Variablen global im System definiert sind. A Der Wert der globalen Variablen ist spspezifisch eingestellt foder ein bestimmtes Engagement, wenn es innerhalb eines Flows festgelegt/geändert wird. Der aktualisierte globale Variablenwert setbEin anderes Engagement steht anderen Verbrauchern nicht gleichzeitig oder später im selben Ablauf zur Verfügung.

So legen Sie lokale Variablen im Skript-Widget fest

1. Fügen Sie das Skript-Widget zu Ihrem Flow hinzu und konfigurieren Sie es. Das Skript-Widget sollte in diesem Beispiel in Skript1 umbenannt werden.

2. Die Variablenabhängigkeit sollte in eine JavaScript-Datei importiert werden. Der Abhängigkeitsimport muss hinzugefügt werden.
   Beispiel:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Notiz:Es ist nicht erforderlich, dies erneut zu importieren, da es erstellt wurde hinein Die neu Version der Skript-Engine.

1. Legen Sie den Wert einer lokalen Variablen mit der Funktion var_set fest. Lokale Variablen werden mit ihrem vollständigen Namen benannt und ihre Werte werden anhand ihrer Werte identifiziert.

   Beispiel:

var_set("account_number", “99999")

Innerhalb dieses Ablaufs kann auf Script1.account_number als Wert dieser Variablen zugegriffen werden

So legen Sie globale Variablen im Skript-Widget fest

1. Das Skript-Widget sollte in Ihrem Flow hinzugefügt und konfiguriert werden.

2. Der Variablenabhängigkeitsimport muss einer JavaScript-Datei hinzugefügt werden.
   Beispiel:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Notiz: Sie müssen es nicht erneut importieren, da es in integriert ist neu Version der Skript-Engine

1. Legen Sie den Wert einer globalen Variablen mit der Funktion global_var_set fest. Der vollständige Name einer globalen Variablen ist der erste Parameter und der Wert der zweite.
   Beispiel:

global_var_set("global_system.Consumer.firstName", "Your Name")

Notiz: Flüsse haben einen begrenzten Umfang, während globale Variablen global im System definiert werden können.