终端用户与 5G 消息签名会话时,需要一个稳定的入口才能快速找到常用服务,否则只能依赖每条消息中的临时按钮。固定菜单是 5G 消息的特有能力:为签名配置一套常驻菜单后,终端用户可直接点击菜单项完成回复、访问网页、拨号、查看位置等交互,同时可通过回执识别终端用户点击了哪个菜单项。
使用限制
编辑固定菜单前,建议先确认菜单方案符合以下限制:
一个 5G 消息签名只能拥有一套固定菜单。
当某个一级菜单已配置二级菜单后,该一级菜单不能再设置交互;如需为一级菜单配置交互,请先移除其下的所有二级菜单。
受运营商能力限制,固定菜单设置后,后续编辑仅支持调整一级菜单和二级菜单的内容(可移除单个菜单项),但无法将整套固定菜单清空。
固定菜单编辑提交后,运营商会进行审核,一般需要 1 天左右。审核通过后,因各机型刷新时间不同,可能存在 1 天左右新老版本菜单共存的状态,属于正常现象。
编辑固定菜单
固定菜单不是签名的必配项,可在添加签名时一并配置,也可以在签名创建完成后再补充配置。
步骤一:进入编辑入口
编辑入口取决于签名所处的阶段,根据以下场景选择对应入口,进入编辑页后的配置步骤相同:
步骤二:配置菜单层级与名称
固定菜单支持一级菜单和二级菜单两级结构。进入编辑页后,添加一级菜单与二级菜单,并为每个菜单项填写名称。菜单名称是终端用户在会话界面上直接看到的文案,建议使用能表达目标操作的短词,避免因字节数超限被截断。菜单层级与名称需满足以下限制:
配置项 | 限制 |
一级菜单数量 | 最多 3 个 |
二级菜单数量 | 每个一级菜单最多配置 5 个二级菜单 |
菜单名称长度 | 最多 25 个字节(Bytes),其中 1 个中文字符占 3 个字节、1 个英文字符占 1 个字节 |
步骤三:为菜单项配置交互类型
每个菜单项可配置一种交互类型,决定终端用户点击后触发的行为。各交互类型及其额外设置如下:
当某个一级菜单已配置二级菜单后,该一级菜单不能再设置交互;如需为一级菜单配置交互,请先移除其下的所有二级菜单。
交互类型 | 额外设置 | 终端用户点击后的效果 |
快捷回复 | 无 | 以该菜单项名称作为内容发送一条回复 |
打开浏览器 | 浏览器地址(形如 | 使用指定类型的浏览器打开该地址 |
拨号操作 | 电话号码,仅支持数字(如 | 唤起拨号界面并填入该号码 |
打开地图 | 经度、纬度 | 调用地图应用打开该坐标位置 |
请求获取用户当前位置 | 无 | 由终端向用户请求当前位置 |
配置交互时还可以设置 回执标识,用于在收到回执时区分终端用户点击了哪个菜单项。
步骤四:提交并等待审核
确认菜单层级、名称与交互配置无误后,提交固定菜单。提交后运营商会进行审核,审核时长及审核通过后新老菜单共存的情况参见使用限制。
接收固定菜单交互回执
当终端用户点击固定菜单中的可交互项时,可通过 5G 上行消息回执收到一条回执消息。回执中包含该菜单项的展示文案,以及与控制台配置的 回执标识 相对应的回执数据字段postback.data,据此即可判断终端用户点击了哪个菜单项。回执的完整字段结构、取值与回调配置方式,请参见5GSmsUp。
{
"response": {
"reply/action": {
"displayText": "某个菜单/交互项",
"postback": {
"data": "b3a1f8e2-7c4d-4e9a-bc56-1a2d3f4e5678"
}
}
}
}终端展示效果
固定菜单通过审核后,终端用户在 5G 消息会话界面即可看到菜单入口,点击一级菜单后展开其下的二级菜单,或直接触发该菜单项配置的交互。不同机型(如 iOS 与安卓设备)的菜单样式与展开方式存在差异,阿里云侧无法控制终端样式,以下展示效果仅供参考。
iOS 展示效果 | 安卓机型展示效果 |
|
|

