Music

Esta página de ayuda corresponde a Desktop Studio. Esta información también está disponible para Studio.

Ícono de Música: notas musicales con un botón de reproducción

Reproduce un archivo de música para el contacto. Music se usa normalmente como música de espera cuando los contactos están en una cola o en un escenario de espera. Puede seleccionar de una lista predeterminada de archivos de música. Esta acción no admite ningún tipo de archivo de audio personalizado. Puede elegir cuánto del archivo se reproduce, así como cuántos segundos en el archivo comienza a reproducirse la música.

Los archivos de música pregrabada disponibles a través de la acción Music SOn pistas con licencia creadas por músicos profesionales. Están sujetas a una concesión periódica de nuevas licencias. De manera ocasional, la licencia de un archivo puede no estar disponible para renovarse. Cuando esto sucede, NiCE proporciona una pista de reemplazo de un género similar. La música de reemplazo funcionará sin problemas en su IVR Interactive Voice Response. Automated phone menu contacts use via voice or key inputs to obtain information, route an inbound voice call, or both. existente. NiCE proporciona un aviso anticipado de los cambios en los archivos de música de NiCE CXone para que pueda revisar el reemplazo y cambiar su selección.

Dependencias

No funciona después del evento onAnswer a menos que sea parte de un onhold evento.
Nunca conecte una acción Música a sí misma para crear un bucle. Si desea que la música se repita, use una acción Wait configurada con una pausa corta, como medio segundo. Conecte Música a Wait y luego de regreso a Música.
Los archivos predeterminados disponibles con Música pueden tener una duración de hasta cinco minutos.

Tipos de secuencias de comandos compatibles

El ícono para el tipo de script Teléfono: un auricular de teléfono de estilo antiguo con líneas curvas que indican que sale sonido de él.

Teléfono

Comparación de Acciones Similares

Las siguientes acciones tienen funciones similares, pero con algunas diferencias clave:

Music : Plays a music file that only the contact can hear. You can choose from a list of provided music files. You can specify a specific starting and stopping point in the file. Doesn't support playing custom audio files.
Play : Reproduce archivos WAV de audio personalizados o avisos de texto a voz (TTS Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content.). Si se utiliza un archivo, se reproduce el archivo completo. Solo el contacto puede escuchar el audio.
Playlog: Reproduce archivos de audio WAV personalizados que solo el contacto puede escuchar. Le permite seleccionar un punto específico de inicio y parada. No se pueden reproducir los archivos de música integrados en otras acciones, como Music.
Reqagent: Reproduce archivos WAV de audio personalizados o un mensaje de texto a voz que solo el agente escucha. El aviso se reproduce antes de que el agente y el contacto se vinculen, por lo que no genera un silencio al contacto.
susurrar: Reproduce archivos WAV personalizados o avisos de texto a voz. Puede configurarlo para que lo escuche solo el contacto, solo el agente o ambos. El aviso se reproduce después de que el agente y el contacto se vinculan, por lo que si la acción se reproduce solo para el agente o el contacto, la otra parte escucha un silencio que dura lo mismo que el aviso.
Ziptone: Reproduce un tono para el agente después de que el contacto y el agente se vinculen. La acción Reqagent tiene una propiedad Ziptone que reproduce un tono para el agente antes de que el contacto y el agente se vinculen.

Propiedades de entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Todas las propiedades de esta acción aceptan sustitución de variables. Para hacerlo, ingrese la variable en el campo de propiedad. Encierre la variable entre llaves ( { } ).

Propiedad	Descripción
Leyenda	Introduzca una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción. El valor predeterminado es el nombre de acción.
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. Con esta propiedad es habitual usar sustitución de variables. Esta propiedad debe estar configurada. Si este campo queda vacío, puede causar problemas en el servidor. ```
StartOffset	``` Permite que el archivo de audio seleccionado comience a reproducirse desde un punto que usted especifique en lugar de desde el principio. Ingrese el número de segundos desde el inicio del archivo en el que desea que la acción comience a reproducir el audio. Con esta propiedad es habitual usar sustitución de variables. Por ejemplo, si tiene un bucle de DOs acciones de Music y una acción de Wait, podría hacer que la primera acción de Music se reproduzca desde el inicio del archivo. Si la primera acción de Music se reproduce durante 30 segundos y desea que la segunda acción de Music reanude la reproducción en el punto donde se detuvo la primera, establezca StartOffset en 30. El valor predeterminado para esta propiedad es 0, lo que hace que el archivo se reproduzca desde el inicio cada vez. No hay un valor máximo, pero si ingresa un valor mayor que la longitud del archivo de música, la acción reproduce el archivo desde el principio. ```
SecondstoPlay	Le permite reproducir una parte del archivo de audio seleccionado. Introduzca el número de segundos del archivo que desea reproducir. El valor predeterminado es 0, lo que significa que el archivo de música se reproduce de principio a fin. Cuando esto sucede, se cumple la condición de la ramificación OnComplete y el script toma esa ruta. No existe un valor máximo, pero si ingresa un número mayor que la longitud del archivo, el script toma la ruta de la rama OnComplete. La condición de la ramificación Default se cumple cuando SecondsToPlay se establece en cualquier valor mayor que cero y menor que la longitud total del archivo. Con esta propiedad es habitual usar sustitución de variables.
InterruptMessages	``` Permite que la música se interrumpa periódicamente con uno o más mensajes breves. Por ejemplo, puede agradecer a los contactos por esperar o recordarles las opciones de autoservicio disponibles en su sitio web. Introduzca el nombre del archivo de mensajes seguido del número de segundos del archivo de música para reproducir después del mensaje. Si tiene diferentes mensajes que desea reproducir, inclúyalos todos. Use la siguiente sintaxis en este campo: <NameOfFile.wav>;<SecondsToPlay>. Por ejemplo: Thanks.wav;20 HelpYourSelf.wav;20 Reminder.wav;20 Este método funciona, pero conlleva ciertos riesgos. Por ejemplo, si uno de los archivos de audio que usa está pregrabado y ahora es más largo que el mensaje original, es posible que un mensaje comience a reproducirse antes de que finalice el anterior. El método preferido para implementar mensajes de interrupción es alternar acciones de Music con acciones de Play o Playlog que proporcionen los mensajes o avisos. Usted puede grabar sus mensajes utilizando una aplicación de terceros y cargarlos en NiCE CXone. ```
RepeatIndex	Establezca esta propiedad en el número de veces que desea que los mensajes de interrupción repitan. Si no configuró un mensaje de interrupción, puede omitir esta propiedad.
DetectDTMF	``` Determina si los tonos DTMF Signaling tones that are generated when a contact presses a key on the telephone keypad. se procesa mientras la acción se ejecuta. El valor predeterminado es True, lo que significa que los tonos Dtmf se procesan si el contacto presiona una tecla y se activa la rama OnDigit del script. Si el valor se establece en False, los tonos DTMF no se procesan aunque el contacto presione una clave. Por ejemplo, puede reproducir un mensaje en el punto de contacto se coloca en la cola que dice, "un agente estará con usted en breve. Para salir de la cola en cualquier momento, presione la tecla de asterisco". La rama OnDigit podría entonces ofrecer al contacto la opción de dejar un mensaje de voz. Esta propiedad no captura los tonos DTMF. Si necesita evaluar un tono ingresado, use un Capture /Actions/CAPTURE/CAPTURE.htm" target="_blank">acción después de esta acción para asignar el tono a una variable. Después, puede evaluar el valor de la variable para determinar qué tono se ingresó. Con esta propiedad es habitual usar sustitución de variables. ```
ClearDigits	Cuando un contacto presiona teclas en su teléfono, se genera un tono DTMF y se almacena en un búfer. ClearDigits le permite determinar cómo esta acción maneja los tonos DTMF Signaling tones that are generated when a contact presses a key on the telephone keypad. que se encuentran en el búfer cuando se inicia la acción. Al habilitar, esta opción limpia el búfer al iniciar la acción. Las pulsaciones de tecla que hayan ocurrido anteriormente en el script no se pasarán a esta acción. Si se desactiva esta opción, la acción procesa y actúa sobre cualquier tono DTMF que se transfiere a la acción mediante el búfer. Establézcalo en True para habilitar o False para deshabilitar. Cuando los tonos DTMF se pasan a esta acción, el script toma inmediatamente la ruta para la condición de bifurcación OnDigit. Configure en True para habilitar esta opción o en Falso para deshabilitarla.

Condiciones de la rama de resultado

Las condiciones de las ramas de resultado le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecuta una acción.

Condición	Descripción
Por defecto	El camino tomado a menos que el script cumpla con una condición que requiera que tome una de las otras ramas. También se toma si las otras ramas no están definidas. Para Music, esta ramificación también se toma cuando SecondsToPlay se establece en cualquier valor mayor que cero y menor de la longitud total del MusicFile seleccionado.
OnComplete	La ruta que se toma cuando el archivo de audio seleccionado se reproduce de principio a fin.Esto también puede suceder cuando SecondsToPlay está configurado con 0 o si está configurado con un valor mayor que la longitud del archivo.
OnPaused	Esta condición de bifurcación no se utiliza actualmente.
OnDigit	La ruta tomado cuando DetectDTMF se establece en True y el contacto presiona una tecla en su teléfono durante la acción.

Ejemplo de script

Este es un ejemplo para demostrar cómo se puede utilizar esta acción en los scripts. No pretende ser un script completo. Es posible que se requiera scripting adicional.

En este ejemplo de script parcial, se reproduce música mientras el contacto espera que un agente atienda la llamada. Después de que la música se reproduce durante el período establecido en la propiedad SecondstoPlay, la acción Wait introduce una pausa antes de que la música se reanude. La acción Music ha sido renombrada, utilizando la propiedad Caption, para indicar el archivo WAV especificado en la propiedad MusicFile (CruisingJazz.wav).

De manera alternativa, podría usar la acción Playlog en lugar de la acción Wait, como se describió anteriormente.

Ejemplo de script que usa la acción Música

¿Desea descargar este ejemplo?