Music

Cette page d'aide concerne CXone Studio. Ces informations sont également disponibles pour Desktop Studio.

L'action Music lit un fichier musical pour le contact.

Lit un fichier musical pour le contact. L’action Music est généralement utilisée pour jouer de la musique aux contacts lorsqu’ils sont dans la file d’attente ou dans un scénario de mise en attente. Vous pouvez sélectionner une musique dans une liste par défaut de fichiers musicaux. Cette action ne prend pas en charge les fichiers audio personnalisés, quel que soit leur type. Vous pouvez choisir la portion du fichier qui est lue (durée) et le nombre de secondes à partir duquel la lecture commence.

Les fichiers musicaux préenregistrées disponibles par le biais de l’action Music sont des pistes sous licence créées par des musiciens professionnels. Elles font l’objet d’un octroi de licence périodique. Il arrive que la licence d’un fichier ne soit pas renouvelée. Lorsque cela se produit, NICE CXone fournit une piste de remplacement du même genre. La musique de remplacement fonctionne de manière transparente dans l’IVR Menu téléphonique automatisé qui permet aux appelants d'interagir via des commandes vocales, des entrées de touches, ou les deux, pour obtenir des informations, acheminer un appel vocal entrant, ou les deux. déjà en place. NICE CXone vous informe à l’avance des modifications apportées aux fichiers musicaux afin que vous puissiez examiner le fichier de remplacement et modifier votre sélection.

Dépendances

Ne fonctionne pas après l’événement onAnswer sauf si elle fait partie d’un onHoldévénement .
Ne connectez jamais une action Music à elle-même pour créer une boucle. Si vous souhaitez que la musique se répète, utilisez une action Wait configurée avec une courte pause, d’une demi-seconde par exemple. Connectez Music à Wait, puis de nouveau à Music.
Les fichiers par défaut disponibles avec Music peuvent durer jusqu’à cinq minutes.

Types de scripts pris en charge

Téléphone

Comparaison d'actions similaires

Les actions suivantes ont des fonctions similaires, mais présentent quelques différences essentielles :

Music : lit un fichier musical que seul le contact peut entendre. Vous pouvez choisir parmi une liste de fichiers musicaux fournis. Vous pouvez spécifier des points de début et de fin précis dans le fichier. La lecture de fichiers audio personnalisés n’est pas prise en charge.
Play : lit des fichiers WAV personnalisés ou des invites synthèse vocale (TTS Permet aux utilisateurs de saisir des invites enregistrées sous forme de texte et d'utiliser une voix générée par ordinateur pour lire le contenu.). Le fichier entier est lu. Seul le contact peut entendre l'audio.
Playlog : lit des fichiers audio (WAV) personnalisés que seul le contact peut entendre. Vous pouvez sélectionner des points de début et de fin précis. Il est impossible de lire les fichiers musicaux qui sont intégrés à d’autres actions, comme Music.
Reqagent : lit des audio (WAV personnalisés ou une invite de synthèse vocale que seul l’agent peut entendre. Pour éviter que le contact entende un temps de silence, l’invite est lue avant que l’agent et le contact soient mis en relation.
Whisper : lit des fichiers WAV personnalisés ou des invites de synthèse vocale. Vous pouvez déterminer que ces fichiers soit audibles par le contact uniquement, l'agent uniquement ou les deux. L’invite est lue après la mise en relation de l’agent et du contact ; par conséquent, si l’action lit l’invite uniquement à l’agent ou au contact, l’autre partie entend un silence pendant ce temps.
Ziptone : lit une tonalité à l’agent après mise en relation du contact et de l’agent. L’action Reqagent possède une propriété Ziptone qui lit une tonalité à l’agent avant que l’agent et le contact soient mis en relation.

Propriétés d'entrée

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Toutes les propriétés de cette action acceptent la substitution de variables.

Propriété	Description
Ajouter une légende	Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action.
Music File	Vous permet de sélectionner un fichier musical préenregistré à lire par l'action. Studio comprend 20 fichiers musicaux différents, au format WAV, parmi lesquels choisir. Si vous souhaitez lire un fichier musical que vous avez téléchargé, vous pouvez le faire en utilisant l'action Playlog à la place. Vous pouvez utiliser une variable pour cette propriété.
Start Offset	Permet de lancer la lecture du fichier audio sélectionné à partir d’un point spécifique, plutôt qu’à partir du début. Entrez le nombre de secondes à partir du début du fichier pour définir le point de départ de la lecture de l’audio. La substitution de variable est couramment utilisée pour cette propriété. Par exemple, si vous avez une boucle de deux actions Music et une action Wait, vous pouvez lire la première action Music depuis le début du fichier. Si la première action Music est lue pendant 30 secondes et que vous voulez reprendre la lecture avec la deuxième action Music au point où la première action s’est arrêtée, définissez StartOffset sur 30. La valeur par défaut de cette propriété est 0, ce qui entraîne la lecture du fichier depuis le début à chaque fois. Il n’y a pas de valeur maximale, mais si vous entrez une valeur supérieure à la longueur du fichier musical, l’action lit le fichier à partir du début.
Seconds To Play	Permet de lire un passage du fichier audio sélectionné. Saisissez le nombre de secondes du fichier que vous souhaitez lire. La valeur par défaut est 0, ce qui signifie que le fichier musical est lu dans son intégralité. Dans ce cas, la condition de branche OnComplete est remplie et le script prend ce chemin. Il n’y a pas de valeur maximale, mais si vous entrez une valeur supérieure à la longueur du fichier, le script emprunte la branche OnComplete. La condition de branche Default est remplie lorsque SecondsToPlay a une valeur supérieure à zéro et inférieure à la durée totale du fichier. La substitution de variable est couramment utilisée pour cette propriété.
Interrupt Messages	Vous permet d'entrer une expression de chaîne qui interrompt périodiquement la musique avec un ou plusieurs messages courts sous la forme de fichiers .wav. Votre expression, comme illustré dans l'exemple suivant, doit utiliser cette syntaxe : Nom du fichier de messages; SecondsToPlay. Message1.wav;45 Message2.wav;60 Message3.wav;60 Bien que cette méthode fonctionne, elle peut causer des problèmes. Par exemple, si un message est réenregistré ultérieurement et qu'il est plus long que le message d'origine, il est possible qu'un message commence à être lu avant la fin du message précédent. Par conséquent, la méthode préférée pour jouer de la musique interrompue par des messages périodiques consiste à alterner les actions Music avec les actions Play ou Playlog qui fournissent les messages ou invites appropriés.
Repeat Index	Pour cette propriété, définissez le nombre voulu de répétitions de InterruptMessages. Si vous n’avez pas configuré de message d’interruption, vous pouvez omettre cette propriété.
DetectDTMF	Détermine si les tonalités DTMF Tonalités de signalisation générées lorsqu'un utilisateur appuie ou appuie sur une touche de son clavier téléphonique. sont traitées pendant l'exécution de l'action. Lorsqu’elle est activée, l’action traite les tonalités DTMF et agit en fonction. L’action ne capture pas les tonalités. Lorsqu’elle est désactivée, l’action ignore les tonalités DTMF même si le contact appuie sur une touche de son téléphone. Par exemple, pendant que le contact est en attente, vous pouvez lire un message d’interruption du type « Un agent va bientôt vous répondre. Si vous préférez laisser un message vocal pour que nous vous rappelions, appuyez sur la touche étoile. » DetectDTMF doit être défini sur Oui pour que l’action puisse traiter les touches enfoncées par le contact. En mode Valeur: Cliquez pour basculer sur Non afin de désactiver cette option. Cliquez pour basculer sur Activé afin que l’action détecte les tonalités DTMF et y réagisse. En mode Expression : Entrez faux pour désactiver cette option. Laissez sur vrai pour que l’action détecte les tonalités DTMF et y réagisse. Lorsque cette propriété est activée et que le contact appuie sur une touche, elle déclenche la branche Digit. Vous pouvez utiliser la substitution de variable dans cette propriété. Pour ce faier, définissez la propriété sur le mode Expression , puis entrez la variable dans le champ. Placez la variable entre accolades ( { } ).
Clear Digits	Lorsqu’un contact appuie sur les touches du téléphone, une tonalité DTMF est générée et stockée dans un tampon. ClearDigits permet de déterminer comment cette action traite les tonalités DTMF Tonalités de signalisation générées lorsqu'un utilisateur appuie ou appuie sur une touche de son clavier téléphonique. qui se trouvent dans le tampon lorsque l’action débute. Activée, cette option vide le tampon lorsque l’action commence. Si des touches ont été enfoncées plus tôt dans le script, elles ne sont pas transmises à cette action. Si vous désactivez l’option, l’action traite les tonalités DTMF qui lui sont transmises par le biais du tampon et agit en conséquence. Réglez-la sur Vrai pour l’activer ou sur Faux pour la désactiver. Lorsque des tonalités DTMF sont transmises dans l’action, le script prend immédiatement le chemin de la condition de branche Digit. En mode Valeur: Cliquez pour basculer sur Non afin de désactiver cette option. Laissez sur Oui pour vider le tampon DTMF. En mode Expression : Entrez faux pour désactiver cette option. Laissez sur vrai pour vider le tampon DTMF.

Conditions de branche résultantes

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition	Description
Default	Le chemin suivi sauf si le script remplit une condition qui l’oblige à emprunter l’une des autres branches. Il est également pris si les autres branches ne sont pas définies. Pour Music, cette branche est également suivie lorsque SecondsToPlay est réglé sur toute valeur supérieure à zéro et inférieure à la durée totale du MusicFile sélectionné.
Complete	Chemin emprunté lorsque l'enregistrement est terminé.
Paused	Cette condition de branche n’est pas utilisée actuellement.
Digit	Le chemin emprunté si DetectDTMF est défini sur True et que le contact appuie sur une touche de son téléphone au cours de l’action.

Exemple de script

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s'agit pas d'un script complet. Une rédaction de script supplémentaire peut être requise.

Dans cet exemple de script partiel, la musique est lue pendant que le contact attend qu'un agent prenne l'appel. Après la lecture de la musique pendant la période établie dans la propriété SecondstoPlay, l'action Wait insère une pause avant la reprise de la musique. L'action Music a été renommée, en utilisant la propriété Caption, afin d’indiquer le fichier .wav spécifié dans la propriété MusicFile (CruisingJazz.wav).

Alternativement, vous pouvez utiliser l'action Playlog au lieu de l'action Wait, comme expliqué précédemment.

Voudriez-vous télécharger cet exemple ?