Agent List

Devuelve todos los agentes asignados a la unidad de negocio (a menos que se ingrese en las propiedades un ID de agente específico) en un arreglo que contiene la información del perfil de cada agente en que se devuelven los siguientes campos en la variable que se especifica en el parámetro 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 Esta acción se puede usar para comprobar si está activo un agente específico, busque la dirección de correo electrónico del agente, compruebe qué equipo pertenecen, o una variedad de otras opciones personalizadas. Lista de agentes es una de las APIs disponibles que puede utilizar dentro de Studio. Debe tener acciones marco y permisos habilitados en su unidad de negocio con el fin de aprovechar esta acción.

Dependencias

• Verifique siempre que la acción SetSecurityUser preceda a esta acción y que la variable de salida de dicha acción coincida con la SecurityUser variable de entrada de las Agent List propiedades de la acción.

• Esta acción se ubica en la paleta de Acciones de la API.

Tipos de scripts compatibles

Genérico	Correo electrónico	Conversación	Teléfono	Correo de voz	Elemento de trabajo	SMS

Propiedades de entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Las propiedad	Descripción
Add Caption	Ingrese una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción.
Usuario de seguridad	El valor de salida de la acción SetSecurityUser que autentica a un agente seleccionado en función de sus permisos en el perfil de seguridad. Este campo acepta variables con formatos con llaves ( { } ). El valor predeterminado es SecurityUser (mismo valor de salida predeterminado de SetSecurityUser).
Id de agente	El ID del agente. Puede utilizar una variable para este campo, como {agentId}. Cuando está en blanco, se devuelven en un arreglo todos los usuarios asociados con abonado Agrupación organizativa de alto nivel utilizado para administrar el soporte técnico, facturación y configuración global para su CXone Mpower entorno de . En modo valor: Ingrese el ID del agente o haga clic en los botones más + o menos - para agregar un número de ID. En Modo de Expresiones: Ingrese el ID del agente.

Propiedades de salida

Estas propiedades contienen variables que incluyen datos que se evuelven al ejecutar la acción. Están disponibles como referencia y para usarse cuando se completa la acción.

Las propiedad	Descripción
ListVar	Mantiene los datos devueltos. El contenido de esta variable se almacenan como una matriz. La variable predeterminada es Agents, pero puede modificarse a cualquier valor deseado.

Condiciones de la rama de resultados

Las condiciones de las ramas de resultados le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecute una acción.

Condición	Descripción
Default	Recorrido a menos que el script cumple una condición que requiere uno de los otros poderes. También se considera si no están definidas las demás ramas de la acción.
Éxito	Ruta que se toma si la acción finaliza sin errores y cualquier llamada API o devolución de datos se realiza correctamente (códigos de respuesta 2xx).
InvalidAgentId	Ruta tomada si el ID del agente no es válido.
InvalidSecurityUser	Ruta adoptada cuando se utiliza un usuario de seguridad no válido.

Otras opciones

Dependiendo de los datos que desee obtener, pueden resultar útiles las acciones API adicionales. Por ejemplo, All Agent Skill Assignments, Agent States V4, Get Agents List, Get Agent Details by Agent ID, etc.