AGENT LIST

Retourne tous les agents affectés à l’unité commerciale Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone., sauf s’ils se trouvent dans un tableau contenant les informations de profil de chaque agent. Peut renvoyer des informations sur un agent spécifique en entrant un ID d'agent dans la propriété AgentID. Les champs suivants sont renvoyés dans la variable spécifiée dans le paramètre ListVar : • BusinessUnitID • UserName • MiddleName • Email • TeamId • ReportToId • ReportToMiddleName • IsSupervisor • LastModified • Custom1 • Custom3 • Custom5 • AgentID • FirstName • LastName • IsActive • TeamName • ReportToFirstName • ReportToLastName • LastLogin • Location • Custom2 • Custom4 • InternalId Vous pouvez utiliser cette action pour vérifier si un agent spécifique est actif, trouver l’adresse courriel de l’agent, vérifier à quelle équipe ils appartiennent ou un grand nombre d’autres options personnalisées. La Liste Agent est l’une des API disponibles que vous pouvez l’utiliser dans Studio. Vous devez avoir les actions et les autorisations Framework activées sur votre unité commerciale pour tirer parti de cette action.

Dépendances

• Assurez-vous toujours que l’action SetSecurityUser précède cette action et que la variable de sortie de cette action correspond à la variable d’entrée SecurityUser des propriétés de l’action Agent List.

• Il s'agit d'une action API, située sur la palette Actions API.

Types de scripts pris en charge

Générique	courriel	Clavardage	Téléphone	Messagerie vocale	Élément de travail	SMS

Propriétés d’entrée

Ces propriétés définissent les données que l’action utilise lors de son exécution.

Propriété	Description
Ajouter une légende	Entrez une courte phrase qui identifie de façon unique cette action dans le script. La légende apparaît sur le canevas du script sous l’icône de l’action.
Utilisateur de sécurité	La valeur de sortie de l'action SetSecurityUser qui authentifie un Agent sélectionné en fonction de ses autorisations dans le profil de sécurité. La valeur par défaut est SecurityUser (même valeur de Sortie par défaut que SetSecurityUser). Vous n'avez pas besoin d'utiliser d'accolades ( {} ) avec cette propriété.
ID de l’agent	L’id de l’agent. Entrée un ID ou un type pour trouver un agent en particulier. Vous pouvez utiliser une Variable pour ce champ, comme {agentId}. S’il est vide, tous les utilisateurs associés au locataire Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone. sont renvoyés dans un tableau. En mode valeur : Saisissez l’ID de l’agent ou cliquez sur les boutons plus + ou moins - pour ajouter un numéro d’ID. En mode expression : Saisissez l’ID de l’agent.

Propriétés de sortie

Ces propriétés contiennent des variables qui conservent les données renvoyées par l'exécution de l'Action. Elles sont disponibles à des fins de référence et d'utilisation lorsque l'Action est terminée.

Propriété	Description
ListVar	Contient les données renvoyées. Le contenu de cette variable est stocké sous forme de tableau. La valeur par défaut est Agents, mais elle peut être modifiée à n’importe quelle valeur.

Conditions de la branche de résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l’exécution d’une action.

Condition	Description
Default	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
Réussite	Chemin emprunté si l’action se termine sans erreur et si les appels à l’API ou les retours de données ont été un succès (codes de réponse 2xx).
InvalidAgentId	Chemin emprunté si l'ID d'agent n'est pas valide.
InvalidSecurityUser	Chemin emprunté en cas d’utilisation d’un utilisateur de sécurité non valide.

Autres options

En fonction des données que vous souhaitez obtenir, d’autres actions API peuvent s’avérer utiles. Par exemple, All Agent Skill Assignments, Agent States V4, Get Agents List, Get Agent Details by Agent ID, etc.