Music

Cette page d’aide concerne CXone Studio. Cette information est également disponible pour Desktop Studio.

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

Lit un fichier musical pour le contact. Music est généralement utilisé pour la musique d’attente lorsque les contacts sont dans une file d’attente ou dans un scénario d’attente. Vous pouvez choisir parmi une liste de fichiers musicaux par défaut. Cette action ne prend en charge aucun type de fichier audio personnalisé. Vous pouvez choisir combien de fichiers jouent, ainsi que le nombre de secondes dans le fichier pendant lesquelles la musique commence à jouer.

Les fichiers musicaux préenregistrés disponibles par l’intermédiaire de l’action Music sont des morceaux sous licence créés par des musiciens professionnels. Ils font l’objet d’un renouvellement de licence périodique. Il peut arriver que la licence d’un fichier ne puisse pas être renouvelée. Lorsque cela se produit,NICE CXone fournit une piste de remplacement d’un genre similaire. La musique de remplacement fonctionnera de manière transparente dans votre SRVI 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.. NICE CXone vous informe à l’avance des modifications apportées aux fichiers musicaux afin que vous puissiez examiner le remplacement et modifier votre sélection.

Dépendances

Ne fonctionne pas après l’événement onAnswer, sauf s’il 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, telle qu’une demi-seconde. Connectez Music à Wait et ensuite à Music.
Les fichiers par défaut disponibles sur 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 semblables, mais avec quelques différences essentielles :

Music 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 un point de départ et d’arrêt spécifique dans le fichier. Ne prend pas en charge la lecture de fichiers audio personnalisés.
Play Play : Lit des fichiers audio WAV personnalisés ou des invites de synthèse texte-parole (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 prononcer le contenu.). Le fichier entier est lu. Seul le contact peut entendre le son.
Playlog Playlog : Lit des fichiers audio WAV personnalisés que seul le contact peut entendre. Il vous permet de sélectionner un point de départ et d’arrêt spécifique. Impossible de lire les fichiers musicaux intégrés à d’autres actions, telles que Music.
Reqagent Reqagent : Lit des fichiers audio personnalisés (WAV) ou des invites de synthèse texte-parole que seul l’agent peut entendre. L’invite est lue avant que l’agent et le contact ne soient liés, de sorte que l’invite n’entraîne pas de silence pour le contact.
Whisper Whisper : Lit des fichiers WAV personnalisés ou des invites de synthèse texte-parole. Vous pouvez le configurer pour qu’il soit audible par le contact uniquement, l’agent uniquement ou les deux. L’invite est lue une fois que l’agent et le contact sont liés. Si l’action n’est lue que pour l’agent ou le contact, l’autre partie entend un silence pendant la durée de l’invite.
Ziptone Ziptone : Joue une tonalité pour l’agent après que le contact et l’agent ont été liés. L’action Reqagent a une propriété Ziptone qui joue une tonalité pour l’agent avant que le contact et l’agent ne soient liés.

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
Add Caption	Saisissez une courte phrase qui identifie de manière unique cette action dans le script. La légende apparaît dans le canevas de script sous l’icône d’action.
Music File	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éversé, vous pouvez utiliser l’action Playlog. Vous pouvez utiliser une variable pour cette propriété.
Start Offset	Vous permet de faire en sorte que le fichier audio sélectionné commence à jouer à partir d’un point que vous spécifiez plutôt qu’à partir du début. Entrez le nombre de secondes à partir du début du fichier où vous souhaitez que l'action commence à lire l'audio. La substitution de variables 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 faire en sorte que la première action Music soit lue depuis le début du fichier. Si la première action Music joue pendant 30 secondes et que vous souhaitez que la seconde action Music reprenne à l’endroit où la première s’est arrêtée, définissez StartOffset sur 30. La valeur par défaut de cette propriété est 0, ce qui a pour effet de rejouer le fichier depuis le début à chaque fois. Il n’y a pas de valeur maximale, mais si vous saisissez une valeur supérieure à la longueur du fichier musical, l’action lit le fichier à partir du début.
Seconds To Play	Vous permet de lire une partie du fichier audio sélectionné. Entrez 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 du début à la fin. Dans ce cas, la condition de branche OnComplete est remplie et le script emprunte ce chemin. Il n’y a pas de valeur maximale, mais si vous saisissez un nombre supérieur à la longueur du fichier, le script prend le chemin de la branche OnComplete. La condition de branche Default est remplie lorsque SecondsToPlay est supérieur à zéro et inférieur à la longueur totale du fichier. La substitution de variables est couramment utilisée pour cette propriété.
Interrupt Messages	Permet d’entrer une expression de chaîne de caractères qui interrompt périodiquement la musique avec un ou plusieurs messages courts sous la forme de fichiers .wav. Votre expression, comme le montre 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 entraîner des problèmes. Par exemple, si un message est réenregistré plus tard et qu’il est plus long que le message original, 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 diffuser 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 les invites appropriés.
Repeat Index	Définissez cette propriété sur le nombre de fois que vous souhaitez que les InterruptMessages se répètent. 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 du clavier de son téléphone. sont traitées pendant l'exécution de l'action. Lorsqu’elle est activée, l’action de traiter et d’agir sur les tonalités DTMF. L’action ne capture pas les tonalités. Si cette option 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, vous pouvez diffuser un message d'interruption pendant que le contact est en attente, indiquant « Un agent sera bientôt avec vous. Si vous préférez laisser un message vocal pour que nous puissions vous rappeler, appuyez sur la touche étoile. » DetectDTMF devrait être réglé sur Oui afin que l’action puisse traiter la pression sur la touche par le contact. En mode valeur : Cliquez pour Non désactiver cette option. Cliquez sur Activé pour activer l’action de détection et de réponse aux tonalités DTMF. En mode expression : Saisissez faux pour désactiver cette option. Conservez le paramètre vrai pour permettre à l’action de détecter les tonalités DTMF et d’y répondre. Lorsque cette propriété est activée et qu’un contact appuie sur une touche, la branche Digit est déclenchée. Vous pouvez utiliser la substitution de variables dans cette propriété. Pour ce faire, réglez cette propriété sur le mode Expression , puis saisissez la variable dans le champ. Mettez la variable entre accolades ( { } ).
Clear Digits	Lorsqu’un contact appuie sur les touches de son téléphone, une tonalité DTMF est générée et stockée dans une mémoire tampon. ClearDigits vous 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 du clavier de son téléphone. qui se trouvent dans la mémoire tampon lorsque l’action démarre. Lorsqu’elle est activée, cette option efface la mémoire tampon au début de l’action. Toute pression sur une touche qui s'est produite plus tôt dans le script ne sera pas transmise à cette action. Si vous désactivez cette option, l’action traite et agit sur toutes les tonalités DTMF transmises à l’action via la mémoire tampon. Définissez l’option sur Vrai pour l’activer ou sur Faux pour la désactiver. Lorsque des tonalités DTMF sont transmises à cette action, le script emprunte immédiatement le chemin de la condition de branche Digit. En mode valeur : Cliquez sur Non pour désactiver cette option. Conservez le paramètre Oui pour effacer la mémoire tampon DTMF. En mode expression : Saisissez faux pour désactiver cette option. Conservez le paramètre vrai pour effacer la mémoire tampon DTMF.

Conditions de la branche de résultat

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 emprunté à moins que le script ne remplisse une condition qui l'oblige à emprunter l'une des autres branches. Celui-ci est également emprunté si les autres branches ne sont pas définies. Pour Music, cette branche est également empruntée lorsque SecondsToPlay a une valeur supérieure à zéro et inférieure à la longueur totale du MusicFile sélectionné.
Complete	Chemin emprunté à la fin de la lecture de l'enregistrement.
Paused	Cette condition de branche n' est pas utilisée actuellement.
Digit	Le chemin emprunté lorsque DetectDTMF est réglé sur True et que le contact appuie sur une touche de son téléphone pendant 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 texte complet. Des scripts supplémentaires peuvent être nécessaires.

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

Vous pouvez également utiliser l’action Playlog au lieu de l’action Wait, comme décrit précédemment.

Voudriez-vous télécharger cet exemple ?