用户输入

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

组件介绍

用户输入 组件用于收集来电者的按键输入，通常与 条件 组件配合使用。按键输入值将存储在变量中，可作为后续组件的输入或用于条件判断。

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

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

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

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

组件配置

  1. 添加 用户输入 组件至通话流程后，点击组件进行配置。

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

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

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

        示例：

      新增的语音将保存至 PBX 设置 > 提示音 > 自定义提示音。
  3. 配置超时时长。

    • 按键超时时长(s)：设置系统等待来电者输入下一个数字的最长时间。

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

    • 组件响应超时时长 (s)：设置系统等待来电者开始输入的最长时间。

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

  4. 点击右下角的 确认。

    组件将显示所选提示音。

组件变量

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

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

用户输入 组件的输出结果。

  • UserInputResult.Timeout：来电者超时未按键，进入超时目的地。
  • UserInputResult.ValidOption：来电者按下有效按键，进入对应目的地。
 $UserInput1.result(STRING)=UserInputResult.Timeout
$UserInput{index}.ttsResult String 用户输入 组件文本转语音 (TTS) 结果。
  • UserInputTTSResult.Success：文本成功转换为语音，并播放给主叫。
  • UserInputTTSResult.Timeout：文本未在指定时间内转换为语音。超时后，系统将跳过该提示音，直接将主叫路由至下一个组件。
 $UserInput1.ttsResult(STRING)=UserInputTTSResult.Success
$UserInput{index}.userInput String 来电者按下的按键，不含结束键 (# 或 *)。 "2"

组件连接

用户输入 组件可连接 一个 组件，可选组件详见下表。

组件 说明
提示音

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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