Módulo de exportação de agentes

Visão geral

Categoria: relacionada ao agente

Tipo de arquivo de exportação: XML

Convenção de nomeação de arquivos:exportAgent_mmddyy_hhmm.xml

Essa exportação contém campos de exibição de Definição do agente. Isso é geralmente usado com integrações de terceiros e inclui o ACD com detalhes de login.

Fatos importantes sobre essa exportação

  • As informações do agente são exportadas para cada agente que pertence à MU especificada na data em que a exportação é executada. Os dados são incluídos para cada data no intervalo em que a exportação foi configurada.
  • O arquivo de saída pode ser configurado para conter dados sobre novos agentes ou agentes alterados, mas não ambos no mesmo arquivo de saída. O padrão é dados de novos agentes.
  • A exportação pode ser configurada para incluir somente agentes com base nos horários de modificação de registro do banco de dados.
  • Para um agente ser incluído como novo registro de agente:
    • Todos os registros das várias tabelas usadas para criar um novo registro de agente devem ter um horário de modificação maior ou igual ao horário de modificação configurado (+/- 10 segundos), OU
    • A data/hora de início da atribuição de ACD do agente deve ser maior que a hora de modificação configurada.
  • Para que um agente seja incluído como um registro de agente alterado, qualquer um dos registros das várias tabelas usadas para criar um registro de agente alterado deve ter um horário de modificação maior ou igual ao horário de modificação configurado.

Arquivo de saída: campos e descrições

Durante seu contrato de serviços profissionais, você pode escolher quais dos seguintes campos incluir em sua exportação. Certifique-se de incluir todos os campos que você acha que pode precisar; você precisará de uma solicitação de alteração se quiser adicionar campos após a configuração da exportação. Se você não selecionar campos específicos, sua exportação incluirá todos os campos descritos aqui.

campo Descrição Valores
id

Inclua este elemento para elementos changedAgent.

Omita este elemento para elementos newAgent.

O valor do campo exportado depende do atributo idType do elemento id.

idType pode ser:

  • tvID ou [not specified]: ID do IEX WFM Integrated do agente
  • ssn: Número do ID pessoal do agente
  • acdLogon: atributo Logon do agente associado ao acdID deste elemento. O elemento fica em branco se o agente não estiver atribuído a um acdLogonID.
nome

Você deve incluir este campo para elementos newAgent.

O nome do agente é exportado como três elementos: firstName, lastName e nameSuffix.

Você pode incluir este campo para elementos changedAgent. Se você usá-lo, deve especificar o elemento name ou lastName para gerar nomes de agentes. Os elementos firstName e nameSuffix são opcionais quando usados com o elemento lastName.

 
UUID

ID de usuário unificado do agente

 
mu

Você deve incluir este campo para elementos newAgent. Esse é o ID da MU para a qual a exportação está sendo executada.

 
acdList

Inclui um elemento secundário acdStartDate e um elemento acd secundário.

 
acdStartDate

Data de execução da exportação.

 
acd

Inclui um elemento acdID secundário, um elemento logon secundário e um elemento agentGroup secundário.

 

acdID

ID do CXone Mpower ACD ou servidor multimídia na data especificada.

 

logon Logon do agente associado ao acdID

Quando a exportação é executada, esse campo fica em branco se o agente não tiver ID de logon ou não estiver atribuído ao CXone Mpower ACD.

logonType Tipo de logon. Este elemento é usado para sincronizar agentes entre os produtos CXone Mpower.  
agentGroup

ID do grupo de agentes ao qual o agente está atribuído.

 

startID

ID do IEX WFM Integrated do agente

Não incluído para elementos changedAgent.

 
ssn

Número do ID pessoal do agente

Este campo fica em branco se nenhum número de ID pessoal for atribuído a ou estiver disponível para o agente.

agentStartDate

Data de início do primeiro registro AgentMap ativo do agente. Esse é o registro com a s_date mais recente. Contém os itens secundários dia, mês e ano.

Não incluído para elementos changedAgent.

 
externalID Se sua empresa tiver configurado o Agent WebStation para usar IDs externos, o valor é esse ID para esse agente. Se o campo externalID do agente estiver em branco, este campo também ficará em branco.
senDate

Data de senioridade do agente. Contém os itens filhos dia, mês e ano.

 

senExt

Extensão de senioridade do agente.

 

rank

Classificação do agente.

 
supervisor

ID de logon do supervisor do agente.

Este campo está em branco.

password

A senha do agente para a estação da web.

Este campo está em branco.

minCDO Mínimo de dias consecutivos de folga do agente.  
maxCDO Máximo de dias consecutivos de folga do agente.  
minCDW Mínimo de dias consecutivos de trabalho do agente.  
maxCDW Máximo de dias consecutivos de trabalho do agente.  
minTimeBetweenScheds Número mínimo de minutos necessários entre programações para o agente.  
minRestPerWeek Período de descanso mínimo do agente por semana.  
availDateRange

Intervalo de datas do registro de disponibilidade do agente. Contém os itens secundários dia, mês e ano, e um item semanas secundário. O intervalo de datas fornecido aqui também é o intervalo de datas para:

  • minCDO
  • maxCDO
  • minCDW
  • maxCDW
  • minTimeBetweenScheds
  • minRestPerWeek
  • availDateRange
  • forceWork
  • workStatus
  • tourGroup
  • rotationNum
  • minMinutes
  • maxMinutes
Se o registro de disponibilidade padrão do agente for exportado, este campo ficará em branco.
startDate Data de início dos parâmetros de agendamento.  
endDate Data de término dos parâmetros de agendamento.  
default Registro de parâmetros de agendamento padrão.  
forceWork Configuração de trabalho de força do agente. Y ou N
workStatus Se o agente trabalha em período integral ou meio período F ou P
tourGroup Regra semanal do agente.  
rotationNum Número de rotação da regra semanal do agente.  
minMinutes Mínimo de minutos do agente por semana.  
maxMinutes Máximo de minutos do agente por semana.  
useAvailability Se a matriz de disponibilidade é usada para o agente. Este campo é sempre Y.
availListDateRange Intervalo de datas de cada availabilityList. Contém um elemento <default/> vazio ou um elemento <startDate> e <endDate>.  
availabilityList Contém sete elementos de disponibilidade secundários, um para cada dia da semana na ordem, começando por domingo.  
availability Indica se o agente está disponível para cada período de 15 minutos do dia que está sendo exportado. A ou N
availabilityListStatus Se a lista de disponibilidade foi aprovada, rejeitada ou está com aprovação pendente.  
skillSet Contém um elemento skillStartDate secundário, um elemento baseScheduleCode secundário e zero ou mais elementos skill secundários. Um elemento skill secundário é incluído para cada competência atribuída ao agente na data em que a exportação está sendo executada.  
skillStartDate Data da exportação.  
baseScheduleCode Código base da agenda da data da exportação. Contém a descrição do código de atividade.  
skillName Nome da competência.  
level Nível atribuído ao agente para a competência.  
rsv Configuração de sinalizador de reserva do agente para a competência.  
agentData

Incluído no arquivo de saída se:

  • Você solicita um ou mais elementos agentData válidos. Nesse caso, somente os grupos de dados do agente especificados são incluídos no arquivo de saída.
  • Todos os grupos de dados do agente são solicitados e pelo menos um grupo de dados do agente é definido.
 
grupo Contém um elemento description secundário, e um value secundário. Se um elemento agentData existir no arquivo de Configuração Avançada, mas não houver grupos de dados do agente com a descrição especificada no sistema, nenhum valor será exportado para esse elemento.  
adgStartDate Data de início do valor atribuído ao agente para o grupo. Contém os itens secundários dia, mês e ano.  
descrição A descrição do grupo de dados do agente especificado no elemento agentData do arquivo de Configuração Avançada.  
valor Valor atribuído ao agente para o grupos de dados do agente especificado no elemento agentData do arquivo de Configuração Avançada. Este campo fica em branco se o agente não tiver um valor atribuído.
emailList Contém um elemento email secundário para cada registro que existe na tabela de endereços de email.  
e-mail Endereço de e-mail.  
number Número do endereço de e-mail. 1-10
type Tipo de e-mail

N: normal

S: curto

language String de cinco caracteres que identifica o idioma e a localidade para formatar as mensagens.  
vacationGroup

O ID do grupo de folga ao qual o agente está atribuído na data que está sendo processada.

Não incluído para elementos changedAgent.

 
biddingDate

Data de senioridade alternativa do agente. Contém os itens secundários dia, mês e ano.

 
biddingExt

Extensão de senioridade alternativa do agente.

 
accrualDate Data do acúmulo do agente. Contém os itens filhos dia, mês e ano.  
daysVacWeek Número de dias que compõem uma semana de férias para esse agente.  
vacDayLengthList Contém sete elementos vacDayLength secundários, um para cada dia da semana, começando por domingo.  
recid Contador que começa em 1 e é incrementado para cada novo elemento newAgent ou changedAgent exportado.  

Arquivo de saída: amostra

 <?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>