Music

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

La acción Music reproduce un archivo de música para que escuche el contacto.

Reproduce un archivo de música para que escuche el contacto. Music se usa normalmente para contener música cuando los contactos están en 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 pregrabados disponible mediante 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 sucede esto, NICE CXone ofrece una pista de reemplazo de un género similar. El reemplazo de música funcionará sin problemas en su IVR Menú telefónico automatizado que permite a las personas que llaman interactuar a través de comandos de voz, entradas de teclas o ambos, para obtener información, enrutar una llamada de voz entrante o ambos. existente. NICE CXone ofrece un aviso previo de los cambios en sus archivos de música, para que pueda analizar los reemplazos y cambiar su selección.

Dependencias

No funciona después del evento onAnswer, a menos que forme parte de un onHoldevento .
Nunca conecte una acción Music a sí misma para crear un bucle. Si desea que la música se repita, utilice una acción Wait configurada con una breve pausa, por ejemplo medio segundo. Conecte Music con Wait y, después, otra vez con Music.
Los archivos por defecto disponibles en Music pueden tener una duración de hasta cinco minutos.

Tipos de secuencias de comandos compatibles

Teléfono

Comparación de acciones similares

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

Music: Reproduce un archivo de música que solo puede escuchar el contacto. Puede elegir de una lista de archivos de música proporcionados. Puede especificar un punto de inicio y finalización específico en el archivo. No admite la reproducción de archivos de audio personalizados.
Play: Reproduce archivos WAV de audio personalizados o mensajes de texto a voz (TTS Permite a los usuarios ingresar indicaciones grabadas como texto y usar una voz generada por computadora para decir el contenido.). Se reproduce todo el archivo. Solo el contacto puede escuchar el audio.
Playlog: Reproduce archivos WAV personalizados que solo puede escuchar el contacto. Le permite seleccionar un punto específico de inicio y parada. No es posible reproducir archivos de música que estén integrados en otras acciones, como Music.
Reqagent: Reproduce archivos WAV de audio personalizados o mensajes de texto a voz que solo escucha el agente. El aviso se reproduce antes de que el agente y el contacto se vinculen, por lo que no genera un silencio al contacto.
Whisper: Reproduce archivos WAV personalizados o mensajes 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 se enlaza al contacto con el agente. La acción Reqagent tiene una propiedad Ziptone que reproduce un tono para el agente antes de enlazar al contacto con el agente.

Propiedades de entrada

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

Todas las propiedades de esta acción admiten la sustitución de variables.

Propiedad	Descripción
Agregar Leyenda	Ingrese 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.
Music File	Le permite seleccionar un archivo de música pre-grabado para ser jugado por la acción. Studio incluye 20 archivos de música diferentes, en formato WAV, entre los que elegir. Si desea reproducir un archivo de música que ha cargado, puede hacerlo mediante la acción Playlog en su lugar. Puede utilizar una variable para esta propiedad.
Start Offset	Le permite hacer que el archivo de audio seleccionado comience a reproducirse desde un punto que usted especifique, en lugar de hacerlo desde el principio. Ingrese la cantidad de segundos desde el comienzo del archivo donde 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 Music y una acción Wait, podría hacer que la primera acción Music se reproduzca desde el principio del archivo. Si la primera acción Music se reproduce durante 30 segundos y desea que la segunda acción Music reanude la reproducción en el punto donde se detuvo la primera, ponga StartOffset en 30. El valor predeterminado para esta propiedad es 0, lo que hace que se reproduzca el archivo desde el principio 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.
Seconds To Play	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 desde el principio hasta el final. Cuando sucede esto, se cumple la condición de la bifurcación OnComplete y el script adopta esa ruta. No hay un valor máximo, pero si ingresa un número mayor que la longitud del archivo, el script adopta la OnComplete ruta de la bifurcación. La condición de rama Default se cumple cuando Segundos por reproducir se define con un valor mayor que cero y menor que la longitud total del archivo. Con esta propiedad es habitual usar sustitución de variables.
Interrupt Messages	Le permite escribir una expresión de cadena que interrumpe periódicamente música con uno o varios mensajes cortos en forma de archivos .wav. Su expresión, según se muestra en el ejemplo siguiente, debe utilizar esta sintaxis: Nombre del archivo de mensajes;SecondsToPlay. Message1.wav; 45 Message2.wav; 60 Message3.wav; 60 Si bien este método funciona, puede causar problemas. Por ejemplo, si un mensaje es más tarde re-grabado y es más largo que el mensaje original, es posible que un mensaje para empezar a jugar antes de que el mensaje anterior ha terminado. Por lo tanto, el método preferido para reproducir música de manera interrumpida para mensajes periódicos es alternar acciones Music con acciones Play o Playlog que proporcionen los mensajes o avisos adecuados.
Repeat Index	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 Tonos de señalización que se generan cuando un usuario presiona o toca una tecla en el teclado de su teléfono. se procesa mientras la acción se ejecuta. Al estar habilitado, la acción procesa y actúa sobre los tonos DTMF. La acción no captura los tonos. Al estar desactivado, la acción ignora los tonos DTMF aún cuando el contacto presione alguna tecla en su teléfono. Por ejemplo, puede reproducir un mensaje de interrupción mientras el contacto está en espera que diga "Un agente estará con usted en breve. Si prefiere dejar un mensaje de voz para que podamos devolverle la llamada, presione la tecla de asterisco". DetectarDTMF tendría que estar configurado en Encendido para que la acción pudiera procesar la tecla presionada por el contacto. En modo valor: Haga clic en No para deshabilitar esta opción. Haga clic en Encendido para que la acción pueda detectar y responder a los tonos DTMF. En Modo de Expresiones: Ingrese falso para deshabilitar esta opción. Deje configurado en verdadero para que la acción pueda detectar y responder a los tonos DTMF. Cuando esta propiedad está habilitada y un contacto pulsa una tecla, activa la rama Digit. Puede utilizar la sustitución de variables en esta propiedad. Para hacer eso, configure esta propiedad en modo Expresión , después ingrese la variable en el campo. Encierre la variable entre llaves ( { } ).
Clear Digits	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 la forma en que esta acción maneja los tonos DTMF Tonos de señalización que se generan cuando un usuario presiona o toca una tecla en el teclado de su teléfono. que están en el búfer al iniciarse la acción. Al habilitar, esta opción limpia el búfer al iniciar la acción. Cualquier pulsación de tecla que haya ocurrido anteriormente en el script no se pasará 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. Ponga en Verdadero para habilitar o Falso para desactivar. Cuando se transfieren los tonos DTMF a esta acción, el script inmediatamente toma la ruta para la condición de rama Digit. En modo valor: Haga clic en No para desactivar esta opción. Deje configurado en Sí para vaciar el búfer de DTMF. En Modo de Expresiones: Ingrese falso para desactivar esta opción. Deje configurado en verdadero para vaciar el búfer de DTMF.

Condiciones de la rama de resultados

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

Condición	Descripción
Default	La ruta tomada a menos que la secuencia de comandos cumpla una condición que requiera que tome una de las otras ramas. También es tomado si las demás ramas no están definidos. Para Music, también se toma esta rama cuando SecondsToPlay se define en algo mayor que cero y menor que la longitud total de la seleccionada MusicFile.
Complete	Ruta tomada cuando la grabación se desempeñó hasta su finalización.
Paused	Esta condición de bifurcación no se utiliza actualmente.
Digit	La ruta adoptada cuando DetectDTMF se define 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. Quizá se requieran scripts adicionales.

En este ejemplo de script parcial, mientras se reproduce la música de espera de contacto de un agente para tomar la llamada. Después de que suene la música durante el tiempo definido en la propiedad SecondstoPlay, la acción Wait introduce una pausa antes de que se reanude la música. La acción Music ha sido renombrada, usando la propiedad Caption, para indicar el archivo .wav que se especifica en la propiedad MusicFile (CruisingJazz.wav).

De manera alternativa, puede utilizar la acción Playlog en lugar de la acción Wait, como se ha descrito anteriormente.

¿Desea descargar este ejemplo?