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:
|
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:
|
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:
|
|
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. | |
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>