机器人回复图元

参数介绍

• 节点名称：标识节点名称。
• 描述：节点的详细说明信息。
• 回复方式：“静态放音”、“回复文本”、“视频播放”“多媒体”、“卡片”、“语音文本混合”“变量音”、“WhatsApp交互式消息”。
  

  使用变量音暂不支持开启IVR流程录音功能。

  • 静态放音表示直接播放语音文件服务器上的语音文件，语境确定，无需变化的情况下用静态放音。需确保语音文件在UAP的文件服务器上存在。
  • 回复文本表示将配置的文本提供给TTS进行转换播放，回复文本中可以添加参数变量，TTS会根据变量返回的值动态播放语音。
  • 视频播放表示文件服务器上的视频文件名。
  • 多媒体表示将配置的多媒体信息给渠道网关给对应的播放器，仅在集成环境可见。
  • 卡片表示将配置的卡片信息给渠道网关进行播放，仅在集成环境可见。
  • 语音文本混合表示将语音文件和文本拼接后播放。
  • WhatsApp交互式消息支持机器人和WhatsApp进行交互。
  • 通过变量音的语种配置、类型以及回复变量可实现UAP语音包动态放音。
    1. 语种，支持多种语言选择。
    2. 类型，选择放音类型，支持电话号码、数字、时间（hh:mm:ss）、日期（yyyymmdd）、价格。
• 回复来源：播放语音的内容来自回复模板、回复变量或者回复资源。
• 回复模板：当“回复来源”为“回复模板”时显示，选择您在“配置中心>机器人管理>流程配置>资源管理 > 资源模板”中配置的内容模板。
  1. 如果回复方式选择多媒体，回复模板选择的是纯文本，下方可直接展示对应的参数值。纯文本内容请在“配置中心>资源管理>多媒体库”纯文本页签设置。
  2. 如果回复方式选择WhatsApp交互式消息，回复模板只能选择您在“资源管理 > 资源模板”中配置的WhatsApp交互式消息模板。其中模板内容请在“配置中心>资源管理>多媒体库”卡片模板页签设置WhatsApp交互式消息。选中后下方可直接展示需要填写的参数值。
  3. 回复模板中的参数值需要填写引号，如下图所示。
     图1 变量值
     
• 回复变量：当“回复来源”为“回复变量”时显示，选择后回复变量。
  1. 当“回复方式”为“语音文本混合”时，回复变量格式为：录音文件URL~$文本$~录音文件URL~$文本$，例如：/xxx/xx1.wav~$abc$~/xxx/xx2.wav，其中文本不支持参数变量，一个语音文本混合的变量最多包含5条语音和文本信息。
  2. 当“回复方式”为“静态语音”时，回复变量格式为：语音文件URL，例如：/xxx/xx1.wav 。
• 回复资源：当“回复来源”为“回复资源”时显示，选择您在“配置中心>资源管理>音视频资源管理 ”或者“配置中心>资源管理>多媒体库 ”中配置的资源。
• 回复模式：为必选，取值范围如下：
  • 只播放：表示只播放语音/视频，不需要接收客户的内容。通常静态放音时选择。
  • 支持识别打断播放：表示需要客户语音应答，通常回复文本时选择。
  • 支持按键打断播放：表示需要获取客户输入的按键信息。机器人回复图元的回复模式为按键打断时，如需要获取按键交互的结果，则该机器人回复图元不能直接连接结束图元，并且结束图元前也不能直接连接按键识别和语义识别图元。
  • 支持识别和按键打断播放：既可接收语音信息，也可接收按键信息，哪个信息先接收到按哪个信息去匹配。
  • 支持播放后再识别：语音/视频播放完成后才开始识别，如果在播放过程中说话，则接收不到语音信息。
  • 支持播放后再识别和按键：语音/视频播放完成后才开始识别或收号，如果在播放过程中说话/按键，则接收不到信息，播放后说话/按键，哪个信息先接收到按哪个信息去匹配。
  • 支持按键后不打断播放：语音/视频播放开始就可以进行按键操作，但是不会打断放音。
  • 自定义变量值：标识是否可被打断，如果可打断则在最少放音时间输入框填入最少放音时间。

    字符串true -- 可以被识别打断，可以传递最少放音时间。

    字符串false -- 播放后识别 。

• 超时时间：单位秒，未配置使用默认15秒。当超过该时长设置时，系统判定超时。不同厂商这个参数的取值范围不同， 当前最长是180秒。
  • 支持播放后再识别，这个时间将从播放结束后开始计算，指的是播放完TTS到停止识别的时间。
  • 支持按键/识别打断，这个时间将从放音结束计算，例如TTS结束放音后，用户如果一直不说话，聊天机器人到超时时间后会进入下一个图元。
  • 只播放：超时时间不会生效。
  

  在长文本放音、用户输入较多的按键如身份证或判断用户需要说较多意见等场景时，请注意超时时间的设置。支持按键/识别打断的回复模式下，超时时间设置过短会造成放音没结束就开始识别或者用户还没输完按键就识别结束。超时时间设置过长会导致用户无输入下始终静默，过很久才会有超时提醒。

  机器人的消息回复超时处理

  • waitFlag：会话标识，如果timeout小于当前会话剩余超时时间，则设置会话标识waitFlag为true；否则为false。
  • waitTimeout：消息超时时长。
  • waitBeginTime：waitFlag为true时，waitBeginTime设置为当前时间。
  • 当waitFlag为true时进行处理，为false时则保持原有消息处理逻辑。
  • 处理逻辑：消息超时后，CC-Messaging主动触发超时流程，并将机器人响应推送给用户。
• 扩展参数：请输入IVR侧需要的数据，例如提供商信息，该值会通过对话接口的vendor参数回传给IVR。历史流程里的机器人回复图元才看到此接口，如果老流程使用了此配置，建议填到ASR扩展参数中使用。
• 最大收号长度：当回复模式为支持按键打断、支持识别和按键以及支持收号后不打断放音时会显示此配置，用来设置IVR收号的最大收号长度。
• 收号超时时间：按键间隔超时时间，例如设置2s，收号位数没有达到指定位数，按键间隔超过2s，也能继续走流程。
• 取消键：当回复模式为支持按键打断、支持识别和按键以及支持收号后不打断放音时会显示此配置，用来设置IVR收号时是否使用*号键作为取消键。
• 确认键：当回复模式为支持按键打断、支持识别和按键以及支持收号后不打断放音时会显示此配置，用来设置IVR收号时是否使用#号键作为确认键。
• TTS高级配置：“开启”、“关闭”。默认关闭。
• 音效：“男生朗读”、“女生朗读”、“自定义音效”。默认女生朗读，TTS高级配置开启时可配。
• 音速：“低速朗读”、“中速朗读”、“高速朗读”、“自定义音速”。默认低速朗读，TTS高级配置开启时可配。
• TTS扩展参数默认值：“开启”、“关闭”。默认关闭。
• TTS扩展参数：请输入IVR侧提供TTS业务需要的数据，例如提供商信息，该值会通过对话接口的ttsMRCPVendor参数回传给IVR。

  TTS服务器的扩展参数，按照对应TTS服务器厂家的要求填写，其中speed、pitch、volume、voice_name支持数据类型为字符型的GLOBAL和FLOW变量或者输入任意字符串内容，变量值不在标准范围内会取缺省值。

  缺省值和格式要求如下：

  speed=GLOBAL.ttsSpeed;pitch=GLOBAL.ttspitch;volume=GLOBAL.ttsVolume;voice_name=GLOBAL.voiceName;

  1. 音速speed，取值范围[-500,500]，缺省值0，
  2. 音调pitch，取值范围[-500,500]，缺省值0，
  3. 音量volume，取值范围[0,100]，缺省值50，
  4. 音色voicename，缺省值cn_kefuman_common。
     

     • 您使用TTS功能时，需要联系系统管理员登录客户服务云进入“配置中心>机器人管理>流程管理>系统管理>TTS/ASR管理”界面为您的租间配置TTS服务器。
     • TTS服务的扩展参数缺省值配置，请联系租户管理员在登录客户服务云进入“配置中心>机器人管理>流程配置>资源管理>变量管理>内置变量”界面进行设置。
• ASR高级配置：“开启”、“关闭”。默认关闭。
• 识别类型：“普通识别”。默认普通识别，ASR高级配置开启时可配。
• 用户无话超时时长：默认100，单位秒，取值范围：0~32000，ASR高级配置开启时可配。
• 识别结果超时时长：默认200，单位秒，取值范围：0~600，ASR高级配置开启时可配。
• 用户停顿超时时长：默认500，单位毫秒，取值范围：300~2000，ASR高级配置开启时可配。
• ASR扩展参数：请输入IVR侧需要的ASR业务需要的数据，例如提供商信息，该值会通过对话接口的vendor参数回传给IVR。