Agent List

Retorna todos os agentes atribuídos à unidade de negócios (a menos que um ID do agente específico seja inserido nas propriedades) em uma matriz contendo as informações de perfil de cada agente com os seguintes campos retornados na variável especificada no 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 Você pode usar esta ação para verificar se um agente específico está ativo, encontrar o endereço de e-mail do agente, verificar a qual equipe pertence ou uma variedade de outras opções personalizadas. Lista de agentes é uma das APIs disponíveis que você pode usar no Studio. Você deve ter ações e permissões do Framework ativadas em sua unidade de negócios para aproveitar essa ação.

Dependências

• Certifique-se sempre de que a ação SetSecurityUser preceda esta ação e a variável de saída daquela ação corresponda à variável de entrada SecurityUser das propriedades da ação Agent List.

• Esta ação está localizada na paleta de Ações API.

Tipos de script suportados

Genérico	E-mail	Chat	Telefone	Correio de Voz	Item de Trabalho	SMS

Propriedades de entrada

Estas propriedades definem dados que a ação usa durante a execução.

Propriedade	Descrição
Add Caption	Insira uma frase curta que identifica exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação.
Usuário de segurança	O valor de saída da ação SetSecurityUser que autentica um agente selecionado com base em suas permissões no perfil de segurança. Este campo aceita variáveis formatadas com chaves ( { } ). O valor padrão é SecurityUser (mesmo valor de saída padrão de SetSecurityUser).
ID do agente	O ID do agente. Você pode usar uma variável para este campo, como {agentId}. Quando em branco, todos os usuários associados com usuário Alto nível de agrupamento organizacional usado para gerenciar o suporte técnico, cobrança e configurações globais para o seu ambiente CXone Mpower serão retornados em uma matriz. Modo no valor Insira o ID do agente ou clique nos botões de adição + ou subtração - para adicionar um número de ID. In Expression Mode: Insira o ID do agente.

Propriedades de saída

Estas propriedades contêm variáveis que armazenam dados retornados da execução da ação. Elas estão disponíveis para referência e uso quando a ação é concluída.

Propriedade	Descrição
ListVar	Armazena os dados retornados. O conteúdo dessa variável é armazenado como uma matriz. O valor padrão é Agents, mas pode ser alterado para qualquer outro valor desejado.

Condições de ramal resultante

Condições de ramal resultante permitem que você crie ramais no seu script para atender diferentes resultados quando uma ação é executada.

Condição	Descrição
Default	Caminho percorrido, a menos que o script atenda a uma condição que exige que ele percorra um dos outros ramais. Também é percorrido se os outros ramais da ação não estiverem definidos.
Sucesso	Caminho seguido se a ação for concluída sem erros e quaisquer chamadas de API ou retornos de dados foram bem-sucedidos (códigos de resposta 2xx).
InvalidAgentId	Caminho seguido se o ID do agente for inválido.
InvalidSecurityUser	Caminho tomado quando um usuário de segurança inválido for usado.

Outras opções

Dependendo dos dados que deseja obter, ações API adicionais podem ser úteis. Por exemplo, All Agent Skill Assignments, Agent States V4, Get Agents List, Get Agent Details by Agent ID e assim por diante.