Scripts com Arquivos e Pastas

Você pode trabalhar com arquivos nos scripts do Studio. Os Arquivos devem existir no seu sistema NiCE CXone. Você pode exibir os arquivos em NiCE CXone na página Procurar Arquivos ACD. Você pode enviar e baixar arquivos a partir desta página. Você também pode enviar e baixar arquivos usando Desktop Studio.

Há ações que permitem que você explore arquivos no seu sistema NiCE CXone:

  • Writefile: Salva dados em um arquivo em NiCE CXone.
  • Readfile: Lê dados de um arquivo.
  • Filesize: Determina o tamanho de um arquivo em bytes.
  • Fileinfo: Recupera informações sobre um arquivo, como sua localização e se ele foi modificado.
  • Fileexist: Determina se um arquivo específico existe.
  • Excluir: Remove arquivos de NiCE CXone.

Há ações que permitem o envio de arquivos por e-mail ou FTP/SFTP:

  • EMAIL: Envia um e-mail com um anexo de arquivo.
  • EMAIL (Digital Scripts): Envia um e-mail com um arquivo anexado.
  • Anexar: anexa arquivos aos e-mails gerados.
  • Sendfile: Envia arquivos via FTP ou SFTP.

Há ações que permitem usar arquivos de áudio pré-gravados ou Prompts em suas interações:

  • MENU : Reproduz um prompt ou um arquivo de áudio pré-gravado para o contato e cria um menu de opções para que ele escolha entre elas.
  • Play : Reproduz arquivos de áudio WAV personalizados ou prompts de conversão de texto em fala (TTSClosed Permite que os usuários insiram prompts gravados como texto e usem uma voz gerada por computador para falar o conteúdo.). Se estiver usando um arquivo, o arquivo inteiro é reproduzido. Somente o contato pode ouvir o áudio.
  • Playlog: Reproduz arquivos de áudio WAV personalizados que somente o contato pode ouvir. Permite selecionar um ponto específico de início e de parada. Não é possível reproduzir os arquivos de música integrados a outras ações, como Music.
  • Reqagent: Reproduz arquivos de áudio WAV personalizados ou Prompt de conversão de texto em fala que somente o agente ouve. O prompt é reproduzido antes que o agente e o contato sejam vinculados e, portanto, o prompt não faz com que o contato ouça o silêncio.
  • Sussurro: Reproduz arquivos WAV personalizados ou prompts de conversão de texto em fala. Você pode configurá-lo para ser audível apenas pelo contato, apenas pelo agente ou por ambos. O prompt é reproduzido depois que o agente e o contato são vinculados e, portanto, se a ação for reproduzida apenas para o agente ou contato, a outra parte ouvirá o silêncio durante o prompt.

Uma última ação é a CONCATWAV ação, que permite concatenar dois arquivos WAV.

Uma carga excessiva é colocada em seu sistema quando essas condições são atendidas:

  • Sua unidade de negócios tem mais que ~15 chamadas simultâneas.
  • Os scripts em execução contêm ações relacionadas a arquivos, como Writefile, Readfile e Fileexist.

Isso resulta em limitação. Sua unidade de negócios vivenciará latência na execução do script e em outras funções, incluindo atendimento de contatos e alterações de estado, até que as pendências de processos sejam concluídas.

Caminhos de arquivos

Quando precisar se referir a caminhos de arquivo em seus Scripts, verifique a página de ajuda da ação que você está usando. Algumas ações usam caminhos absolutos.Outras exigem um caminho relativo. Se a página de ajuda não especificar e um tipo de caminho não funcionar em seu script, tente o outro tipo. A diferença entre caminhos absolutos e relativos é:

  • Caminho absoluto: Sempre começa na pasta raiz. Não importa onde o arquivo de script esteja localizado em relação ao arquivo ou script ao qual você está se referindo. Use um til e uma barra invertida (~\) para indicar a pasta raiz. Por exemplo, ~\pasta\arquivo.wav.
  • Caminho relativo: Descreve a localização do arquivo ao qual você está se referindo em relação ao arquivo de script, começando pela localização do arquivo de script. Se o arquivo estiver localizado em uma subpasta na mesma pasta que o script, trate a localização do script como a raiz e inclua os nomes das subpastas no seu caminho. Por exemplo, se o script estiver em \Folder, e file.wav estiver em \Folder\Subfolder1, você escreveria o caminho assim: \Subfolder1\file.wav. Se o arquivo estiver fora da pasta do script, ou se um caminho relativo não funcionar, use um caminho absoluto em vez disso.

É uma prática recomendada em Studio usar caminhos absolutos sempre que possível, mesmo quando caminhos relativos também forem suportados. Isso é especialmente importante ao se referir a um arquivo localizado em outra pasta. Essa prática recomendada se aplica sempre que você estiver se referindo a arquivos em Scripts, não apenas ao trabalhar com estágios de fluxo de trabalho de desenvolvimento.

Gestão do caminho do arquivo em Scripts

Scripts em Studio raramente existem isoladamente. Elas são normalmente organizadas em múltiplas pastas para oferecer suporte à reutilização e à personalização. Outros arquivos usados com Scripts, como prompts de áudio ou arquivos de gramática ASRClosed Reconhecimento automático de Fala. Permite que os contatos respondam aos prompts falando, pressionando teclas do telefone ou ambos., estão localizados em pastas separadas. Se sua empresa usa os estágios do fluxo de trabalho de desenvolvimento Studio, você também tem pastas relacionadas a estágios que permitem a promoção controlada. As Scripts frequentemente fazem referência a outras Scripts localizadas em pastas diferentes, portanto, a gestão de caminho é necessária para o sucesso da criação de scripts.

Você pode usar a substituição de variável em caminhos de arquivo para criar uma forma consistente e confiável de gerenciar caminhos em seus scripts. Isso ajuda a garantir que as referências a outros scripts, prompts de áudio, gramáticas de ASR e outros arquivos sejam mais precisas em todo o seu ecossistema de scripts.

Gerenciamento de caminho permite que os Scripts localizem e executem outros Scripts ou usem outros arquivos entre limites de pastas. Ao usar a substituição de variáveis para caminhos de arquivo, você tem caminhos definidos em um pequeno número de lugares. Se as pastas ou arquivos forem alterados, você só precisa atualizar o caminho em um só lugar, em vez de ter que localizar cada referência ao arquivo.

Substituição de variável para Caminhos de Arquivo

Usar a substituição de variável para caminhos de arquivo permite que você defina:

  • O caminho absoluto para pastas que contêm Scripts ou arquivos que você referencia nos Scripts. Quando você se referir a Scripts ou arquivos localizados em outras pastas, você deve usar um caminho absoluto.

  • Caminhos que são atualizados automaticamente quando um script é promovido. Esta opção se aplica somente se sua empresa usar Studio estágios de fluxo de trabalho de desenvolvimento.

  • Caminhos para pastas e arquivos em uma única localização, ou em um pequeno número de localizações. Isso facilita quando você precisa atualizar o caminho, porque você sabe onde as variáveis foram criadas.

Você pode criar variáveis para armazenar o caminho de cada tipo de arquivo que você referencia, como Prompts, gramáticas, correios de voz, outros Scripts, e assim por diante. Se um script salva arquivos em ou lê arquivos de uma pasta, você também pode usar variáveis para esses caminhos.

Quando você precisar referenciar um arquivo, use a variável no lugar do caminho. Por exemplo, crie uma variável para o caminho dos seus arquivos de prompt e use-a nas propriedades de açãoClosed Executa um processo em um script do Studio, como coletar dados de clientes ou reproduzir música. quando você especificar um prompt. Pode se parecer com o exemplo a seguir: {promptPath}Saudação.wav.

Para automatizar a atualização das variáveis de caminho, você pode usar uma SNIPPET ação e escrever código para determinar em qual pasta de fase de desenvolvimento o script está, e então atualizar o caminho de acordo. O restante desta página de ajuda descreve um exemplo de snippet que você pode usar como modelo em seu script.

Se a sua organização tiver múltiplos desenvolvedores de script, trabalhem juntos para desenvolver uma estratégia de uso de substituição de variáveis para caminhos de arquivo. Isso economizará tempo e garantirá que todos saibam quais variáveis usar.

Exemplo de substituição de Variável de caminho do arquivo

O exemplo de substituição de variável para caminhos de arquivo é configurado como um script de entrada. Um script de entrada é o script padrão configurado em um ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail. (POC). No exemplo, o script de entrada é executado para outro script que realiza o roteamento do canal. Você também pode usar um script de entrada como o script padrão para mais de um POC e fazer com que ele seja executado para o script de roteamento apropriado com base em critérios como ACD competênciaClosed Usada para automatizar a distribuição de interações com base nas competências, nas habilidades e no conhecimento dos agentes. ou DNISClosed O número discado em chamadas de voz de entrada ou de saída.. O benefício de usar um script de entrada para vários POCs é reduzir as chances de erros, mantendo as substituições de variáveis do caminho do arquivo definidas em apenas um local.

O script de entrada de exemplo contém uma ação BEGIN conectada a uma SNIPPET e a uma ação RUNSCRIPT, como mostrado na imagem a seguir.

A ação SNIPPET contém código que determina o nome e o caminho do script que está sendo executado. Essas informações são usadas para criar um caminho absoluto para as pastas que contêm os scripts, prompts, entre outros. Você pode escrever seu próprio código ou usar este exemplo:

SELECT
 {
  CASE runScript.length > 0 //Voice, Legacy Chat, Work Item
  {
   ASSIGN normalizedScriptName = "{runScript}"
  }
  CASE __runScript.length > 0 //Legacy Email
  {
   ASSIGN normalizedScriptName = "{__runScript}"  
  }
  CASE __targetScript.length > 0 //Simulate Inbound
  {
   ASSIGN normalizedScriptName = "{__targetScript}"
  }
  CASE __scriptName.length > 0 //Digital
  {
   ASSIGN normalizedScriptName = "{__scriptName}"
  }
  CASE customScript.length > 0 //Custom Outbound script
  {
   ASSIGN normalizedScriptName = "{customScript}"  
  }
  CASE __reskillscript.length > 0 //Custom Script assigned to skill on reskill
  {
   ASSIGN normalizedScriptName = "{__reskillscript}"  
  }
  CASE global:callSuppScript.length > 0 //Suppression script
  {
   ASSIGN normalizedScriptName = "{global:callSuppScript}"
  }
}
IF normalizedScriptName.length > 0
{
 ASSIGN folderArray = "{normalizedScriptName.split('\')}"
 ASSIGN env = "{folderArray[1]}"
 FOR i = 1 TO folderArray.size - 1
 {
  ASSIGN folderPath = "{folderPath}\{folderArray[i]}"
  }
}
IF env.length = 0
 {
  ASSIGN env = "DEV"
 }
ASSIGN scriptPath = "~{folderPath}\"
ASSIGN promptPath = "~{folderPath}\Prompts\"
ASSIGN grammarPath = "~{folderPath}\Grammars\"

Este código de exemplo usa uma SELECT statement com várias CASEs. Cada CASE representa uma das variáveis do sistema que pode conter o nome e o caminho do script atual. A variável usada em um script específico depende do tipo de script. O Snippet:

  1. Localiza a variável sistema que contém o caminho e o nome do script atual. Para isso, ela:

    1. Avalia cada CASE para verificar se o valor da variável especificada tem um comprimento maior que 0.
    2. Se isso ocorrer, o Snippet seleciona esse CASE e atribui o valor da variável à variável normalizedScriptName.
  2. Determina o nome da pasta de etapa do fluxo de trabalho de desenvolvimento em que o script está localizado. Para fazer isso, ele:

    1. Utiliza a função split() para converter o valor de normalizedScriptName em uma matriz usando o caractere de barra invertida (\) como delimitador e atribui o valor convertido a folderArray. Isso substitui todas as barras invertidas no caminho do script por um caractere de barra vertical (|), o que converte o caminho e o nome do script em uma matriz. Por exemplo, se o valor de normalizedScriptName for Prod\ScriptFolder3\ScriptExample1, o valor de folderArray se torna Prod|ScriptFolder3|ScriptExample1.

    2. Cria uma variável chamada env para armazenar o nome da pasta do estágio atual do fluxo de trabalho de desenvolvimento. O snippet preenche env com o conteúdo do primeiro elemento da matriz. Seguindo o exemplo da etapa anterior, env teria um valor de Prod.

  3. Cria o caminho para a pasta do script atual e o armazena em uma variável. O valor do caminho não inclui o nome do script. Para fazer isso, o snippet:

    1. Usa um loop FOR para adicionar o valor de cada elemento em folderArray a uma nova variável, folderPath, separados por uma barra invertida (\).

  4. Contém uma instrução IF que verifica se a variável env está preenchida com um valor (IF env.length = 0). Caso não esteja, ela aplica dev a ela como padrão. Essa instrução IF atua como um backup para o caso de algo acontecer durante a instrução IF anterior e env não ser preenchida.

    É importante que essa variável tenha um valor apropriado porque ela é comumente usada em scripts Studio para determinar o ambiente que está sendo usado em diversas situações nas quais o script interage com um sistema que pode ter uma versão de caixa de areia ou de desenvolvimento e uma versão de produção. Por exemplo, isso é comum em integrações com CRMsClosed sistemas de Terceiros que gerenciam itens como contatos, informações de vendas, detalhes de suporte e históricos de casos.. Você pode modificar o valor para corresponder ao nome da pasta de fase de desenvolvimento da sua organização.

  5. Define e popula variáveis para armazenar o caminho absoluto para a localização das seguintes pastas com base em folderPath:

    • As pastas que contêm os scripts que a RUNSCRIPT ação inicia, valor:

      ASSIGN scriptPath = "~{folderPath}\"

    • A pasta que contém os Prompts usados pelo script ou pelos Scripts subsequentes:

      ASSIGN promptPath = "~{folderPath}\Prompts\"

    • A pasta que contém os arquivos de gramática usados pelo script ou pelos scripts subsequentes:
      ASSIGN grammarPath = "~{folderPath}\Grammars\"

    Você pode criar variáveis adicionais para armazenar caminhos para as localizações de outros arquivos que sua organização utiliza, como correio de voz.

O Snippet anterior cria um caminho absoluto. Você pode usar essa variável em qualquer script subsequente que exija um caminho da pasta em um Snippet ou em uma configuração de propriedade de ação. Se a ação que você está usando for compatível com caminhos relativos, você pode optar por não usar a variável folderPath. No entanto, a prática recomendada em Studio é usar caminhos absolutos sempre que possível, mesmo quando caminhos relativos também forem compatíveis.

Personalizar Snippet de Script de entrada

Para permitir que o exemplo de snippet de script de entrada funcione com os seus scripts, você precisa personalizar algumas das variáveis:

  • scriptPath: Modifique o valor para incluir quaisquer nomes de subpastas ainda não incluídos na variável scriptPath, se aplicável.

  • promptPath: No valor atribuído, altere \Prompts\ para o nome da pasta em que seus arquivos de áudio de prompt pré-gravados estão salvos. Inclua os nomes de quaisquer subpastas, se aplicável.

  • grammarPath: Se você usar ASRClosed Reconhecimento automático de Fala. Permite que os contatos respondam aos prompts falando, pressionando teclas do telefone ou ambos., altere \Gramáticas\ no valor atribuído para o nome da pasta em que os arquivos de Gramática estão salvos, incluindo os nomes de quaisquer subpastas, se aplicável. Se você não usar ASR, você pode excluir essa variável.

Você pode modificar esses nomes de variáveis, se quiser. No entanto, se você alterar os nomes de variáveis que já foram usados em outros Scripts, deverá alterar todas as instâncias do nome antigo em seus Scripts. Não altere o nome de env.

Personalizações adicionais que você pode fazer incluem:

  • Se você tiver outras pastas às quais se refere em seus Scripts, adicione variáveis e configure seus valores adequadamente, seguindo o exemplo das variáveis existentes.

  • Na instrução IF a seguir, modifique o valor padrão atribuído a env para corresponder à pasta de nível superior para a sua fase de desenvolvimento:

    
    IF env.length = 0
     {
      ASSIGN env = "DEV"
     }

Configurar um script de entrada para iniciar vários Scripts

Você pode configurar um script de entrada para escolher qual script a ação RUNSCRIPT inicia. Isso é útil se você quiser usar o mesmo script de entrada para vários scripts principais.

Para configurar isso, adicione lógica de script ao SNIPPET no script de entrada que define como o script apropriado é selecionado. O exemplo a seguir usa uma instrução SWITCH com DNISClosed O número discado em chamadas de voz de entrada ou de saída. como critério de decisão. Você pode usar qualquer lógica e critérios de script compatíveis para atender às necessidades da sua organização. Para personalizar este código, certifique-se de que o valor de cada variável nextScript defina o script apropriado para seu critério. Inclua comentários com barras duplas (//) para fornecer explicações de cada script.

SWITCH DNIS // choose the next script based on a DNIS
{
CASE 8885551234  {
	ASSIGN nextScript = "{scriptPath}MainGreeting1"
  }
CASE 8005552345
  {
    ASSIGN nextScript = "{scriptPath}MainGreeting2" 
  }
CASE 6145554567  {
    ASSIGN nextScript = "{scriptPath}MainGreeting3" 
  }
DEFAULT
  {
    ASSIGN nextScript = "{scriptPath}MainGreeting4" 
  }

Use PATH VARIABLES em Scripts

Depois de configurar o seu script de entrada, você precisa usar as variáveis definidas nele em seus outros scripts.

Não modifique scripts de produção. Sempre trabalhe com a versão de desenvolvimento de um script quando possível. teste todas as alterações antes de promover o script de volta à produção. Fazer alterações diretamente em scripts de produção pode resultar em contatos não roteados para o ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail. afetado.

  1. Em Studio, percorra seus scripts e procure instâncias em que caminhos de arquivo são usados. Os Caminhos podem aparecer em configurações de propriedades, legendas, valores de variáveis e código de snippet. Em particular, observe ações como RUBSUB, RUNSCRIPT, SPAWN, MUSIC, PLAY, WHISPER, e qualquer uma das ASR ou ações relacionadas a arquivos. Você pode pesquisar scripts que contenham determinadas ações ou que tenham nomes de pastas em suas legendas.

  2. Substitua a parte apropriada do caminho do arquivo pela variável correspondente conforme definida no seu script de entrada. Por exemplo, se uma ação MENU tiver uma propriedade Sequência configurada para reproduzir 01MainGreetingMenu.wav, você a alteraria para "{promptPath}01MainGreetingMenu.wav". A imagem a seguir mostra vários exemplos disso em um script.