Music

Music 操作为联系人播放音乐文件。

为联系人播放音乐文件。Music 通常用于联系人处于排队或等待场景中时的暂候音乐。您可以从默认的音乐文件列表中进行选择。此操作不支持任何类型的自定义音频文件。您可以选择文件的播放量，以及音乐在文件中开始播放的秒数。

通过 Music 操作提供的预先录制的音乐文件是由专业音乐家创作的授权曲目。它们需要定期重新获得许可。有时，文件上的许可证可能无法续期。发生这种情况时，NICE CXone 会提供类似风格的替换曲目。替换音乐将在您现有的 IVR关闭 自动电话菜单，允许呼叫者通过语音命令、按键输入或两者进行交互，以获得信息、路由呼入的语音呼叫或两者。 中无缝运行。NICE CXone 提供音乐文件更改的提前通知，以便您可以查看替换的内容并更改您的选择。

Dependencies

  • 在 onAnswer 事件之后不起作用，除非它是 onHold事件 的一部分。
  • 切勿将 Music 操作与其自身连接来创建循环。如果您想让音乐重复播放，请使用配置有短暂暂停（例如半秒）的 Wait 操作。将 Music 连接到 Wait，然后返回 Music。
  • Music 提供的默认文件最长可达五分钟。

Supported Script Types

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.
电话

Comparison of Similar Actions

以下操作具有类似功能，但存在一些关键区别：

  • Music：播放只有联系人才能听到的音乐文件。您可以从提供的音乐文件列表中进行选择。您可以在文件中指定特定的开始点和停止点。不支持播放自定义音频文件。
  • Play：播放自定义音频 WAV 文件或文本转语音 (TTS关闭 允许用户将录制的提示作为文本输入，并使用计算机生成的语音来朗读内容。) 提示。播放整个文件。只有联系人才能听到该音频。
  • Playlog：播放只有联系人才能听到的自定义 WAV 文件。它允许您选择特定的开始点和停止点。无法播放内置于其他操作的音乐文件，例如 Music。
  • Reqagent：播放只有坐席能听到的自定义音频 WAV 文件或文本转语音提示。提示会在坐席和联系人链接之前播放，因此提示不会导致联系人听到静音。
  • Whisper：播放自定义 WAV 文件或文本转语音提示。您可以将其设置为仅联系人、仅坐席或两者均可听到。提示会在坐席和联系人链接之后播放，因此如果该操作仅针对坐席或联系人播放，则另一方在提示期间将听到静音。
  • Ziptone：在联系人和坐席链接之后为坐席播放提示音。Reqagent 操作有一个 Ziptone 属性，在链接联系人和坐席之前为坐席播放提示音。

Input Properties

这些属性定义操作在执行时使用的数据。

此操作的所有属性都接受变量替换。

属性

说明
Caption

输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。The default is the action name.

MusicFile

从下拉列表中选择音频文件。提供了 20 个 WAV 格式音乐文件的精选。 If you want to use a custom music or audio file, use the Playlog action. 变量替换通常用于此属性。

必须配置该属性。如果此字段留空，可能会导致服务器出现问题。
StartOffset

可使您让选定的音频文件从您指定的点开始播放，而不是从开头开始。输入您希望操作从文件开头开始播放音频的秒数。变量替换通常用于此属性。

例如，如果您有一个包含两个 Music 操作和一个 Wait 操作的循环，则可以使用第一个 Music 操作从文件开头播放。如果您第一个 Music 操作播放了 30 秒，并且您想要第二个 Music 操作从第一个停止的位置恢复播放，则将 StartOffset 设置为 30。

此属性的默认值为 0，它会使文件每次都从开头播放。没有最大值，但如果您输入的值大于音乐文件的长度，则该操作会从开头播放文件。
SecondstoPlay

允许您播放所选音频文件的一部分。输入您要播放的文件的秒数。

默认值为 0，表示音乐文件从头到尾播放。发生这种情况时，OnComplete 分支条件满足且脚本采用该路径。

没有最大值，但如果您输入的数字大于文件长度，脚本将采用 OnComplete 分支路径。

当 SecondsToPlay 设置为大于零且小于文件总长度的任何值，则 Default 分支条件满足。

变量替换通常用于此属性。
InterruptMessages

允许您定期用一条或多条短信中断音乐。例如，您可以感谢联系人的等待或提醒他们您网站上提供的自助服务选项。

输入消息文件的名称，然后输入消息后要播放 MusicFile 的秒数。如果要播放不同的消息，请将它们全部包含在内。在该字段中使用以下语法：<NameOfFile.wav>;<SecondsToPlay>。例如：

Thanks.wav;20 HelpYourSelf.wav;20 Reminder.wav;20

此方法可行，但有一定风险。例如，如果您使用的一个音频文件是重新录制的，而且现在比原来更长，则有可能在前一条信息播放完毕之前，后一条信息就已开始播放。实现中断消息的首选方法是将 Music 操作与提供消息或提示的 Play 或 Playlog 操作交替使用。

You can record your messages using a third-party application and upload it to CXone.
RepeatIndex

将此属性设置为您希望 InterruptMessages 重复的次数。如果您没有配置中断消息，则可以省略此属性。
DetectDTMF

Determines whether DTMF关闭 当用户在电话按键上按下或敲击某个键时产生的信号音。 tones are processed while the action is running.The default value is True, which means that DTMF tones are processed if the contact presses a key and the OnDigit branch of the script is triggered.If the value is set to False, DTMF tones are not processed even if the contact presses a key.For example, you might play a message at the point a contact is placed in queue which says, "An agent will be with you shortly.To leave the queue at any time, press the star key".The OnDigit branch might then offer the contact the option to leave a voicemail message.

This property does not capture DTMF tones.If you need to evaluate an entered tone, use a Captureaction after this action to assign the tone to a variable.You can then evaluate the variable's value to determine which tone was entered.

变量替换通常用于此属性。
ClearDigits

当联系人按下电话上的按键时，会生成 DTMF 铃声并将其存储在缓冲区中。ClearDigits 允许您决定该操作如何处理操作开始时缓冲区中的 DTMF关闭 当用户在电话按键上按下或敲击某个键时产生的信号音。 铃声。

启用后，此选项会在该操作开始时清除缓冲区。脚本中之前按下的任何键都不会传递到此操作中。如果您禁用此选项，则该操作将对通过缓冲区传递到该操作的任何 DTMF 铃声进行处理和操作。设置为 True 可启用，或者设置为 False 可禁用。当 DTMF 铃声传入此操作时，脚本会立即执行 OnDigit 分支条件的路径。

Set to True to enable this option or False to disable it.

Result Branch Conditions

结果分支条件允许您在脚本中创建分支，以在执行操作时处理不同的结果。

条件

说明

Default

除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果没有定义其他分支，也会使用该路径。

For Music, this branch is also taken when SecondsToPlay is set to anything greater than zero and less than the total length of the selected MusicFile.
OnComplete

所选音频文件从开始到结束播放时所采用的路径。如果将 SecondsToPlay 设为 0，或者设置的值大于文件长度，也会出现这种情况。
OnPaused

当前未使用此分支条件。
OnDigit

将 DetectDTMF 设为 True 且联系人在操作过程中按下某个键时所执行的路径。

Script Example

此示例并非完整的脚本。要使用此操作，需要额外的脚本编写工作。

In this partial script example, music is played while the contact waits for an agent to take the call. After music plays for the period established in the SecondstoPlay property, the Wait action introduces a pause before the music resumes. The Music action has been renamed, using the Caption property, to indicate the WAV file specified in the MusicFile property (CruisingJazz.wav).

You could alternatively use the Playlog action instead of the Wait action, as described previously.

Would you like to download this example?