SET AGENT STATE

Esta página de ajuda é para Studio. Estas informações também estão disponíveis para Desktop Studio.

Uma cabeça e tronco de pessoa em formato de palito com um círculo vazio.

Define o estado do agente detentor da sessão especificada pela propriedade SessionId. Um agente pode ser definido somente para um estado Disponível ou Indisponível. Os outros estados DO agente são controlados pela plataforma à medida que ela roteia contatos ou conforme o agente efetua login e logout na plataforma. Há somente um estado Disponível, mas há múltiplos motivos pelos quais um agente pode estar no estado Indisponível, conforme descrito abaixo:

  1. O agente pode estar no estado padrão Indisponível sem código do motivo. Este é o estado em que uma sessão de agente é iniciada.
  2. O agente pode receber um código do motivo por estar Indisponível a partir de uma coleção de motivos conhecida como códigos de indisponibilidade. Esses códigos indisponíveis são criados pelo cliente. Por exemplo, eles podem ter um código indisponível no intervalo, um código indisponível para almoço ou um código indisponível para treinamento etc. Esses códigos indisponíveis podem ser recuperados do método GET / admin / teams / {teamId} / códigos-indisponíveis .
  3. O agente pode estar em um estado de Trabalho Após Contato (ACW). Esses são estados especiais indisponíveis, criados pelo cliente no NiCE CXone plataforma e são códigos indisponíveis com o sinalizador ACW. Esses códigos indisponíveis só podem ser usados como "reason" se o agente estiver tratando um contato ativo; caso contrário, a API retornará um erro 409.

Os códigos indisponíveis que são estados ACW terão o sinalizador isAcw definido como true. Observe que os códigos de indisponibilidade de ACW também podem ter um limite de tempo automático, que é usado pela plataforma para finalizar automaticamente o código de indisponibilidade de ACW e mover o agente para seu novo estado. Você pode usar isso para exibir um temporizador de contagem regressiva ao agente quando o código de indisponibilidade de ACW é iniciado, permitindo que o agente veja quanto tempo tem antes que o código de indisponibilidade de ACW termine.

Definir a sessão do agente para um código de indisponibilidade de ACW faz com que o agente entre em um estado de Indisponível durante o qual o tempo é contabilizado em relação ao tempo de interação ativa, mesmo que a interação com o contato tenha terminado. Enquanto estiver nesse estado, o agente não receberá outras interações entregues (porque está Indisponível), mas o tempo é registrado como tempo de trabalho para a interação que acabou de terminar.

Dependências

  • Esta ação exigirá inevitavelmente o uso de Ações de API adicionais para obter o SessionID do agente. Consulte developer.nicecxone.com A square with an arrow pointing from the center to the upper right corner. para obter mais informações sobre como obter a identificação de sessão.
  • Para organizações que usam Supervisor Workspace (Supervisor) e um aplicativo Agent Workspace (Agent): Você pode usar a ação set Agent STATE para definir os estados DO agente como Disponível. No entanto, para agentes supervisores, é preciso configurar o seu script para evitar problemas quando o Agente supervisor recebe uma chamada no Agent Workspace (Agent) enquanto estão monitorando outro agente no Supervisor Workspace (Supervisor). Existem duas soluções possíveis:

    • Use a AgentState ação para verificar o Estado do agente supervisor. Se o estado do agente for não disponível ou um estado semelhante, como não disponível Monitoramento, seu script deve ignorar a ação set Agent State. Isso evita que o estado do agente seja alterado para Disponível. Além disso, o script deve lidar com interação recebida de outra maneira. Por exemplo, ela poderia ir para o correio de voz ou ser roteada para outra competência ACD ou agente.
    • Conecte a ramificação Em Erro da ação set Agent STate. Quando um supervisor está monitorando um Agente, o sistema não permite que o estado do supervisor seja definido como Disponível. Ele toma o ramal Erro se estiver conectado. Se não estiver conectado, ele segue a ramificação Default. Certifique-se de que o seu o script lide com a interação recebida de outra maneira.

Tipos de script suportados

Um quadrado com uma linha saindo dele e indo em direção a três outros quadrados.

Icon of gray-green envelope

Ícone de balão de fala verde escuro

Icon of purple telephone handset

Ícone do símbolo de correio de voz na cor marrom-enferrujado, composto por dois círculos unidos por uma linha

Icon of pink document with lines of text

Ícone de um telefone celular verde com um balão de fala na tela

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

Adicionar legenda

Insira uma frase curta que identifique 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. O valor padrão é SecurityUser (mesmo valor de saída padrão de SetSecurityUser). Não é necessário usar chaves ( {} ) com essa propriedade.

Identificação de sessão

The unique ID assigned to the agent's login session within the NiCE CXone system.
Estado The desired state to which the agent will be set after executing this action successfully. Options include Unavailable or Available and can be consumed as variables.
Motivo This property is used to enter text for the Unavailable Code that also displays on the agent interface Unavailable status bar next to SystemOutstate – {inserted text}. This property is unused when the Agent state is available.

Condições de ramificação de resultado

As condições de ramificação de resultado permitem que você crie ramificações no seu script para tratar diferentes resultados quando uma ação é executada.

Condição

Descrição

Padrão Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
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).
InvalidSecurityUser Caminho tomado quando um usuário de segurança inválido for usado.
InvalidAgentSession Path taken if the Session Id entered is invalid.
InvalidStateRequest Path taken if an invalid state is requested other than the available options.
InvalidUnavailableCode Path taken if the specified Unavailable Code is invalid.
InvalidState Path taken if a value other than Unavailable or Available is entered.

Outras Opções

Se o seu desejo for utilizar um Código de indisponibilidade personalizado existente no qual colocar o agente, use a ação de API set Agent State V7. A ação V7 permite que você use a variável AgentID em vez da identificação de sessão, simplificando o resultado de alterar o estado de um Agente sem utilizar múltiplas Ações de API.