Music

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

Ícone de Música: notas musicais com um botão de reprodução

Reproduz um arquivo de música para o contato. Music normalmente é usado como música de espera quando os contatos estão em uma fila DE espera ou em um cenário de espera. Você pode selecionar a partir de uma lista padrão de arquivos de música. Esta ação não é compatível com nenhum tipo de arquivo de áudio personalizado. Você pode escolher quanto do arquivo será reproduzido, bem como quantos segundos no arquivo a música começará a tocar.

Os arquivos de música pré-gravados disponíveis por meio da ação Music são faixas licenciadas criadas por músicos profissionais. Eles são sujeitos a relicenciamento periódico. A licença de um arquivo pode, ocasionalmente, não estar disponível para renovação. Quando isso acontece, NiCE fornece uma faixa substituta de um gênero semelhante. A música de substituição funcionará perfeitamente em seu 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. existente. NiCE fornece aviso prévio de alterações nos arquivos de música de NiCE CXone para que você possa revisar a substituição e alterar sua seleção.

Dependências

  • Não funciona depois do evento onAnswer, a menos que seja parte de um onHold evento.
  • Nunca conecte uma ação Música a ela mesma para criar um loop. Se desejar que a música se repita, use uma ação Wait configurada com uma pausa curta, como meio segundo. Conecte Música a Wait e depois de volta a Música.
  • Os arquivos padrão disponíveis com Música podem ter até cinco minutos de duração.

Tipos de script suportados

O ícone do tipo de script Telefone - um fone de telefone de estilo antigo com linhas curvas indicando som saindo dele.

Telefone

Comparação para ações similares

As ações a seguir têm funções semelhantes, mas com algumas diferenças chave:

  • Music : Reproduz um arquivo de música que somente o contato pode ouvir. Você pode escolher a partir de uma lista de arquivos de música fornecidos. Você pode especificar um ponto de início e de parada específico no arquivo. Não oferece suporte à reprodução de arquivos de áudio personalizados.
  • 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.
  • Ziptone: Reproduz um tom para o agente depois que o contato e o agente são conectados. A ação Reqagent tem uma propriedade Ziptone que reproduz um tom para o agente antes que o contato e o agente sejam conectados.

Propriedades de entrada

Estas propriedades definem dados que a ação usa durante a execução.

Todas as propriedades desta ação aceitam a substituição de variáveis. Para fazer isso, insira a variável no campo de propriedade. Coloque a variável entre chaves ( { } ).

Propriedade

Descrição

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. O padrão é o nome da ação.

MusicFile

Select the audio file from the drop-down. A selection of 20 music files in WAV format are provided. A quiet and a default version of each music file are available. The volume of quiet files is approximately 20% softer than the default versions. If you want to use a custom music or audio file, use the Playlog action. Substituição variável é comumente usada para esta propriedade.

Esta propriedade deve ser configurada. Se este campo for deixado em branco, isso pode causar problemas no servidor.

StartOffset

Permite que o arquivo de áudio selecionado comece a ser reproduzido a partir de um ponto especificado por você, em vez de desde o início. Insira o número de segundos a partir do início do arquivo em que deseja que a ação comece a reproduzir o áudio. Substituição Variável é comumente usada para esta propriedade.

Por exemplo, se você tiver um loop de duas ações Music e uma ação Wait, você pode fazer com que a primeira ação Music toque desde o início do arquivo. Se a primeira ação Music tocar por 30 segundos e você quiser que a segunda ação Music continue reproduzindo a partir do ponto em que a primeira parou, defina StartOffset como 30.

O valor padrão desta propriedade é 0, o que faz com que o arquivo seja reproduzido desde o início todas as vezes. Não há valor máximo, mas se você inserir um número maior que a duração do arquivo de música, a ação reproduzirá o arquivo a partir do início.

SecondstoPlay

Permite reproduzir uma parte do arquivo de áudio selecionado. Digite o número de segundos do arquivo que você deseja reproduzir.

O valor padrão é 0, o que significa que o arquivo de música é reproduzido do início ao fim. Quando isso ocorre, a condição do branch OnComplete é atendida e o script segue esse caminho.

Não há valor máximo, mas, se você inserir um número maior do que o tamanho do arquivo, o script seguirá o caminho da ramificação OnComplete.

A condição da ramificação Default é atendida quando SecondsToPlay é definido como qualquer valor maior que zero e menor do que o comprimento total do arquivo.

Substituição variável é comumente usada para esta propriedade.

InterruptMessages

Permite que a música seja periodicamente interrompida com uma ou mais mensagens curtas. Por exemplo, você pode agradecer aos contatos por estarem em espera ou lembrá-los sobre as opções de autoatendimento disponíveis no seu site.

Digite o nome DO arquivo de mensagem seguido pelo número de segundos do MusicFile a ser reproduzido após a mensagem. Se você tiver mensagens diferentes que deseja reproduzir, inclua todas elas. Use a seguinte sintaxe neste campo: <NameOfFile.wav>;<SecondsToPlay>. Por exemplo:

Thanks.wav;20 HelpYourSelf.wav;20 Reminder.wav;20

Este método funciona, mas tem alguns riscos associados a ele. Por exemplo, se um dos arquivos de áudio que você usa foi regravado e agora está maior do que o original, é possível que uma mensagem comece a ser reproduzida antes que a anterior termine. O método preferencial de implementar interromper mensagens é alternar ações Music com ações Play ou Playlog que fornecem as mensagens ou os prompts.

Você pode gravar suas mensagens usando um aplicativo de terceiros e fazer upload para NiCE CXone.

RepeatIndex

Configure esta propriedade para o número de vezes que você deseja que o InterruptMessages se repita. Se você não configurou uma mensagem de interrupção, você pode omitir esta propriedade.

DetectDTMF

Determina se os tons de Dtmf são processados enquanto a ação está em execução. O valor padrão é True, o que significa que os tons de Dtmf são processados se o contato pressionar uma tecla e a ramificação OnDigit do script for acionada. Se o valor for definido como False, os tons de Dtmf não serão processados mesmo que o contato pressione uma tecla. Por exemplo, você pode reproduzir uma mensagem no ponto em que um contato é colocado em fila, que diz: "Um agente estará com você em breve. Para sair da fila a qualquer momento, pressione a tecla asterisco". A ramificação OnDigit pode então oferecer ao contato a opção de deixar uma mensagem de correio de voz.

Esta propriedade não captura tons DTMF. Se você precisar avaliar um tom inserido, use uma Capture ação após esta ação para atribuir o tom a uma variável. Você pode avaliar o valor da variável para determinar qual tom foi inserido.

Substituição variável é comumente usada para esta propriedade.

ClearDigits

Quando um contato pressiona teclas em seu telefone, um tom DTMF é gerado e armazenado em um buffer. ClearDigits permite que você determine como esta ação trata os tons DTMFClosed Tons de sinalização gerados quando um contato pressiona uma tecla do teclado do telefone. que estão no buffer quando a ação é iniciada.

Se ativada, esta opção limpa o buffer quando a ação é iniciada. Quaisquer teclas pressionadas que ocorreram anteriormente no script não serão passadas para esta ação. Caso desative esta opção, a ação processa e toma ações com base nos tons DTMF passados a ela por meio do buffer. Definido como True para habilitar ou False para desabilitar. Quando os tons Dtmf são passados para esta ação, o script segue imediatamente o caminho para a condição de ramificação OnDigit.

Defina como True para ativar esta opção ou False para desativá-la.

Condições do resultado da Ramificação

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

O caminho ocupado, a menos que o script atenda a uma condição que exija que ele siga uma das outras ramificações. Ele também é ocupado se as outras ramificações não estiverem definidas.

Para Music, este ramo também é seguido quando SecondsToPlay estiver definido como qualquer valor maior do que zero e menor do que o comprimento total do MusicFile selecionado.

OnComplete

O caminho percorrido quando o arquivo de áudio selecionado é reproduzido do início ao fim.Isso também pode acontecer quando SecondsToPlay está definido como 0 ou se estiver definido como um valor maior que o comprimento do arquivo.

OnPaused

Esta condição de ramificação não é usada atualmente.

OnDigit

O caminho ocupado quando DetectDTMF é definido como True e o contato pressiona uma tecla no telefone durante a ação.

Script Exemplo

Este é um exemplo para mostrar como essa ação pode ser usada em Scripts. Ele não é voltado para um script inteiro. Pode ser necessário um script adicional.

Neste exemplo de script parcial, a música é reproduzida enquanto o contato espera que um agente atenda à chamada. Depois que a música é reproduzida pelo período estabelecido na propriedade SecondstoPlay, a ação Wait introduz uma pausa antes que a música seja retomada. A ação Music foi renomeada, usando a propriedade Caption, para indicar o arquivo WAV especificado na propriedade MusicFile (CruisingJazz.wav).

Como alternativa, você pode usar a ação Playlog em vez da ação Wait, conforme descrito anteriormente.

Exemplo de script usando a ação Música

Você gostaria de fazer o download deste exemplo?