Skripte
In der Studio Anwendung ist ein Skript ein Netzwerk von AktionenFührt einen Prozess innerhalb eines Studio-Skripts durch, wie z. B. das Erfassen von Kundendaten, Abspielen einer Nachricht oder Musik oder die Weiterleitung eines Kontakts zu einem Agenten., die den Kundendatenverkehr für ein Contact Center weiterleiten und verwalten. Wenn ein Kunde beispielsweise in ein Contact Center anruft, interagiert der Kunde mit einem eingehenden Telefonskript, das möglicherweise nach bestimmten Informationen wie einer Kontonummer fragt, oder leitet den Anrufer basierend auf dem Grund für den Anruf an die entsprechende Abteilung weiter. Jede Aktion im Skript hat einen bestimmten Zweck, z. B. das Ermitteln von Skills oder Variablen, das Abspielen von Wartemusik oder das Abrufen (und Weitergeben) von Kundeninformationen wie Name, Adresse oder Kontonummer. Aktionen werden über Konnektoren miteinander verknüpft, die mögliche "Pfade" festlegen, über die ein Kunde durch das Skript navigieren kann, wie z. B. die Aktion MENU mit Optionen zum Sprechen mit einem Agenten in verschiedenen Abteilungen. Skripte können sehr einfach aufgebaut sein, wie z. B. die Weiterleitung eines Telefonkontakts vom Anrufer zum Agenten, aber können auch sehr komplex, wie z. B. mit mehreren Verzweigungen, die auf der Grundlage einer großen Anzahl von Parametern zu verschiedenen Aktionen führen.
Der grundlegende Workflow für die Entwicklung eines Skripts besteht darin, Aktionen von den Registerkarten "Tools" oder "Framework" auf die Zeichenfläche (d. h. den leeren, offenen Bereich in der Benutzeroberfläche) zu ziehen und dort abzulegen und dann die Aktionen zu verbinden, um die möglichen Pfade des Anrufflusses zu bestimmen. Nachdem Sie die Grundstruktur der Aktionen erstellt haben, können Sie jede Aktion weiter konfigurieren, indem Sie zusätzliche Parameter hinzufügen oder Eingabeaufforderungen hochladen, die abgespielt werden sollen.
Sie können Skripts für die Ausführung durch CXoneplatform planen, siehe Skriptzeitpläne für weitere Informationen.
Für Informationen zur Skripte-Seite auf CXoneplatform, siehe Skriptseite.
Elemente der Skriptingschnittstelle
Das vorstehende Bild gibt einen Überblick über die Studio Benutzeroberfläche. Der große mittlere Bereich ist der primäre Arbeitsbereich, der als Arbeitsfläche bezeichnet wird und in dem Sie Aktionen platzieren und mit ihnen interagieren, um Ihr Skript zu erstellen. Studio bietet eine Vielzahl von Registerkarten oder Fenster, die Sie öffnen und in den Fenstern um die Zeichenfläche anordnen können, um Zugriff auf die Komponenten zu erhalten, die Sie zum Erstellen und Verwalten von Skripten benötigen. In diesem Bild wird die Registerkarte Extras im rechten Bereich angezeigt, die Registerkarte Navigieren wird links angezeigt und die Registerkarte Skriptfehler wird unter der Zeichenfläche angezeigt. Sie können Aktionen von den Registerkarten Extras und Framework (im rechten Bereich des Bildes) auf die Leinwand klicken und ziehen, um ein Skript zu erstellen (die Registerkarte Framework muss speziell von einem internen Administrator aktiviert werden).
Skripttypen
Sie können einen bestimmten Skripttyp erstellen, der mit den verschiedenen Kanälen in Ihrem Contact Center korreliert.
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Allgemein | Chat | Telefon | Voicemail | Arbeitsaufgabe | SMS |
Beim Erstellen eines neuen Skripts Studio fordert Sie auf, den Typ des zu erstellenden Skripts festzulegen. Die Art des Skripts, das Sie auswählen, muss mit der Art des Routings (oder einer anderen Aufgabe) korrelieren, die Sie ausführen möchten. Die meisten Aktionen funktionieren in jedem Skripttyp. Einige können jedoch nur einem bestimmten Skript hinzugefügt werden (z. B. ASRAutomatische Spracherkennung; ermöglicht es Kontakten, auf aufgezeichnete Sprachansagen zu reagieren, indem sie sprechen, Tasten auf ihrem Telefon drücken oder eine Kombination aus beiden. Aktionen funktionieren mit Telefonskripten). Wenn Sie versuchen, eine Aktion aus dem zu verwenden Rahmen Registerkarte, die nicht mit dem von Ihnen erstellten Skripttyp kompatibel ist, zeigt Studio eine Fehlermeldung an. Darüber hinaus werden Aktionen, die nicht mit einem bestimmten Skripttyp kompatibel sind, nicht in der Liste angezeigt Werkzeuge Registerkarte dieses Skripts.
Zusätzlich zu diesen Hauptskripttypen bietet Studio einige Skriptvorlagen an, die von den Funktionen und Anwendungen abhängen, die Sie mit Ihrem System aktiviert haben, wie z. B. das Skript Anrufunterdrückung im Zusammenhang mit Personal Connection. Wenn Sie Zugriff auf diese Vorlagen haben, können Sie im Abschnitt Verfügbare Vorlagen des Dialogfelds Neues Skript erstellen auf sie zugreifen.

In diesem Skript zählt das System die Anzahl der verfügbaren Agenten. Wenn die Anzahl Null ist, wird eine Nachricht abgespielt und das System trennt den Anruf. Wenn die Anzahl der verfügbaren Agenten größer als Null ist, wird ein IVRSprachdialogsystem; ein automatisiertes Telefonmenü, mit dem die Anrufer über Sprachbefehle und Tasteneingaben oder beides für die entsprechende Weiterleitung des Anrufs kommunizieren können. Menü bietet dem Anrufer die Möglichkeit, eine Verbindung zu einem Agenten herzustellen. Bis ein Agent das Gespräch annimmt, wird in einem Abstand von 30 Sekunden Musik abgespielt. Auch hier können die meisten dieser Aktionen in jedem Skripttyp verwendet werden, jedoch gilt die Aktion Hangup speziell für Telefonskripte.

Konnektoren und Verzweigungen
Konnektoren
Ein Konnektor ist eine individuelle Verbindung zwischen zwei Aktionen. Es wird ein Pfeil angezeigt, der die mögliche Bewegung eines Kontakts von einer Aktion zur, und die Bedingung für einen Kontakt bestimmt, der diesem Anschluss folgt. Sie können zwei Aktionen verbinden, indem Sie in die untere rechte Ecke der Aktion klicken und den Konnector auf die nächste Aktion im Flow ziehen und dort ablegen. Um Ihr Skript sauber und übersichtlich zu halten, können Sie die Konnektoren durch Drücken und Halten von STRG und UMSCHALTTASTE auf der Tastatur biegen, bewegen Sie den Mauszeiger auf Ihrer Tastatur über den Anschluss, sodass dieser blau wird. Klicken Sie mit der rechten Maustaste auf den Anschluss, um eine grüne Box (die ein Drehpunkt ist) zu platzieren. Klicken Sie dann mit der linken Maustaste auf die grüne Box und manövrieren Sie den Anschluss wie gewünscht. Sie können mehrere Drehpunkte entlang eines einzelnen Anschlusses platzieren, um noch mehr benutzerdefinierte Manöver durchzuführen.
Verzweigungen
Ein Zweig ist ein Pfad, der ein Skript in eine oder mehrere Unterteilungen unterteilt, die mit einem einzelnen Konnektor beginnen. Viele Aktionen enthalten Standardverzweigungen, die Sie konfigurieren können, z. B. Default oder OnError, Sie können jedoch auch benutzerdefinierte Verzweigungsbedingungen (als variable Verzweigungsbedingungen bezeichnet) erstellen, wenn das PickBranch-Fenster angezeigt wird, wenn zwei Aktionen verbunden werden. Das vorstehende Bild ist ein einfaches Beispiel für drei Zweige und Konnektoren: Info, Rechnungsstellung und technischer Support. Die ersten Anschlüsse jedes Zweiges sind beschriftet und enthalten auch die drei Menüoptionen. Viele Skripte sind viel komplexer als im Beispiel mit ausgefeilteren Zweigen gezeigt. Wenn Zweige zu komplex und umfangreich werden, um intuitiv auf eine Zeichenfläche zu passen, kann der Scripter Zweige in einzelne Subskripte unterteilen und dann mit a auf die Subskripte aus dem Hauptskript verweisen Runsub oder Skript ausführen Aktion. Dies ist eine hervorragende Möglichkeit, Ihre Skripte organisiert und aufgeräumt zu halten, anstatt groß, überladen und verwirrend.
In den folgenden Skriptbildern sehen Sie beispielsweise, dass das Yggdrasil-Menü 8 Optionen für die 8 anderen nordischen Welten bietet, wobei jede Welt eine andere Verzweigung des Skripts darstellt. Wenn Heimdallr, Scripter für die Asgard-Hotline, mehr Optionen für jeden Zweig einschließen wollte, die dieses einzelne Skript übermäßig komplex machen würden, könnte er ein separates Unterskript für jede der 8 anderen Welten erstellen. Danach würde Heimdallr a verwenden Runsub oder Skript ausführenAktion für jede Menüoption, die das separate Skript startet / referenziert, wenn es vom Kontakt ausgewählt wird.

Komplex:

Kondensiert:

Skript-APIs
Für fortgeschrittenere Skriptentwickler können Sie Skripte programmgesteuert öffnen und speichern, um automatisierte Entwicklungsprozesse zu unterstützen. Erweitern Sie die folgenden Dropdown-Listen, um grundlegende Details für jede API anzuzeigen.

Verwenden Sie v17 oder früher von GET/Skripten, um eine Liste der Skripte für Ihre
Zusammenfassung: Das XML eines Skripts nach Name oder Master-ID zurückgeben.
Beschreibung: Diese Methode gibt XML eines Skripts nach Name oder Master-ID zurück.
Parameter:
- Name: scriptPath
in: path
description: full path of script
required: true
style: simple
explode: false
schema:
type: string
- Name: scriptId
in: path
Beschreibung: Master-ID eines Skripts
required: true
style: simple
explode: false
schema:
type: integer
Responses:
'200':
description: SUCCESS
content:
application/json:
schema:
type: object
properties:
name:
type: string
Beschreibung: Name eines Skripts
Dateipfad:
type: string
Beschreibung: Dateipfad
ScriptId:
type: integer
Beschreibung: MasterId
Körper:
type: string
Beschreibung: XML eines Skripts
'400': Beschreibung: Ungültige Parameter
'404': Beschreibung: Nicht gefunden
'500': Beschreibung: Interner Fehler
'501': Beschreibung: Interner Fehler des Incontrol.Net-Dienstes

Zusammenfassung: Speichern Sie ein neues Skript oder ein vorhandenes Skript.
Beschreibung: Diese Methode speichert ein Skript mithilfe einer base64-Zeichenfolge in der Datenbank.
Parameter:
- Name: scriptPath
in: path
Beschreibung: vollständiger Pfad und Name des Skripts
required: true
style: simple
explode: false
schema:
type: string
- Name: Körper
in: path
Beschreibung: 'Hauptteil des Skripts, dies ist ein in base64 codiertes XML'
required: true
style: simple
explode: false
schema:
type: string
Responses:
'200':
Beschreibung: Erfolg
content:
application/json:
schema:
SaveScript:
type: object
properties:
ScriptId:
type: string
Beschreibung: Die neue ScriptId, die nach dem erfolgreichen Speichern generiert wurde
'400': Beschreibung: Ungültige Parameter
'405': Beschreibung: Von jemand anderem gesperrt
'500': Beschreibung: Interner Fehler
'501': Beschreibung: Service Internal Error

Zusammenfassung: Speichern Sie ein neues Skript oder ein vorhandenes Skript.
Beschreibung: Diese Methode speichert ein Skript mithilfe einer base64-Zeichenfolge in der Datenbank.
Parameter:
- Name: scriptPath
in: path
Beschreibung: vollständiger Pfad und Name des Skripts
required: true
style: simple
explode: false
schema:
type: string
- Name: Körper
in: path
Beschreibung: 'Hauptteil des Skripts, dies ist ein in base64 codiertes XML'
required: true
style: simple
explode: false
schema:
type: string
Responses:
'200':
Beschreibung: Erfolg
content:
application/json:
schema:
type: object
properties:
ScriptId:
type: string
Beschreibung: Die neue ScriptId, die nach dem erfolgreichen Speichern generiert wurde
'400': Beschreibung: Ungültige Parameter
'405': Beschreibung: Von jemand anderem gesperrt
'500': Beschreibung: Interner Fehler
'501': Beschreibung: Service Internal Error

Zusammenfassung: Kick ein gesperrtes Skript.
Beschreibung: Diese Methode erzwingt das Entsperren eines Skripts.
Parameter:
- Name: scriptPath
in: path
description: full path of script
required: true
style: simple
explode: false
schema:
type: string
Responses:
'200': Beschreibung: Erfolg
type: object
properties:
type: string
Beschreibung: Anforderungsdatum
Fehlermeldung:
type: string
Beschreibung: Fehlermeldung vom Dienst
ErrorState:
Typ: Boolescher Wert
Beschreibung: Fehlerstatus
KickResult:
type: string
Beschreibung: Ergebnis des Dienstes
Master-ID:
type: integer
Beschreibung: Master ID des Skripts
CurrLockedBy:
type: integer
Beschreibung: ID des getretenen Benutzers
'400': Beschreibung: Ungültige Parameter, Skript bereits freigeschaltet, Sie können sich nicht aus dem Skript entfernen
'404': Beschreibung: ScriptNotFound
'500': Beschreibung: Interner Fehler
'501': Beschreibung: Service Internal Error

Zusammenfassung: Gibt einen Verlauf eines Skripts zurück.
Beschreibung: Diese Methode gibt den Verlauf eines Skripts nach Namen zurück.
Parameter:
- Name: scriptPath
in: path
description: full path of script
required: true
style: simple
explode: false
schema:
type: string
Responses:
'200':
description: SUCCESS
content:
application/json:
schema:
HistoryScripts:
type: object
properties:
name:
type: string
Beschreibung: vollständiger Pfad eines Skripts, das mit dem Namen verknüpft ist
versions:
type: array
Items:
HistoryScripts_versions:
type: object
properties:
scriptId:
type: integer
description: Master ID of script
modifyDate:
type: string
description: Modify date
modifyUser:
type: string
description: Modify user
Status:
type: string
Beschreibung: Status eines Skripts
'400': Beschreibung: Ungültige Parameter
'404': Beschreibung: Nicht gefunden
'500': Beschreibung: Interner Fehler
'501': Beschreibung: Interner Fehler des Incontrol.Net-Dienstes

get:
Tags:
Zusammenfassung: Sucht ein Skript
Beschreibung: Diese Methode sucht anhand von Schlüsselwörtern nach einem Skript in der Business Unit.
Parameter:
name: mediaType
in: query
Beschreibung: Medientyp des Skripts.
required: false
explode: false
schema:
type: integer
name: scriptName
in: path
Beschreibung: Schlüsselwort für die Suche
required: true
style: simple
explode: false
schema:
type: string
name: includeInactive
in: query
Beschreibung: Diese Variable wird verwendet, um die Suche in die inaktiven Skripte aufzunehmen.
required: false
explode: false
schema:
Typ: Boolescher Wert
name: includeTrusted
in: query
Beschreibung: Diese Variable wird verwendet, um die Suche zwischen vertrauenswürdigen Business Units einzuschließen
required: false
explode: false
schema:
type: string
name: modEndDate
in: query
Beschreibung: Diese Variable wird verwendet, um die Suche in einem festgelegtem Datumsbereich aufzunehmen
required: false
explode: false
schema:
type: string
Responses:
'200':
description: SUCCESS
content:
application/json:
schema:
$ref: '#/components/schemasSearchScript'
'400':
Beschreibung: Ungültige Parameter
'401':
Beschreibung: Nicht autorisiert. Sie haben nicht genügend Berechtigungen
'404':
Beschreibung: Skriptpfad nicht gefunden
'500':
Beschreibung: Interner Fehler
'501':
Beschreibung: Interner Fehler des Incontrol.Net-Dienstes
Komponenten:
schemas:
GetScript:
type: object
properties:
name:
type: string
Beschreibung: 'Name eines Skripts'
Dateipfad:
type: string
Beschreibung: 'Vollständiger Skriptpfad'
scriptId:
type: integer
Beschreibung: 'Dies ist die Skriptkennung, sie ist eindeutig'
Körper:
type: string
Beschreibung: 'Skriptinhalt im Base63-Format codiert'
DeleteScript:
type: object
properties:
scriptPath:
type: string
Beschreibung: 'Informationen zum vollständigen Pfad-Skriptnamen, der entfernt wurde'
deleted:
Typ: Boolescher Wert
Beschreibung: 'Status eines Skripts'
error:
type: string
Beschreibung: 'Wenn beim Löschvorgang ein Fehler auftritt'
SearchScript:
type: object
properties:
type: integer
Beschreibung: 'Der Name der Business Unit'
scriptName:
type: string
Beschreibung: 'Vollständiger Skriptpfad'
scriptSearchDetails:
type: array
Beschreibung: 'Detail des Suchergebnisses'
items:
$ref: '#/components/schemas/SearchScript_Details'
SearchScript_Details:
type: object
properties:
busNo:
type: integer
Beschreibung: 'Nummer der Business Unit'
masterID:
type: string
Beschreibung: 'Skriptkennung'
scriptName:
type: string
Beschreibung: 'Name eines Skripts'
status:
type: string
Beschreibung: 'Status eines Skripts aktiv/inaktiv'
mediaType:
type: integer
Beschreibung: 'Medientypnummer'
modifyDate:
type: string
Beschreibung: 'Das Datum der letzten Änderung
mUser:
type: integer
Beschreibung: 'Der letzte Benutzer, der das Skript geändert hat'
actionID:
type: integer
Beschreibung: 'Skriptkennung'
Tipps und Tricks zum Schreiben von Skripten
- Das Umbenennen der Beschriftung in einer Aktion kann das Lesen und Befolgen Ihres Skripts erheblich vereinfachen. Bearbeiten Sie die Beschriftung einer Aktion in der Eigenschaften Dialog.
- Beim Benutzen Speisekarte (oder eine ähnliche Aktion), erstellen Sie einen Zweig, um die Menüoptionen mit zu wiederholen Schleife und Keine Antwort Aktionen, die sich wieder mit dem verbinden Speisekarte Aktion.
-
Füge hinzu ein Warten Aktion nach a Musik Aktion zum Wiedergeben der Musik (andernfalls wird das Audio 30 Sekunden lang abgespielt und endet dann).
- Stellen Sie sicher, dass Sie keine Sackgasse haben. Sackgassen können Probleme wie fehlende Zweige in einem Menü, nicht konfigurierte Menüzweige oder (wie im vorhergehenden Punkt) Nr Warten Aktion nach a Musik Aktion.
- Wenn Sie ein Menü erstellen, ist es am besten, zuerst die Abteilung und dann die zu wählende / zu sprechende Nummer zu benennen. Bei Kontakten wird zuerst der Name der Abteilung und dann erst die Nummer genannt.
- Verwenden Sie die Anmerkung Aktion zum Hinzufügen von Notizen oder Anweisungen in einem Skript.
- Verwenden Sie den Namen des Skripts für die Start Aktionsbeschriftung.
- Zum abspielen und Speisekarte Aktionen, doppelklicken Sie auf die Aktion und kommentieren Sie die Aussprache der Eingabeaufforderung in der Phrase Feld.
- Zeigen Sie den Verlauf eines Skripts an, indem Sie mit der rechten Maustaste auf das Skript auf der Registerkarte Durchsuchen klicken (Anzeigen > Browser) und mit dem Mauszeiger über die Option Verlauf fahren. Auf diese Weise können Sie frühere Iterationen eines Skripts anzeigen.