AgentList

This help page is for Desktop Studio. This information is also available for CXone Studio.

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

Tipos de script suportados

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

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

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. The default is the action name.

SecurityUser 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).
AgentID O ID do agente. Você pode usar uma variável para este campo, como {agentId}. Quando em branco, todos os usuários associados à unidade de negócios serão retornados em uma matriz. Este campo aceita variáveis.

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 (out) Armazena os dados retornados. O conteúdo dessa variável é armazenado como uma matriz. A variável padrão é Agents.

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.

OnError

Caminho tomado quando a ação não é executada corretamente. Por exemplo, quando há um problema inesperado como conectividade ruim, erros de sintaxe e assim por diante. A variável _ERR, com o caractere sublinhado, deve ser preenchida com uma explicação condensada do problema.

Outras opções

Dependendo dos dados que deseja obter, ações de Estrutura 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.