Spawn-Skripte
Durch das Generieren eines Skripts können Sie ein Skript manuell ausführen. Außerdem können Sie auf diese Weise ein Skript von anderen Skripten oder externen Prozessen starten. Sie können damit auch ein Skript testen. Beim Testen können auch Skript-Traces verwendet werden.
Um Skripte zu testen, können Sie Skripte von Studio aus mit der trace optionstarten.
So starten Sie Skripte von anderen Skripten oder Prozessen:
- Verwenden Sie die SPAWN-action im aufrufenden Skript.
- Verwenden Sie die POST /scripts/start
-API. Dies ist die empfohlene Vorgehensweise zum Generieren eines Skripts von einem externen Prozess.
Geschäftseinheiten können maximal 15.000 Skripte ausführen, sofern nicht anders konfiguriert. Wenn dieses Limit erreicht ist, können mit keiner der auf dieser Seite beschriebenen Methoden weitere Skripte gestartet oder erzeugt werden, bis ein oder mehrere Skripte nicht mehr ausgeführt werden.
Skriptparameter
Mithilfe von Skriptparametern können Daten an Skripte übergeben werden. Die Daten können aus anderen Skripten stammen, beispielsweise aus Systemskripten, oder aus externen Quellen wie CRM
Systeme von Drittanbietern, die z. B. Kontakte, Vertriebsinformationen, Supportdetails und Fallgeschichten verwalten.-Systemen oder APIs. Sie werden in den pX-Variablen p1 bis pN an die Skripte übergeben. Dabei ist N die maximale Anzahl von Parametern, die von der Generierungsmethode unterstützt wird. Sie können die Daten, die an das Skript übergeben werden sollen, beim Generieren des Skripts mit einer der im vorherigen Abschnitt aufgelisteten Optionen angeben.
Wenn Sie die Namen der Parametervariablen ändern möchten, konfigurieren Sie die Begin-Aktion im generierten Skript mit neuen Namen. Wenn das Skript die BEGIN-Aktion verarbeitet, werden die pX-Variablen in die neuen Namen konvertiert. Wenn Sie keine neuen Namen angeben, werden die pX-Namen der Variablen beibehalten.
Wenn die Daten an ein Skript übergeben werden, können Sie sie in einem trace anzeigen. Wählen Sie die BEGIN-Aktion aus, damit die Parametervariablen in der Variablenliste der Trace-Ausgabe angezeigt werden. Wenn Sie die BEGIN-Aktion mit neuen Variablennamen konfiguriert haben, wählen Sie die Aktion nach BEGIN im Skript-Trace aus, damit sie angezeigt werden. Parametervariablen sind nur dann vorhanden, wenn sie einen Wert enthalten.
- Unterstützen die folgenden Höchstwerte:
- 32 KB pro Wert beim Generieren mit der SPAWN-Aktion.
- 32 KB insgesamt für alle Parameter, einschließlich der Senkrechtstrich-Trennzeichen, beim Generieren über die API.
- Unterstützen die Variablenersetzung. Geben Sie den Variablennamen in geschweiften Klammern ( { } ) ein.
- Unterstützung von 1-20 Parametern beim Starten über die SPAWN Aktion oder API.
- Unterstützen keine dynamischen Datenobjekte. Objekte müssen zunächst in einen JSON-String konvertiert werden.
Vergleich der Studio-Aktionen
Es gibt drei Studio-Aktionen, mit denen ausgehend vom aktuellen Skript ein neues Skript gestartet wird. Zwischen ihnen bestehen jedoch einige Unterschiede:
- Runscript: Wenn ein anderes Skript auslöst, kehrt es nicht vom zweiten Skript zum ersten Skript zurück.
- Runsub: Wenn ein Subskript auslöst, kann das Skript zum ersten Skript zurückkehren, sofern das Subskript eine -Aktion hat. Die -Aktion liefert einen Wert an die -Aktion zurück, wenn das Subskript beendet ist.
- SPAWN: Startet ein zweites Skript, das parallel zum ersten Skript ausgeführt wird. Generierte Skripte können keine Daten an das erste Skript zurückgeben, es sei denn, Sie schließen eine action- in das generierte Skript ein.
Generieren auf Basis eines anderen Skripts mithilfe der SPAWN-Aktion
Wenn keine Parameterwerte an das untergeordnete Skript übergeben werden müssen, müssen Sie lediglich die SPAWN-Aktion im übergeordneten Skript hinzufügen und konfigurieren. Wenn Parameter übergeben werden müssen, sind die folgenden Konfigurationen erforderlich:
- Nehmen Sie am übergeordneten Skript die folgenden Änderungen vor:
- Platzieren Sie die SPAWN-Aktion an der Stelle, an der das untergeordnete Skript generiert werden soll. Konfigurieren Sie die Parameters-Eigenschaft in der SPAWN-Aktion mit den Werten, die an das untergeordnete Skript übergeben werden müssen. Die Werte werden in den Variablen p1 bis p9 übergeben.
- Konfigurieren Sie die other properties der SPAWN-Aktion.
-
Nehmen Sie am untergeordneten Skript die folgenden Änderungen vor:
- Konfigurieren Sie die Parameters-Eigenschaft in der -Aktion, um den Namen der benutzerdefinierten Parametervariablen zu ändern. Wenn Sie keine Änderung vornehmen, verbleiben die benutzerdefinierten Parameterwerte in den -Variablen.
- Wenn Werte an das übergeordnete Skript oder die aufrufende Anwendung zurückgegeben werden müssen, fügen Sie eine action hinzu und konfigurieren Sie sie.
Generieren eines Skripts über die API
Verwenden Sie die POST /scripts/start
-API, um ein Skript zu generieren.
Beachten Sie bei Verwendung dieser API die folgenden wichtigen Punkte:
- Die folgenden Parameter sind erforderlich:
- skillId: Beim Senden im JSON-Format muss der Wert eine Ganzzahl sein, beim Senden als Abfrageparameter jedoch nicht. Für Skills gelten die folgenden Voraussetzungen:
- Aktiv sein.
- Mit dem Skriptmedientyp übereinstimmen. So müssen zum Beispiel die Telefonskripte mit den Skills der Anrufer übereinstimmen. Sie finden den Skilltyp auf der Registerkarte "Details" eines Skills. Skripte des Typs "Generic" funktionieren mit jedem aktiven Skill.
scriptId oder scriptPath: Es wird empfohlen, scriptPath zu verwenden. Die Skript-ID ändert sich immer, wenn Änderungen am Skript gespeichert werden. Deshalb muss sie im Parameter aktualisiert werden.
- skillId: Beim Senden im JSON-Format muss der Wert eine Ganzzahl sein, beim Senden als Abfrageparameter jedoch nicht. Für Skills gelten die folgenden Voraussetzungen:
- Sie können bis zu 20 Parameter angeben.
- Parameter müssen in einer Liste mit einem Senkrechtstrich als Trennzeichen gesendet werden.
- Die API unterstützt maximal 32 KB für alle Parameter, einschließlich der Senkrechtstrich-Trennzeichen.
- Der Senkrechtstrich darf in Parametern ausschließlich als Trennzeichen verwendet werden.
- Beim Senden der Anforderung im JSON-Format müssen reservierte Zeichen ordnungsgemäß in Escape-Zeichen eingeschlossen werden.
- Wird die Anforderung über URL-Abfrageparameter gesendet, müssen die Parameter URL-kodiert sein.