编辑 5G 消息固定菜单

更新时间:
复制 MD 格式

终端用户与 5G 消息签名会话时,需要一个稳定的入口才能快速找到常用服务,否则只能依赖每条消息中的临时按钮。固定菜单是 5G 消息的特有能力:为签名配置一套常驻菜单后,终端用户可直接点击菜单项完成回复、访问网页、拨号、查看位置等交互,同时可通过回执识别终端用户点击了哪个菜单项。

使用限制

编辑固定菜单前,建议先确认菜单方案符合以下限制:

  • 一个 5G 消息签名只能拥有一套固定菜单。

  • 当某个一级菜单已配置二级菜单后,该一级菜单不能再设置交互;如需为一级菜单配置交互,请先移除其下的所有二级菜单。

  • 受运营商能力限制,固定菜单设置后,后续编辑仅支持调整一级菜单和二级菜单的内容(可移除单个菜单项),但无法将整套固定菜单清空。

  • 固定菜单编辑提交后,运营商会进行审核,一般需要 1 天左右。审核通过后,因各机型刷新时间不同,可能存在 1 天左右新老版本菜单共存的状态,属于正常现象。

编辑固定菜单

固定菜单不是签名的必配项,可在添加签名时一并配置,也可以在签名创建完成后再补充配置。

步骤一:进入编辑入口

编辑入口取决于签名所处的阶段,根据以下场景选择对应入口,进入编辑页后的配置步骤相同:

  • 签名尚未创建(在创建签名时一并配置):登录短信服务控制台,在左侧导航栏选择 5G 消息 > 签名管理,单击 创建签名,在签名创建页面右侧选择 编辑固定菜单。

  • 签名已存在(为已有签名补充配置):登录短信服务控制台,在左侧导航栏选择 5G 消息 > 签名管理,从签名列表找到目标签名,单击操作列的 编辑固定菜单。

步骤二:配置菜单层级与名称

固定菜单支持一级菜单和二级菜单两级结构。进入编辑页后,添加一级菜单与二级菜单,并为每个菜单项填写名称。菜单名称是终端用户在会话界面上直接看到的文案,建议使用能表达目标操作的短词,避免因字节数超限被截断。菜单层级与名称需满足以下限制:

配置项

限制

一级菜单数量

最多 3 个

二级菜单数量

每个一级菜单最多配置 5 个二级菜单

菜单名称长度

最多 25 个字节(Bytes),其中 1 个中文字符占 3 个字节、1 个英文字符占 1 个字节

步骤三:为菜单项配置交互类型

每个菜单项可配置一种交互类型,决定终端用户点击后触发的行为。各交互类型及其额外设置如下:

说明

当某个一级菜单已配置二级菜单后,该一级菜单不能再设置交互;如需为一级菜单配置交互,请先移除其下的所有二级菜单。

交互类型

额外设置

终端用户点击后的效果

快捷回复

无

以该菜单项名称作为内容发送一条回复

打开浏览器

浏览器地址(形如 https://www.example.com);浏览器类型(系统浏览器或内置浏览器,默认为系统浏览器)

使用指定类型的浏览器打开该地址

拨号操作

电话号码,仅支持数字(如 400xxxxxxxx,其中 x 为需替换的实际数字)

唤起拨号界面并填入该号码

打开地图

经度、纬度

调用地图应用打开该坐标位置

请求获取用户当前位置

无

由终端向用户请求当前位置

配置交互时还可以设置 回执标识,用于在收到回执时区分终端用户点击了哪个菜单项。

步骤四:提交并等待审核

确认菜单层级、名称与交互配置无误后,提交固定菜单。提交后运营商会进行审核,审核时长及审核通过后新老菜单共存的情况参见使用限制。

接收固定菜单交互回执

当终端用户点击固定菜单中的可交互项时,可通过 5G 上行消息回执收到一条回执消息。回执中包含该菜单项的展示文案,以及与控制台配置的 回执标识 相对应的回执数据字段postback.data,据此即可判断终端用户点击了哪个菜单项。回执的完整字段结构、取值与回调配置方式,请参见5GSmsUp。

{
  "response": {
      "reply/action": {
        "displayText": "某个菜单/交互项",
        "postback": {
          "data": "b3a1f8e2-7c4d-4e9a-bc56-1a2d3f4e5678"
        }
      }
    }
}

终端展示效果

固定菜单通过审核后,终端用户在 5G 消息会话界面即可看到菜单入口,点击一级菜单后展开其下的二级菜单,或直接触发该菜单项配置的交互。不同机型(如 iOS 与安卓设备)的菜单样式与展开方式存在差异,阿里云侧无法控制终端样式,以下展示效果仅供参考。

iOS 展示效果

安卓机型展示效果

image

image