菜单

本文介绍 菜单 组件的功能、配置方法、变量以及可连接的组件类型。

组件介绍

菜单 组件用于向来电者提供多个菜单选项，并根据其按键输入路由来电。按键输入值将存储在变量中，可作为后续组件的输入或用于条件判断。

你可以设置系统停止收集来电者输入的条件，例如达到按键超时、响应超时、或来电者按下结束键。此外，还可以配置提示音或文本转语音内容，用于引导来电者输入按键。

支持的提示音类型
提示音类型 说明
自定义提示音 选择系统已有的自定义提示音，或通过分机录制/上传音频文件等方式来创建新的提示音。
等待音乐 选择系统已有的等待音乐。
注： 开始之前，确保在 PBX 设置 > 提示音 > 等待音乐 中完成相关设置。
文本转语音

输入文本内容，系统将根据所选语言和语音风格将其转换为语音播放。

注： 开始之前，确保已在 应用对接 > AI 中启用对应功能。
支持的结束键
# 键或 * 键。
你可以进入 通话流程设计 > 选项 中设置结束键。

组件配置

添加 菜单 组件至通话流程后，你可以配置菜单按键、输入提示音、超时时长以及输入的重试规则。
配置输入提示音和按键超时时长
  1. 点击 菜单 组件，完成相关配置。

  2. 配置提示音或文本转语音内容，引导来电者按键。
    项目 说明
    自定义提示音

    1. 选择 自定义提示音。
    2. 指定要使用的提示音。
      注： 最多可添加 5 个自定义提示音。
      • 要使用现有提示音，从 提示音 下拉列表中选择提示音。
      • 要使用新提示音，点击 录制新提示音 并通过分机进行录制，或点击 上传 上传本地音频文件。
        注： 新增的提示音将保存至 PBX 设置 > 提示音 > 自定义提示音。
    3. 可选： 如需循环播放自定义提示音，勾选 启用循环播放。
      注： 如果后续组件配置了提示音，循环播放的提示音将被覆盖。
    等待音乐

    1. 选择 等待音乐。
    2. 从 等待音乐 下拉列表中选择等待音乐。
    注： 如果后续组件配置了提示音，等待音乐将被覆盖。
    文本转语音
    1. 选择 文本转语音。
    2. 完成其余配置，将文本转换为语音。
      注： 静态文本和动态文本都支持转换为语音。
      • 静态文本：在 文本 栏直接填写文本。
      • 动态文本：填写文本，并使用占位符引用 变量 来动态组成文本。此外，你可以自定义提示音生成超时时长。如果系统未在指定时间内生成语音，主叫将在未听到该提示音的情况下直接进入下一组件。

        示例：

      新增的语音将保存至 PBX 设置 > 提示音 > 自定义提示音。
  3. 在 按键超时时长(s) 栏，设置系统等待来电者输入下一个数字的最长时间。

    你可以从下拉列表中选择一个值，或者手动输入 1- 9999 之间的数值。

  4. 点击右下角的 确认。
配置无效输入的重试规则
如需允许来电者在输入无效时返回组件重试，完成以下设置。
  1. 点击 无效输入 分支。
  2. 勾选 返回菜单。
  3. 在 返回次数 下拉列表中，选择来电者无效输入后可返回该组件的次数。
  4. 可选： 配置提示音或文本转语音内容，提示来电者重新输入。
  5. 点击右下角的 确认。
配置响应超时的时长和重试规则
如需修改默认的响应超时时间，或在响应超时后允许来电者返回组件重试，完成以下配置。

  1. 点击 响应超时时间 分支。
  2. 在 组件响应超时时长 (s) 栏，设置系统等待来电者开始输入的最长时间。

    你可以从下拉列表中选择一个值，或者手动输入 1- 9999 之间的数值。

  3. 设置响应超时的重试规则。
    1. 勾选 返回菜单。
    2. 在 返回次数 下拉列表中，选择来电者可返回该组件的次数。
    3. 可选： 配置提示音或文本转语音内容，提示来电者重新输入。
  4. 点击右下角的 确认。
配置菜单按键
  1. 点击组件上的 ，为按键添加分支。
    注： 支持最多 100 个分支，每个分支对应一个不同的按键。

  2. 点击按键分支完成相关设置。

    项目 说明
    输入匹配值 输入按键值。
    注：
    • 只允许填写数字和字符 * #。
    • 如果按键值包含 * 或 #，请确保不与通话流程的结束键冲突 (配置路径：通话流程设计 > 选项)，否则系统会将其视为无效输入并将来电转至无效输入的目的地。
    返回菜单 如需允许来电者返回菜单，执行以下操作。
    注： 当来电者未做按键选择时，此功能可引导其重试。
    1. 勾选 返回菜单。
    2. 在 返回次数 下拉列表中，设置来电者可返回该组件的次数。
    3. 可选： 配置提示音或文本转语音内容，提示来电者重新输入。
  3. 点击右下角的 确认。

组件变量

在通话流程中添加 菜单 组件后，系统会将来电者的按键输入存储至变量中。这些变量可在支持表达式的组件中 (如 条件 组件、开发者 组件) 调用，从而根据按键输入结果动态处理来电。

注： 由于同一通话流程中可添加多个 菜单 组件，系统会按照添加顺序为每个组件编号 (如菜单 1、菜单 2)。为确保正确获取到指定组件的输出结果，使用变量时需带上对应的编号。
变量 类型 说明 示例值
$Menu{index}.result String

菜单 组件的输出结果。

  • MenuResult.Timeout：来电者超时未按键，进入超时目的地。
  • MenuResult.ValidOption：来电者按下有效按键，进入对应目的地。
  • MenuResult.InvalidOption：来电者按下无效按键，进入无效输入目的地。

$Menu1.result(STRING)=MenuResult.InvalidOption
$Menu{index}.ttsResult String 菜单 组件文本转语音 (TTS) 结果。
  • MenuTTSResult.Success：文本成功转换为语音，并播放给主叫。
  • MenuTTSResult.Timeout：文本未在指定时间内转换为语音。超时后，系统将跳过该提示音，直接将主叫路由至下一个组件。
 $Menu1.ttsResult(STRING)=MenuTTSResult.Success
$Menu{index}.userInput String 来电者按下的按键，不含结束键 (# 或 *)。 "2"

组件连接

菜单 组件默认包含两个分支 - 无效输入 和 响应超时时间，此外可为 DTMF 按键添加最多 100 个分支。每个分支可连接 一个 组件，可选组件详见下表。

组件 说明
提示音

提示音 组件支持播放音频或将文本转为语音播放。

更多信息，请参见 提示音。
办公时间

办公时间 组件支持根据不同时间将来电路由至对应的目的地。

更多信息，请参见 办公时间。
菜单 菜单 组件用于向来电者提供多个菜单选项，并根据其按键输入路由来电。

更多信息，请参见 菜单。
用户输入

用户输入 组件用于收集来电者的按键输入，通常与 条件 组件配合使用，以判断用户输入并路由来电。

更多信息，请参见 用户输入。
语言

语言 组件用于更改其后续组件所使用的系统提示音语言，从而覆盖默认语言设置。

更多信息，请参见 语言。
录音 录音 组件可用于在来电者与另一方建立通话后对通话进行录音。你可以设置提示音或文本转语音内容，在录音开始前或录音期间播放，告知通话双方正在录音。

该组件也可用于禁用通话录音，从而覆盖系统对通话的默认录音设置。

更多信息，请参见 录音。
按号码拨打

按号码拨打 组件用于引导来电者通过输入号码将来电转接至指定的目的地，实现快速呼叫。

更多信息，请参见 按号码拨打。
按名称拨打

按名称拨打 组件是通话流程中的一种结束组件，来电者可通过输入目标分机用户姓名的前三个字母，快速查找并转接至该用户。

更多信息，请参见 按名称拨打。
转移

转移 组件是通话流程中的一种结束组件，用于终止来电者与当前通话流程的连接，并将其盲转至指定目的地。转接前可播放提示音，提示来电者通话即将转移。

更多信息，请参见 转移。
挂断

挂断 组件是通话流程中的一种结束组件，用于终止来电者与当前通话流程的连接。当来电者进入该组件时，系统会挂断通话。

更多信息，请参见 挂断。
条件 条件 组件支持基于表达式进行逻辑判断，根据判断结果对来电进行路由。

更多信息，请参见 条件。
循环 循环 组件支持重复执行多个组件，直到达到指定的循环次数或满足设定的条件。

更多信息，请参见 循环。
开发者 开发者组件 用于连接 PBX 或第三方数据库，执行数据查询或写入操作。
更多信息，请参见以下文章：