Módulo de exportación de agentes

De un vistazo

Categoría: relacionada con los agentes

Tipo de archivo de exportación: XML

Convención de nomenclatura de archivos:exportAgent_mmddyy_hhmm.xml

Esta exportación contiene campos de visualización con Definiciones de agentes. Suele usarse con integraciones de terceros e incluye ACD con los detalles de inicio de sesión.

Datos clave sobre esta exportación

  • La información del agente se exporta para cada agente que pertenezca a la unidad de gestión especificada en la fecha en que se ejecuta la exportación. Contiene datos para cada fecha del rango en que se configuró la exportación.
  • El archivo de salida puede configurarse para que contenga datos sobre agentes nuevos o sobre agentes modificados, pero no ambos en el mismo archivo de salida. El valor predeterminado es datos de agentes nuevos.
  • La exportación puede configurarse para que solo incluya a los agentes en función de las horas de modificación de registros de la base de datos.
  • Para que un agente quede incluido como registro de agente nuevo:
    • Todos los registros de las diversas tablas utilizados para crear un registro de agente nuevo deben tener una hora de modificación mayor o igual que la hora de modificación configurada (+/- 10 segundos), O BIEN
    • La fecha/hora de inicio de la asignación ACD debe ser mayor que la hora de modificación configurada.
  • Para que un agente quede incluido en el registro como agente modificado, cualquiera de los registros de las diversas tablas utilizados para crear un registro de agentes modificados debe tener una hora de modificación mayor o igual que la hora de modificación configurada.

Archivo de salida: campos y descripciones

Durante su contratación de Servicios Profesionales, puede elegir cuál de los siguientes campos incluir en su exportación. Asegúrese de incluir cada campo que pueda llegar a necesitar; si desea agregar campos después de configurada la exportación, necesitará enviar una solicitud de modificación. Si no selecciona campos específicos, su exportación incluirá todos los campos aquí descritos.

Campo Descripción Valores
id

Incluya este elemento para elementos changedAgent.

Omita este elemento para elementos newAgent.

El valor del campo exportado depende del atributo idType del elemento ID.

idType puede ser:

  • tvID o [no especificado]: ID de IEX WFM Integrated del agente
  • ssn: Número de identificación personal del agente
  • acdLogon: atributo Inicie sesión para el agente vinculado con la acdID de este elemento. El elemento queda en blanco si el agente no tiene un acdLogonID asignado.
nombre

Usted debe incluir este campo para los elementos newAgent.

El nombre del agente se exporta como tres elementos: firstName, lastName y nameSuffix.

Puede incluir este campo para los elementos changedAgent. Si lo usa, debe especificar el nombre o el elemento lastName (apellido) para generar los nombres de agentes. Los elementos firstName y nameSuffix son opcionales cuando se usan con el elemento lastName.

 
UUID

ID de usuario unificada del agente

 
mu

Usted debe incluir este campo para los elementos newAgent. Esta es la ID de la unidad de gestión para la que se está ejecutando la exportación.

 
acdList

Incluye un elemento secundario acdStartDate y un elemento secundario acd.

 
acdStartDate

La fecha en que se ejecuta la exportación.

 
acd

Contiene una acdID secundaria, un inicio de sesión secundario y un agentGroup secundario.

 

acdID

ID del servidor ACD o multimedia de CXone Mpower en la fecha especificada.

 

logon Inicie sesión para el agente vinculado con la acdID

Cuando la exportación se ejecuta, este campo queda en blanco si el agente no tiene una ID de inicio de sesión o no está asignado al CXone Mpower ACD.

logonType Tipo de inicio de sesión. Este elemento se usa para sincronizar a los agentes entre los productos de CXone Mpower.  
agentGroup

ID del grupo de agentes al que está asignado el agente.

 

startID

ID de IEX WFM Integrated del agente

No incluido para los elementos changedAgent.

 
ssn

Número de identificación personal del agente

Este campo queda vacío si el agente no tiene un número de identificación asignado o disponible.

agentStartDate

Fecha de inicio del registro AgentMap activo más antiguo del agente. Es el registro con la fecha s_date más antigua. Contiene el día, el mes y el año secundarios.

No incluido para los elementos changedAgent.

 
externalID Si su empresa ha configurado Agent WebStation para que use ID externas, el valor es esa ID para este agente. Si el campo externalID del agente queda en blanco, este campo también queda vacío.
senDate

Fecha de antigüedad del agente. Contiene el día, el mes y el año secundarios.

 

senExt

Extensión de antigüedad del agente.

 

rank

Clasificación del agente.

 
supervisor

ID de inicio de sesión para el supervisor del agente.

Este campo está vacío.

password

Contraseña del agente para Web Station.

Este campo está vacío.

minCDO Mínimo de días libres consecutivos del agente  
maxCDO Máximo de días libres consecutivos del agente  
minCDW Mínimo de días de trabajo consecutivos del agente  
maxCDW Mínimo de días de trabajo consecutivos del agente  
minTimeBetweenScheds Cantidad mínima de minutos necesaria entre las programaciones del agente.  
minRestPerWeek Periodo de descanso mínimo del agente por semana.  
availDateRange

Rango de fechas del registro de disponibilidad del agente. Contiene día, mes y año secundario, y una semanas secundaria. El rango de fechas que se indica aquí es también el rango de fechas para:

  • minCDO
  • maxCDO
  • minCDW
  • maxCDW
  • minTimeBetweenScheds
  • minRestPerWeek
  • availDateRange
  • forceWork
  • workStatus
  • tourGroup
  • rotationNum
  • minMinutes
  • maxMinutes
Si se exporta el registro de disponibilidad por defecto del agente, este campo queda en blanco.
startDate Fecha de inicio de los parámetros de programación.  
endDate Fecha de finalización de los parámetros de programación.  
default Registro de parámetros de programación predeterminados.  
forceWork Configuración de trabajo de fuerza del agente. S o N
workStatus Si el agente trabaja jornada completa o media jornada F o P
tourGroup Regla semanal del agente.  
rotationNum Número de rotación de la regla semanal del agente.  
minMinutes Minutos mínimos por semana del agente.  
maxMinutes Minutos máximos por semana del agente.  
useAvailability Si la matriz de disponibilidad se usó para el agente. Este campo siempre está como S.
availListDateRange Rango de fechas de cada availabilityList. Contiene un elemento vacío <por defecto/> o un elemento <startDate> y otro <endDate>.  
availabilityList Contiene siete elementos secundarios de disponibilidad, uno para cada día de la semana y en orden, comenzando por el domingo.  
availability Indica si el agente está disponible para cada periodo de 15 minutos del día que se está exportando. A o N
availabilityListStatus Si la lista de disponibilidad se ha aprobado, rechazado o está pendiente de aprobación.  
skillSet Contiene una skillStartDate secundaria, un baseScheduleCode secundario y cero habilidades secundarias o más. Hay una habilidad secundaria incluida para cada habilidad asignada al agente en la fecha que se está exportando.  
skillStartDate La fecha que se está exportando.  
baseScheduleCode Código básico de programación para la fecha que se está exportando. Contiene la descripción del código de actividad.  
skillName Nombre de la habilidad.  
level Nivel asignado al agente para la habilidad.  
rsv Configuración de indicador de reserva del agente para la habilidad.  
agentData

Se incluye en el archivo de salida si:

  • Solicita uno o más elementos agentData válidos. En este caso, en el archivo de salida solo se incluyen los grupos de datos de agentes especificados.
  • Se solicitan todos los grupos de datos de agentes y se define al menos un grupo de datos de agentes.
 
grupo Contiene una descripción secundaria y un valor secundario. Si existe un elemento agentData en el archivo de Configuración avanzada pero en el sistema no hay ningún grupo de datos de agentes con la descripción indicada, no se exportan valores para este elemento.  
adgStartDate Fecha de inicio del valor asignado al agente para el grupo. Contiene el día, el mes y el año secundarios.  
descripción Descripción del grupo de datos de agentes especificada en el elemento agentData del archivo de Configuración avanzada.  
valor Valor asignado al agente para el grupo de datos de agentes especificado en el elemento agentData del archivo de Configuración avanzada. Este campo queda en blanco si el agente no tiene un valor asignado.
emailList Contiene un correo electrónico secundario por cada registro presente en la tabla de direcciones de correo electrónico.  
correo electrónico Dirección de correo electrónico.  
number Número de la dirección de correo electrónico. 1-10
tipo Tipo de correo electrónico

N: normal

S: corto

language Cadena de cinco caracteres que identifica el idioma y la región para el formato de los mensajes.  
vacationGroup

ID del grupo de tiempo libre al que está asignado el agente en la fecha en que se está procesando.

No incluido para los elementos changedAgent.

 
biddingDate

Fecha de antigüedad alternativa del agente. Contiene el día, el mes y el año secundarios.

 
biddingExt

Extensión de antigüedad alternativa del agente.

 
accrualDate Fecha de incorporación del agente. Contiene el día, el mes y el año secundarios.  
daysVacWeek Cantidad de días que componen una semana de vacaciones para este agente.  
vacDayLengthList Contiene siete elementos vacDayLength secundarios, uno para cada día de la semana comenzando por el domingo.  
recid Contador que comienza en 1 y aumenta con cada elemento newAgent o changedAgent exportado.  

Archivo de salida: muestra

 <?xml version=”1.0”?> <agentList> <changedAgent> <id>12345</id> <name>Sarlay, John</name> <acdList> <acd><acdID>25</acdID><logon>john.sarlay@abc.com</logon><agentGroup>125</agentGroup></acd> <acd><acdID>999</acdID><logon>12345</logon><agentGroup></agentGroup></acd> </acdList> <skillSet> <skill> <skillName>Sales</skillName> <level>1</level> <rsv>N</rsv> </skill> <skill> <skillName>Service</skillName> <level>2</level> <rsv>N</rsv> </skill> <skill> <skillName>Tech Support</skillName> <level>2</level> <rsv>Y</rsv> </skill> </skillSet> <agentData> <group><description>Team Ldr</description><value>Mike Shaw</value></group> <group><description>Birthday</description><value>19700419</value></group> </agentData> </changedAgent> <changedAgent> <id>67890</id> <name>Barni, Meghan</name> <acdList> <acd><acdID>25</acdID><logon>meghan.barni@abc.com</logon><agentGroup></agentGroup></acd> <acd><acdID>999</acdID><logon></logon><agentGroup></agentGroup></acd> </acdList> <skillSet> <skill> <skillName>Sales</skillName> <level>3</level> <rsv>Y</rsv> </skill> <skill> <skillName>Service</skillName> <level>2</level> <rsv>N</rsv> </skill> <skill> <skillName>Tech Support</skillName> <level>1</level> <rsv>N</rsv> </skill> </skillSet> <agentData> <group><description>Team Ldr</description><value>Mike Shaw</value></group> <group><description>Birthday</description><value>19710317</value></group> </agentData> </changedAgent> </agentList>