SNIPPET

Permite adicionar código personalizado ao seu script.

Dependências

• O código usado nesta ação deve ser escrito em Snippet, uma linguagem de script interna desenvolvida para CXone Mpower. O guia de referência técnica do Studio fornece informações detalhadas sobre criação de scripts em snippets.
• Atributos de objetos de dados dinâmicos não podem ser nomeados __type (com dois sublinhados). Essa palavra é reservada para uso ao analisar JSON de objetos dinâmicos.
• Você pode fazer chamadas API usando a ação Snippet. O tamanho máximo da resposta é 32 KB. Isso é consistente com o limite de tamanho da resposta na ação REST API.  O limite é cumprido rigorosamente para evitar instabilidade e interrupções no conjunto. Se puder, use a ação REST API em vez disso. Ela tem o mesmo limite, mas pode suportar uma carga mais pesada. Caso precise usar a ação SNIPPET, siga estas dicas para reduzir o tamanho das informações retornadas:

  • Filtre os dados na resposta da API. Por exemplo, se estiver usando a API de relatórios NiCE para obter contatos, você pode filtrar os resultados pela startDate e endDate do contato. Esta chamada de API também permite retornar e limitar uma contagem máxima de itens. Consulte a documentação da API que acompanha a integração do script para determinar qual filtragem você pode usar.

  • Atualize a solicitação da API para retornar apenas os dados necessários. Por exemplo, se estiver usando a API de relatórios NiCE para obter contatos, você pode usar os campos contactId ou agentId para retornar apenas dados relevantes. Consulte a documentação da API que acompanha a integração do script para determinar quais limites de dados você pode usar.

  • Se não puder seguir nenhuma das dicas anteriores, crie um middleware.

• O tamanho máximo de matrizes em Studio é de 63 milhões de elementos. Exceder esse tamanho de matriz resulta no seguinte erro na variável __err em um rastreamento de script: Índice de matriz fora dos limites. O índice de matriz atual ([índice]) excede o índice máximo permitido (63000000). Quando o tamanho da matriz é excedido, o script usa o ramal SNIPPET da ação Error. Se a ramificação Error não estiver conectada, o script continuará a ser executado, mas sem as informações da matriz. Você pode configurar scripts para notificá-lo quando o tamanho máximo da matriz tiver sido excedido adicionando uma ação EMAIL ao ramal SNIPPET da ação Error. Finalmente, você pode adicionar lógica na ramificação Error para continuar com o script. Observe que ele continuará sem as informações da matriz.

Tipos de script suportados

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

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.
Data	Contém o código personalizado adicionado na janela do Snippet editor. Isso pode incluir vários comandos ASSIGN e DYNAMIC, diversos enunciados de controle de fluxo e funções incorporadas e definidas por usuário.
Max String Size	Define o tamanho máximo de string para todos os comandos na propriedade Data. As opções são: Limit2K, Limit4K, Limit8K, Limit16K, Limit32K. Este limite é aplicado às respostas de integrações com APIs Rest e SOAP.

Condições da 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.
Error	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.

Dicas e truques

• Use a função asjson() em um Snippet action e armazene o JSON resultante em uma variável de string. Use a variável de string nas propriedades de outras ações Studio quando precisar transmitir os dados JSON. Essa abordagem evita a possibilidade de erros de validação ao salvar o script.
• Caso esteja ajustando um sistema RVI Resposta de voz interativa. Menu de telefone automatizado que os contatos usam entradas de voz ou teclas para obter informações, encaminhar uma chamada de voz recebida ou ambos. com ASR Reconhecimento automático de fala. Permite que os contatos respondam aos avisos falando, pressionando as teclas do telefone ou ambos. ativado, há um conjunto de parâmetros que você pode usar nos snippets.
• A linguagem Snippet fornece comandos em palavras-chave que permitem que você declare variáveis e objetos, crie loops e instruções iterativas e mais.
• O Studio tem funções internas que você pode usar nos seus scripts.
• Você pode criar as suas próprias funções personalizadas para usar em snippets.
• É possível testar e depurar código de snippet na janela Snippet editor .
• Use a variável de sistema test ao depurar snippets. Ele permite que você defina o valor das variáveis que são usadas no snippet e seriam preenchidas pelo script quando ele for executado para um contato A pessoa que interage com um agente, RVI ou bot em seu centro de contato..

Snippet janela do editor

A janela do editor de Snippet é aberta quando você seleciona uma ação Snippet e clica em Abrir Editor nas propriedades da ação. Você também pode clicar na janela no meio da ação quando ela estiver na tela do script.

Exemplo de script

Neste exemplo simples, as ações Snippet contêm declarações de objetos de dados dinâmicos e outras variáveis usadas no script. O Snippet com a legenda Analisar a Transcrição contém código que verifica se a transcrição é de um correio de voz. Se for um correio de voz, o script copia o corpo da mensagem da transcrição para uma variável. A variável que contém o corpo da mensagem é passada para a ação PLAY, que lê a mensagem usando conversão de texto em fala Permite que os usuários insiram prompts gravados como texto e usem uma voz gerada por computador para falar o conteúdo..

Baixe este script.