AGENT LIST

Gibt alle der Geschäftseinheit Übergeordnete organisatorische Gruppierung zur Verwaltung des technischen Supports, der Abrechnung und der globalen Einstellungen für Ihr CXone Mpower-System. zugewiesenen Agenten zurück, es sei denn, sie befinden sich in einem Array, das die Profilinformationen der einzelnen Agenten enthält. Kann Informationen zu einem bestimmten Agenten zurückgeben, indem in der Eigenschaft AgentID eine Agenten-ID eingegeben wird. Die folgenden Felder werden in der im Parameter ListVar angegebenen Variable zurückgegeben: • BusinessUnitID • UserName • MiddleName • Email • TeamId • ReportToId • ReportToMiddleName • IsSupervisor • LastModified • Custom1 • Custom3 • Custom5 • AgentID • FirstName • LastName • IsActive • TeamName • ReportToFirstName • ReportToLastName • LastLogin • Location • Custom2 • Custom4 • InternalId Mit dieser Aktion kann geprüft werden, ob ein spezifischer Agent aktiv ist, die E-Mail-Adresse des Agenten gefunden oder geprüft werden, welchem Team sie angehören sowie eine Reihe anderer benutzerdefinierter Optionen. Die Agentenliste ist eine der verfügbaren APIs, die Sie in Studio verwenden können. Es müssen Framework-Aktionen und Berechtigungen für Ihre Business  Unit aktiviert sein, um diese Aktion nutzen zu können.

ABHÄNGIGKEITEN

• Stellen Sie immer sicher, dass die SetSecurityUser-Aktion vor dieser Aktion steht und dass die Ausgabevariable dieser Aktion der SecurityUser-Eingabevariablen in den Eigenschaften der Agent List-Aktion entspricht.

• Dies ist eine API-Aktion, die sich in der API-Aktionspalette befindet.

Unterstützte Skripttypen

Allgemein	E-Mail	Chat	Telefon	Voicemail	Arbeitselement	SMS

Eingabeeigenschaften

Diese Eigenschaften definieren Daten, die von der Aktion bei der Ausführung verwendet werden.

Eigenschaft	Beschreibung
Add Caption	Geben Sie eine kurze Phrase ein, mit der diese Aktion im Skript eindeutig identifiziert wird. Die Beschriftung wird im Skript-Arbeitsbereich unter dem Symbol der Aktion angezeigt.
Sicherheitsbenutzer	Der Ausgabewert der SetSecurityUser-Aktion, die einen ausgewählten Agenten auf der Basis dessen API-Berechtigungen im Sicherheitsprofil authentifiziert. Dieses Feld akzeptiert Variablen, die mit geschweiften Klammern ( { } ) formatiert sind. Der Standardwert ist SecurityUser (derselbe standardmäßige Ausgabewert wie bei SetSecurityUser).
Agenten-ID	Die Agenten-ID. Sie können für dieses Feld eine Variable verwenden, wie beispielsweise {agentId}. Wenn dieses Feld leer ist, werden alle Benutzer, die zum Mandant Übergeordnete organisatorische Gruppierung zur Verwaltung des technischen Supports, der Abrechnung und der globalen Einstellungen für Ihr CXone Mpower-System. gehören, in einem Array zurückgegeben. Im Wertmodus: Geben Sie die Agenten-ID ein oder klicken Sie auf die Plus- oder Minus-Schaltflächen (+ oder -), um eine ID-Nummer hinzuzufügen. Im Ausdrucksmodus: Geben Sie die Agenten-ID ein.

Ausgabeeigenschaften

Diese Eigenschaften enthalten Variablen mit Daten, die bei der Ausführung der Aktion zurückgegeben werden. Sie stehen zu Referenzzwecken und zur Verwendung nach Abschluss der Aktion zur Verfügung.

Eigenschaft	Beschreibung
ListVar	Enthält die zurückgegebenen Daten. Die Inhalte dieser Variable werden als Array gespeichert. Der Standardwert ist Agents, er kann jedoch in einen beliebigen Wert geändert werden.

Bedingungen für Ergebnisverzweigungen

Mit Bedingungen für Ergebnisverzweigungen können Sie in Ihrem Skript Verzweigungen erstellen, die für unterschiedliche Ergebnisse bei der Ausführung einer Aktion vorgesehen sind.

Bedingung	Beschreibung
Default	Genommener Pfad, außer das Skript erfüllt eine Bedingung, die es erfordert, einer der anderen Verzweigungen zu folgen. Dieser Pfad wird auch genommen, wenn die anderen Verzweigungen der Aktion nicht definiert sind.
Erfolg	Verwendeter Pfad, wenn die Aktion ohne Fehler abgeschlossen wurde und alle API-Aufrufe oder Datenrückgaben erfolgreich waren (2xx Antwortcodes).
InvalidAgentId	Genommener Pfad, wenn die Agenten-ID ungültig ist.
InvalidSecurityUser	Genommener Pfad, wenn ein ungültiger Sicherheitsbenutzer verwendet wird.

Andere Optionen

Je nach den Daten, die Sie erhalten möchten, sind möglicherweise noch weitere API-Aktionen hilfreich. Beispiele sind All Agent Skill Assignments, Agent States V4, Get Agents List und Get Agent Details by Agent ID.