Conceitos básicos de ação (Desktop Studio)

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

As ações são os blocos de construção dos scripts Studio. Um script é uma rede de ações que roteiam e gerenciam o tráfego de clientes para sua central de atendimento. Cada ação tem um propósito específico e, juntas, definem o que um script realiza. Há ações que reproduzem arquivos de áudio, instruem o script a aguardar, solicitam um agente e muito mais.

Cada ação representa um código que já foi escrito. Isso significa que você não precisa ser um especialista em scripts para criar scripts simples no Studio. No entanto, se desejar criar scripts mais complexos, é necessária alguma programação personalizada.

Na imagem a seguir de um exemplo de script, você pode ver uma série de ações ligadas por setas de conector. A descrição desse script mostra como cada ação atende a um propósito específico no script. A descrição está localizada depois da imagem na lista suspensa.

Tipos de ações

Há vários tipos diferentes de ações no Studio. Os três tipos a seguir são alguns dos mais básicos, que você usará em quase todo script que criar:

  • Ação inicial: Há somente uma ação que pode iniciar um script, Begin. Esta é a primeira ação em todos os scripts, incluindo subscripts.
  • Ações de evento: Ações de Evento iniciam uma nova ramificação em um script. Elas são disparadas quando um evento específico ocorre durante uma interação. Exemplos incluem Onanswer, Onrelease e Onhold. Você pode saber mais sobre ações de evento na próxima seção desta página.
  • Ações de encerramento: São ações que podem encerrar um script. Você deve usar a ação adequada para o tipo DE mídia do script. Caso use a ação de encerramento errada, o script pode não ser encerrado adequadamente. Por exemplo, processos em plano de fundo podem continuar em execução. Além disso, os contatos atendidos pelo script podem não ser finalizados, o que pode ter impactos negativos no sistema NiCE CXone.

Todas as outras ações de Studio se dividem em categorias com base no que a ação faz em um script ou nas partes da plataforma NiCE CXone com as quais interagem. Toda categoria tem um ícone de cor diferente associado a ela. No entanto, muitas ações se enquadram em mais de uma categoria, portanto a cor do ícone indica apenas uma das categorias em que uma ação pode se enquadrar.

As categorias de ação são descritas na tabela a seguir.

Categoria Detalhes Exemplos
ACD Essas ações interagem com o NiCE CXone ACD. Os ícones têm uma cor de fundo rosa brilhante Um quadrado rosa brilhante.. Reqagent

Getqueue

Bots de automação, fala e agente virtual

  • Estas ações fornecem automação, conexão a agentes virtuais e bots, e funcionalidades relacionadas à fala. Seus ícones têm uma cor de fundo azul-petróleo Um quadrado azul-petróleo..
  • ASR

    Textbot Exchange

    Chat Estas ações funcionam com scripts de chat. Os ícones deles têm uma cor de fundo verde-amarelada A yellow-green square. . Askcaller

    Chatblindxfer

    Dados Estas ações permitem que você acesse dados e bancos de dados. Os ícones têm uma cor de fundo cinza-escuro A dark gray square. .

    Setdb

    Getlist

    E-mail These actions work with email scripts. Their icons have an orange background color An orange square. . Getemail

    Createemail

    Fluxo geral e do script Essas ações geralmente são úteis ou ajudam a criar o fluxo do script. Seus ícones têm uma cor de fundo azul-escura A dark blue square. . Wait

    Anotação

    Lógica Essas ações permitem que você inclua lógica de script em seu script. Seus ícones têm cor de fundo amarela A yellow square. . If

    Snippet

    Script Estas ações permitem que você controle e interaja com o próprio script. Os ícones deles têm uma cor de fundo violeta-avermelhado A red-violet square. . Signal

    RunScript

    Segurança Essas ações fornecem funcionalidades de segurança. Seus ícones têm cor de fundo roxa Um quadrado roxo. . Setsecurityuser
    Iniciar Há apenas uma ação que pode iniciar um script. É a única ação redonda e é verde sólido Icon of green square, the color of the Begin action. Iniciar
    Strings Estas ações permitem que você trabalhe com strings. Os ícones têm uma cor de fundo vermelha A red square. . Sort

    Analisar

    Sistema e arquivos These actions allow you to work with files on the system. Their icons have a bright blue background color A bright blue square. . Filesize

    Writefile

    Voz e áudio Estas ações funcionam com scripts de voz. Os ícones deles têm uma cor de fundo verde A green square. . Menu

    Reproduzir

    Ações de evento

    Ações de eventos são executadas apenas quando ocorre um gatilho específico. Os gatilhos de evento incluem itens como uma chamada sendo atendida, transferida ou colocada em espera. Por exemplo, Onanswer é um Evento acionado quando uma solicitação para interação é respondida, como um contato atendendo a uma chamada telefônica de um agente em tempo real ou um agente em tempo real respondendo à pergunta de chat de um contato.

    Quando um evento é disparado, qualquer execução de script que possa estar ocorrendo antes da ocorrência do disparo é encerrada. O script continua a partir da ação do evento.

    O script de exemplo a seguir demonstra o evento Onanswer. O script configura uma Rvi de entrada básica com opções de menu para Atendimento ao cliente, Suporte Técnico e Vendas, que correspondem a 1, 2 e 3. Estes representam os números que o contato pressiona no teclado para escolher uma opção de menu. O evento Onanswer está no canto inferior esquerdo do script. Não está conectado à parte principal do script. Em vez disso, é separado, indicando que se trata de uma ação de evento. Assim que um agente atende à interação, o script salta para Onanswer e envia uma mensagem ao agente.A ação está configurada na ação Messages.

    Localização das Actions de Studio

    Studio ações são encontradas na guia Tools e na guia Framework. A guia Framework não está disponível para todos os usuários por padrão. É uma opção que o seu representante de conta deve habilitar para o seu locatárioClosed Agrupamento organizacional de alto nível usado para gerenciar o suporte técnico, o faturamento e as configurações globais do seu sistema NiCE CXone..

    Guia Ferramentas

    A guia Ferramentas contém as ações mais comuns usadas na criação de scripts. Nesta guia, as ações são organizadas em uma paleta que tem várias categorias padrão, como padrão, sistema e fala. Na guia Ferramentas, você pode optar por visualizar todas as ações ou organizá-las em suas categorias. Você também pode optar por ordenar as ações em ordem alfabética ou visualizá-las na ordem padrão.

    Guia Estrutura

    A aba Framework é uma lista completa de todas as ações disponíveis. As ações nesta guia são organizadas em uma estrutura de árvore de pastas. Cada pasta é uma categoria. Você pode expandir uma pasta para ver as ações que ela contém. A guia Estrutura não está habilitada por padrão. Você pode solicitar acesso à aba entrando em contato com seu representante de conta.

    Disponibilidade de ação e Tipo DE mídia

    Algumas ações só ficam visíveis em Studio se o produto ou recurso ao qual estão relacionadas estiver habilitado para o seu sistema NiCE CXone. outras ações são visíveis apenas se o script ativo tiver o tipo DE mídia que a ação exige. Por exemplo, se uma ação funcionar apenas com script de chat e o script ativo for um script de telefone, a ação pode não estar visível até que você alterne para um script de chat.

    Paletas e Categorias

    Na guia Ferramentas, as ações são organizadas com paletas. Há uma paleta por padrão, mas você pode criar paletas personalizadas.Os paletes permitem personalizar a organização das ações em Studio. Por exemplo, você pode criar paletas para diferentes Scripts nos quais trabalha, ou pode criar uma paleta para ações que você usa com frequência e outra para ações que você usa somente às vezes.

    Cada paleta deve ter pelo menos uma categoria. As categorias permitem que você organize ainda mais as ações na paleta. A paleta padrão tem várias categorias, como sistema, eventos, web e Personal Connection. Você pode optar por visualizar as ações em uma paleta por categoria, ou pode optar por visualizar todas as ações de uma vez. Além disso, você pode ordenar as ações em ordem alfabética ou pela ordem padrão em que foram adicionadas à paleta.

    Propriedades da ação

    A maioria das ações tem um conjunto de propriedades que você pode configurar. Algumas propriedades são obrigatórias, enquanto outras são opcionais. As Propriedades são como você personaliza a ação para fazer o que você precisa dela no seu script.

    Você pode visualizar as propriedades de uma ação quando ela estiver na tela do script. As propriedades aparecem na guia Propriedades quando a ação é selecionada. Você também pode clicar com o botão direito na ação para visualizar suas propriedades em uma janela pop-up. Todas as ações têm no mínimo quatro propriedades, mas a maioria também tem outras propriedades. As quatro propriedades padrão são:

    • ToolName: O nome da ação. Esta é uma propriedade do sistema e não pode ser alterada.
    • Categoria: A localização da ação na guia Framework. Esta é uma propriedade do sistema e não pode ser alterada.
    • ActionID: O id da ação no script. Os IDs são atribuídos na ordem em que as ações são adicionadas ao script. O ID é uma propriedade do sistema e não pode ser alterado, exceto excluindo a ação do script e adicionando-a novamente. Se você excluir uma ação de um script, todos os conectores que se ligam a essa ação e a partir dela também serão excluídos.
    • Caption: A legenda da ação que aparece na tela do script. Você pode alterar a legenda para que ela descreva a função da ação no script. Isso ajuda os scripts a serem mais fáceis de entender e solucionar problemas. Também são usados em relatórios de RviClosed Resposta de Voz Interativa. Menu de telefone automatizado que os contatos usam por meio de entradas de voz ou de teclas para obter informações, rotear uma chamada de voz de entrada, ou ambos. para algumas ações.

      Você pode querer usar a configuração de uma das outras propriedades de uma ação como a legenda. Por exemplo, você pode atribuir a uma ação de Música o nome do arquivo de música que ela reproduz. Você pode digitar as informações no campo Caption ou pode copiar o valor da propriedade e colá-lo no campo Caption. Para fazer isso, clique no rótulo do nome da propriedade e pressione CTRL+C, depois clique no rótulo legenda e pressione CTRL+V.

    Some actions have an editor that allows you to configure additional properties or add data to the action. To access action editors, double-click the action on the canvas. For example, when you double-click on the Play action, the Play Properties window, also called the sequence editor, opens. In this window, you can create sequencesClosed Um segmento de um prompt de áudio reproduzido para o contato. for prompts, such as recording an audio message or designing a TTS prompt. .

    Você pode recortar, copiar e colar ações em seus scripts. Ao adicionar uma ação copiando e colando em seu script, certifique-se de atualizar as propriedades de ações, se necessário.

    Propriedades de entrada e Saída

    Algumas propriedades armazenam dados que a ação usa. Estas são propriedades de entrada. outras propriedades armazenam dados passados à ação para que o restante do script os use. Essas são propriedades de saída e as variáveis que armazenam os dados são chamadas de variáveis de saída. Ambas as propriedades de entrada e saída aparecem na lista de Propriedades na guia Propriedades de uma ação. Você pode identificar variáveis de saída porque o nome da propriedade termina com (out). Por exemplo, a ação REST API tem duas propriedades de variável de saída, errorArgList (out) e resultSet (out).

    Ao configurar uma propriedade de variável de saída, você está nomeando uma variável para armazenar dados passados para a ação. Não é necessário formatar o nome da variável no campo de propriedade com chaves.

    Ramificações e Condições

    O fluxo de um script é definido pela conexão de ações entre si. Às vezes, uma ação tem apenas um resultado possível, então está conectada a uma outra ação. Quando uma ação tiver mais que um resultado possível, você pode criar um caminho para cada possibilidade. Esses caminhos são chamados de ramificações de resultado ou apenas ramificações.

    Ramificações permitem que você projete seu script para lidar com todos os tipos de situações, como erros, respostas inesperadas ou o que fazer quando uma chamada telefônica não é atendida. Você também pode usar ramificações para criar opções de escolha em seu script, como a criação de um menu que solicita ao contato que escolha uma opção.

    Condições de ramificação de resultado

    Cada ação Studio tem uma ou mais ramificações de resultado possíveis que você pode configurar. Cada ramificação de resultado tem uma condição associada que define o que precisa acontecer para que o script siga esse caminho. As condições são resultados possíveis do acionamento dessa ação quando o script é executado.

    Todas as ações têm uma ramificação de resultado Default. Algumas ações têm mais que uma condição de ramificação de resultado disponível. Além disso, algumas ações oferecem suporte a condições personalizadas.

    Cada ação em seu script deve ter uma ramificação que utiliza a condição Default, mesmo que você esteja conectando as outras ramificações da ação. Quando uma ação tem mais de uma ramificação de resultado, a ramificação Default é aquela seguida quando nenhuma das outras condições é atendida. Isso é importante para evitar que os contatos fiquem travados nesse ponto do script, caso algo inesperado ocorra.

    Quando você conecta duas ações, é solicitado que selecione o ramo que está criando. A lista de ramificações pertence à ação da qual você extrai o conector. Selecione a ramificação para a condição que precisa ser atendida para o script seguir essa conexão para a segunda ação. Você também pode clicar em uma ação e ver as possíveis ramificações de resultado no painel de propriedades e configurá-las.

    Morto Termina

    É importante estar atento a becos sem saída em seus Scripts quando uma ação tem múltiplo ramificações de resultado. Becos sem saída podem ocorrer quando as ramificações estão ausentes ou não estão configuradas corretamente. Por exemplo, uma ação de Música precisa estar conectada a uma ação de Wait. Wait permite especificar por quanto tempo a ação de Música é reproduzida antes de reiniciar e repetir. Sem Wait, Música é reproduzida indefinidamente.

    Becos sem saída também podem ocorrer se uma ação não estiver configurada com uma ramificação de resultado Default. Se algo inesperado acontecer e o script não puder seguir nenhuma das outras ramificações de resultado configuradas, ele seguirá a ramificação Default. Se uma ação não tiver uma ramificação Default, o script não poderá continuar e o contato ficará travado.

    Múltiplas Conexões para a Mesma Ação

    Você pode criar várias conexões para a mesma ação. Isso é necessário quando há mais de uma condição que pode resultar no script chegando à variável de destino. Em vez de adicionar uma cópia da variável de destino ao script uma vez para cada condição, você pode criar três ramificações que terminam todas na mesma ação.

    Na imagem a seguir, você pode ver um exemplo de um script com três ramificações que vão da ação Horas até a ação Desligar. Cada ramificação tem uma condição diferente para tratar três cenários em que a central de atendimento está fechada.

    Conectores

    Conectores são linhas que conectam duas ações. O conector tem a seta apontando na direção do fluxo do script. Você pode conectar ações clicando no pequeno triângulo no canto do ícone da ação e arrastando até a próxima ação.

    Tipos de Conectores

    Existem três tipos de conectores, e cada um deles apresenta uma aparência ligeiramente diferente na tela. Aprender a identificá-los pode ajudá-lo a entender um script rapidamente. O exemplo a seguir de um script mostra os três tipos.

    Os tipos de conectores são:

    • Default: Este é um conector que usa a condição de branch Default. É uma linha preta sólida sem rótulo. Na imagem de exemplo, o conector que ligaBegin a Menu e Menu a Play são conectores padrão.
    • Regular: Este é um conector que usa qualquer condição de ramificação, exceto Default. É uma linha cinza tracejada com um rótulo. O rótulo corresponde à condição que a ramificação usa. Na imagem de exemplo, os conectores que ligam Loop a Menu é um conector regular.
    • Personalizado: Este é um conector que usa uma condição de ramificação variável. É uma linha cinza sólida com um rótulo. O rótulo corresponde ao nome da condição personalizada atribuída à ramificação. No exemplo, os conectores que ligam de Menu a cada uma das ações Reqagent à direita são conectores personalizados. Os rótulos deles são 1, 2 e 3, que são os nomes das condições variáveis atribuídas a cada ramificação.

    Principais fatos sobre Conectores

    • Clique no ícone do conector no canto inferior direito do ícone da ação e arraste-o até a segunda ação. Solte-o no centro da segunda ação.
    • Quando você move uma ação para um local diferente na área de trabalho do canvas, o conector se move com a ação. Ele não muda de forma, mas se move para o lado mais próximo da ação estacionária. Ela também muda se o comprimento do conector for alterado.
    • Você pode alterar o formato do conector para que todas as ramificações sejam fáceis de ver. Isso ajuda a tornar o script mais legível e mais fácil de atualizar.

    • Se você precisar alterar a ramificação que um conector usa, deverá excluir o conector e adicioná-lo novamente.

    • Exclua um conector clicando na seta no centro da linha e pressionando a tecla Del no teclado.