机器人回复图元

参数介绍

• 节点名称：标识节点名称。
• 节点ID：图元节点ID，不可更改。
• 描述：节点的详细说明信息。
• 回复方式：“静态放音”、“回复文本”、“视频播放”“多媒体”、“卡片”、“语音文本混合”“变量音”、“WhatsApp”、“快速回复”、“邮件”。
  

  • 使用变量音暂不支持开启IVR流程录音功能。
  • 租户级参数“租户是否开启组织间的数据强制隔离机制”开启时，只能选择与画布同组织机构以及无组织机构的数据。
  • 静态放音表示直接播放语音文件服务器上的语音文件，语境确定，无需变化的情况下用静态放音。需确保语音文件在UAP的文件服务器上存在。
  • 回复文本表示将配置的文本提供给TTS进行转换播放，如果是聊天机器人，则直接将文本信息进行展示。

    回复文本中可以添加参数变量，TTS会根据变量返回的值动态播放语音。此时可对ASR、TTS的相关属性进行配置，例如设置TTS的音效、音速等。

  • 视频播放表示文件服务器上的视频文件名。
  • 多媒体表示将配置的多媒体信息给渠道网关给对应的播放器，仅在集成环境可见。
  • 卡片表示将配置的卡片信息给渠道网关进行播放，仅在集成环境可见。
  • 语音文本混合表示将语音文件和文本拼接后播放。此时可对ASR、TTS的相关属性进行配置，例如设置TTS的音效、音速等。
    

    机器人回复图元使用语音文本混合播放时，注意内容格式：

    文本需要用$包围，但以文本结束时，右侧不用$，如：$文本$~音频路径~$文本。

    音频需要用~包围，但以音频开始或结束时，边界不用~，如：音频路径~$文本$~音频路径。

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

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

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

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

  • 根据不同的应用场景调整超时时间：
    1. 放音较长的内容（如语音广播或详细介绍）时，应设置较长的超时时间，避免语音还未结束就提示超时。
    2. 当用户需要进行较多按键输入（如身份证号码等），应根据通常按键所需的时间合理设置超时时间。
    3. 针对用户需要较多意见描述的情况，超时时间也应适当延长，以免用户还没表达完就被判定超时。
    4. 在支持按键或识别打断的模式下，确保超时时间设置足够长。这样可以保证系统有足够的时间完成音频播放或等待用户开始输入。
  • 多媒体场景下机器人回复图元是不支持默认超时时长，需手动配置超时时间。

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

  • 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高级配置开启时可配。仅MRCP协议对接TTS服务厂商支持。
• 音速：“低速朗读”、“中速朗读”、“高速朗读”、“自定义音速”。默认“系统默认”速度，TTS高级配置开启时可配。仅MRCP协议对接TTS服务厂商支持。
• TTS扩展参数默认值：“开启”、“关闭”。默认关闭。
• TTS扩展参数：请输入IVR侧提供TTS业务需要的数据，例如提供商信息，该值会通过对话接口的ttsMRCPVendor参数回传给IVR。仅MRCP协议对接TTS服务厂商支持，参数值透传到Vendor-Specific-Parameters。

  TTS服务器的扩展参数，按照对应TTS服务器厂家的要求填写，其中参数值支持数据类型为字符型的GLOBAL和FLOW变量或者输入任意字符串内容。

  TTS服务器厂家为捷通时，缺省值如下：

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

  TTS服务器厂家为捷通时，各参数的取值范围和缺省值如下：

  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服务的扩展参数缺省值配置，请联系租户管理员在登录客户服务云进入“配置中心>机器人管理>流程配置>资源管理>变量管理>内置变量”界面进行设置。
     • WebSocket协议对接的TTS服务厂商（如Lodas-Speech TTS）对应的上述TTS高级配置参数以系统管理员在“实时语音服务器”上配置的“发音人”、“音量”、“语速”为准。
     • TTS服务的扩展参数取值范围受系统参数“TTS 扩展参数校验规则”控制，如果参数设置成“捷通TTS”时，TTS服务的扩展参数取值范围生效，如果关闭时，则不生效。
• 数字发音方式：当数字的读法根据系统规则无法判断时，需要在放音时指定合成音频时数字是按照数字读法，还是字符串读法。取值范围：系统默认，自动判断，数字，字符串。若选择“系统默认”则以TTS服务器上实际配置的发音方式为准。当前仅Lodas-Speech TTS服务厂商支持。
• ASR高级配置：“开启”、“关闭”。默认关闭。
• 识别类型：“普通识别”。默认普通识别，ASR高级配置开启时可配。
• 用户无话超时时长：默认为空，单位秒，取值范围：0~32000，ASR高级配置开启时可配。
• 识别结果超时时长：默认为空，单位秒，取值范围：0~600，ASR高级配置开启时可配。
• 用户停顿超时时长：默认为空，单位毫秒，取值范围：300~2000，ASR高级配置开启时可配。
• 厂商自定义参数：请输入IVR侧需要的ASR业务需要的数据，例如提供商信息，该值会通过对话接口的vendor参数回传给IVR。
  

  厂商自定义参数：仅在使用MRCP协议对接的ASR服务中生效，对应参数Vendor-Specific-Parameters。

• 热词词表：请输入热词词表ID，取自界面配置的热词词表ID，如果热词词表为空，则不设置该字段。