Music

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

A ação Music reproduz um arquivo de música para o contato.

Reproduz um arquivo de música para o contato. Music é normalmente usada para música em espera quando os contatos estão em uma fila ou em um cenário de espera. Você pode selecionar em 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 pela ação Music são faixas licenciadas criadas por músicos profissionais. Eles são sujeitos a relicenciamento periódico. Ocasionalmente, a licença em um arquivo pode não estar disponível para renovação. Quando isso acontece, a NICE CXone fornece uma faixa substituta de gênero similar. A música substituta funcionará perfeitamente em seu IVR Menu de telefone automatizado que permite que os chamadores interajam por meio de comandos de voz, entradas de teclas ou ambos para obter informações, encaminhar uma chamada de voz de entrada ou ambos. existente. A NICE CXone fornece aviso prévio das mudanças de arquivos de música para que você possa revisar a substituição e mudar sua seleção.

Dependências

Não funciona após o evento onAnswer, a menos que faça parte de um onHoldevento.
Nunca conecte uma ação Music a si mesma para criar um loop. Se você quiser que a música se repita, use uma ação Wait configurada com uma pausa curta, como meio segundo. Conecte Music a Wait e volte para Music.
Os arquivos padrão disponíveis com Music podem ter até cinco minutos de duração.

Tipos de script suportados

Telefone

Comparação de ações similares

As ações a seguir têm funções semelhantes, mas com algumas diferença importantes.

Music: reproduz um arquivo de música que somente o contato pode ouvir. Você pode escolher em uma lista de arquivos de música fornecidos. Você pode especificar um ponto inicial e final específico no arquivo. Não aceita a reprodução de arquivos de áudio personalizados.
Play: reproduz arquivos de áudio personalizados WAV ou prompts de conversão de texto em fala (TTS Permite que os usuários insiram prompts gravados como texto e usem uma voz gerada por computador para falar o conteúdo.). O arquivo inteiro é reproduzido. Somente o contato pode ouvir o áudio.
Playlog: reproduz arquivos de áudio WAV personalizados que apenas o contato pode ouvir. Ele permite que você selecione um ponto de partida e parada específico. Não é possível reproduzir os arquivos de música integrados a outras ações, como Music.
Reqagent: reproduz arquivos de áudio personalizados WAV ou prompts de conversão de texto em fala que apenas 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.
Whisper: 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 vinculados. A ação Reqagent tem uma propriedade Ziptone que reproduz um tom para o agente antes que o contato e o agente sejam vinculados.

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.

Propriedade	Descrição
Adicionar legenda	Insira uma frase curta que identifica exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação.
Music File	Permite selecionar um arquivo de música pré-gravado para ser reproduzido pela ação. Studio inclui 20 arquivos de música diferentes, em formato WAV para escolher. Se você deseja reproduzir um arquivo de música que enviou, pode fazê-lo usando a ação Playlog. Você pode usar uma variável para esta propriedade.
Start Offset	Permite que você inicie a reprodução do arquivo de áudio selecionado a partir de um ponto que você especificar em vez de no início. Insira o número de segundos desde o início do arquivo em que você 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 seja reproduzida desde o início do arquivo. Se a primeira ação Music for reproduzida por 30 segundos e você quiser que a segunda ação Music seja retomada no ponto em que a primeira parou, defina StartOffset como 30. O valor padrão para esta propriedade é 0, o que faz com que o arquivo seja reproduzido a partir do 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.
Seconds To Play	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 acontece, a condição de ramal OnComplete é atendida e o script segue esse caminho. Não há valor máximo, mas se você inserir um número maior que o tamanho do arquivo, o script seguirá o caminho do ramal OnComplete. A condição de ramificação Default é atendida quando SecondsToPlay é definido como algo maior que zero e menor que o comprimento total do arquivo. Substituição variável é comumente usada para esta propriedade.
Interrupt Messages	Permite inserir uma expressão de seqüência de caracteres que interrompe periodicamente a música com uma ou mais mensagens curtas na forma de arquivos .wav. A sua expressão, como mostrado no exemplo a seguir, deve usar esta sintaxe: Nome do arquivo de mensagens; SecondsToPlay. Message1.wav; 45 Message2.wav; 60 Message3.wav; 60 Embora este método funcione, ele pode causar problemas. Por exemplo, se uma mensagem for regravada posteriormente e for maior que a mensagem original, é possível que uma mensagem comece a ser reproduzida antes que a mensagem anterior termine. Portanto, o método recomendado para tocar música interrompida por mensagens periódicas é alternar ações Music com ações Play ou Playlog que forneçam as mensagens ou avisos apropriados.
Repeat Index	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 DTMF Tons de sinalização gerados quando um usuário pressiona ou toca em uma tecla do teclado do telefone. são processados enquanto a ação está em execução. Quando ativada, a ação processa e age com base em tons DTMF. A ação não captura os tons. Quando desativada, a ação ignora tons DTMF mesmo quando o contato aperta uma tecla no telefone. Por exemplo, você pode reproduzir uma mensagem de interrupção enquanto o contato está em espera que diz "Um agente estará com você em breve. Se preferir deixar uma mensagem de voz para que possamos ligar de volta, pressione a tecla asterisco." DetectDTMF precisaria ser definida como Ativada para que a ação pudesse processar o pressionamento de tecla do contato. Modo no valor Clicar em Não desativa esta opção. Clique em Ativada para ativar a ação que detecta e responde a tons DTMF. In Expression Mode: Insira false para desativar esta opção. Deixe-a definida como true para ativar a ação que detecta e responde a tons DTMF. Quando esta propriedade está habilitada e um contato pressiona uma tecla, ela aciona a ramificação Digit. Você pode usar substituição de variável nesta propriedade. Para fazer isso, defina esta propriedade como Modo de expressão e, em seguida, insira a variável no campo. Coloque a variável entre chaves ( { } ).
Clear Digits	Quando um contato pressiona teclas no telefone, um tom DTMF é gerado e armazenado em um buffer. ClearDigits permite determinar como essa ação trata os tons DTMF Tons de sinalização gerados quando um usuário pressiona ou toca em 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. Qualquer pressionamento de tecla ocorrido anteriormente no script não será passado 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. Defina como True para ativar ou False para desativar. Quando tons DTMF são passados para essa ação, o script imediatamente segue o caminho para a condição de ramal Digit. Modo no valor Clique em Não para desativar esta opção. Deixe-a definida como Sim para limpar o buffer DTMF. In Expression Mode: Insira false para desativar esta opção. Deixe-a definida como true para limpar o buffer DTMF.

Condições de 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	O caminho percorrido, a menos que o script atenda a uma condição que exige que ele execute um dos outros ramos. Também é usado se os outros ramos não estiverem definidos. Para Music, esse ramal também é tomado quando SecondsToPlay é definido como algo maior que zero e menor que a duração total do MusicFile selecionado.
Complete	Caminho percorrido quando a gravação é reproduzida até o final.
Paused	Esta condição de ramificação não é usada atualmente.
Digit	O caminho percorrido quando DetectDTMF é definido como True e o contato pressiona uma tecla em seu telefone durante a ação.

Exemplo de script

Este é um exemplo para mostrar como esta ação pode ser usada em scripts. Ele não é voltado para um script inteiro. Criação de script adicional pode ser necessária.

Neste exemplo de script parcial, a música é tocada enquanto o contato aguarda que um agente atenda. Após a reprodução da música 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.

Gostaria de fazer o download deste exemplo?