AgentList

This help page is for Desktop Studio. This information is also available for CXone Studio.

Gibt alle der Geschäftseinheit zugeordneten Agenten zurück (es sei denn, eine bestimmte Agenten-ID wird in die Eigenschaften eingegeben). Die Agenten werden in einem Array zurückgegeben, das ihre Profilinformationen enthält. Dabei werden die folgenden Felder in der Variablen zurückgegeben, die im Parameter ListVar festgelegt wurde:

• 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 SetSecurityUseraction- vor dieser Aktion steht und dass die Ausgabevariable dieser Aktion der SecurityUser-Eingabevariablen in den Eigenschaften der Agent List-Aktion entspricht.

Unterstützte Skripttypen

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

Allgemein

E-Mail-Adresse Chat Telefon Voicemail Arbeitselement SMS

Eingabeeigenschaften

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

Eigenschaft

Beschreibung

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. The default is the action name.

SecurityUser Der Ausgabewert der SetSecurityUser-Aktion, die einen ausgewählten Agenten auf der Basis dessen API-Berechtigungen im Sicherheitsprofil authentifiziert. Dieses Feld akzeptiert eine Variable, die mit geschweiften Klammern ( { } ) formatiert ist. Der Standardwert ist SecurityUser (derselbe standardmäßige Ausgabewert wie bei SetSecurityUser).
AgentID Die Agenten-ID. Sie können für dieses Feld eine Variable verwenden, wie beispielsweise {agentId}. Wenn leer, werden alle der Busines Unit zugeordneten Benutzer in einem Array zurückgegeben. Dieses Feld akzeptiert Variablen.

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 (out) Enthält die zurückgegebenen Daten. Die Inhalte dieser Variable werden als Array gespeichert. Die Standardvariable ist Agents.

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.

OnError

Genommener Pfad, wenn die Aktion nicht ordnungsgemäß ausgeführt werden kann. Beispiel: Wenn ein unerwartetes Problem auftritt, wie eine schlechte Verbindung oder Syntaxfehler. Die Variable _ERR, mit einem einzelnen Unterstrich, sollte mit einer kurzen Erläuterung des Problems ausgefüllt werden.

Andere Optionen

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