Skip to content

微信菜单定义 ​

微信菜单定义用来排公众号底部那排按钮:一级按钮叫什么、点开后展开哪几个二级按钮、每个按钮是回一条消息还是跳一个网页。网页版按客户端同款结构约束维护菜单项,并把菜单组装成微信要求的 JSON;推送到微信服务器这一步不在本页完成,菜单改完还要走客户端或微信服务侧的发布动作。

一、功能概述 ​

菜单位置:O2O业务 → 微信公众号 → 微信菜单定义(页面地址 /admin/o2o/wxmenus/)

微信菜单定义列表:表格列为菜单名称、层级、事件类型、事件KEY/URL、_parent

用途说明
排两级菜单一级菜单最多 3 个,每个一级菜单下二级菜单最多 5 个
定按钮行为事件类型分「点击事件」(填回调 key)与「超链接」(填完整 URL)
挑跳转页面超链接按钮可用「选择网页」从公众服务页面里选,自动回填微信服务链接
组装菜单 JSON后台接口按微信格式输出 button 结构,供外部推送使用

菜单按钮的 key 与自动回复定义里的事件KEY是一一对应的:按钮上填什么 key,回复内容就要挂在同一个 key 上,顾客点按钮才收得到消息。

二、界面布局说明 ​

列表页 ​

区域内容
工具栏新增、导出、打印(选中行后另出现导出选中)、▼ 展开全部(树形展开/收起切换);本表无删除标志列,工具栏不出现「回收站」
搜索框提示文字「搜索...」,按菜单名称、事件KEY/URL 模糊搜
表格树形表格,列依次为菜单名称(超链,点开编辑)、层级、事件类型、事件KEY/URL;默认全部展开
排序按上级菜单、层级、菜单ID 排列,一级菜单在前、其下二级跟随
分页底部显示「共 N 条」「共 N 页」,每页可选 10 / 20 / 30 / 50 / 100 / 200 条

一级菜单的「上级菜单」在库里指向它自己(客户端同款口径),树形展示时按根节点处理,所以一级菜单不会挂在自己下面形成死循环。

编辑窗口 ​

点「新增」或点菜单名称打开编辑窗口,字段集中在一个表单区块里:

字段控件与提示
菜单名称文本,最长 60 字符;提示「留空时一级默认「新菜单」、二级默认「新菜单2」」
上级菜单ID数值输入;提示「留空或 0 为一级菜单;填一级菜单的菜单ID 则为二级菜单」
层级数值,保存时按上级菜单自动判定(1 或 2)
事件类型下拉:点击事件 / 超链接
事件KEY/URL整行宽文本,最长 250 字符;提示「点击事件填回调 key;超链接填完整 URL」
选择网页事件KEY/URL 旁的按钮,只有事件类型为「超链接」时可点

表单工具栏左侧为返回、编辑、保存(分裂按钮,下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行;右侧为历史版本、附件、删除。菜单ID 在新增时不出现,由系统取号;编辑时只读。

三、业务操作步骤 ​

步骤 1:建一级菜单 ​

  1. 点「新增」,「上级菜单ID」留空或填 0;
  2. 填「菜单名称」,例如「会员中心」;「事件类型」按需选,留空保存后默认为「点击事件」;
  3. 点「保存」。列表刷新后出现一条层级为 1 的记录,菜单名称为空时自动写成「新菜单」。

一级菜单已有 3 个时再新增会被拦下,提示 一级菜单最多只能三个!。

步骤 2:在一级菜单下建二级菜单 ​

  1. 先在列表里记下目标一级菜单的菜单ID;
  2. 点「新增」,「上级菜单ID」填那个菜单ID,填菜单名称与事件类型;
  3. 点「保存」。该记录层级自动为 2,树形表格里挂在对应一级菜单下。

结构不符时按原文提示处理:

报错原文原因
上级菜单 [填写的ID] 不存在上级菜单ID 填错或该菜单已不在表里
微信菜单只支持两级:二级菜单的上级必须是一级菜单把另一个二级菜单当成了上级
二级菜单最多只能有5个!该一级菜单下已有 5 个二级菜单

步骤 3:给超链接按钮挑一个服务页面 ​

  1. 把「事件类型」选为「超链接」,此时「选择网页」按钮可点;
  2. 点「选择网页」,弹窗标题为「选择网页」,上方过滤框提示「按页面标题过滤」;
  3. 选中一个页面,事件KEY/URL 自动回填成微信服务链接,形如 服务地址/wechat.php/ACTION_HTML?srvid=服务号&page_id=页面ID;
  4. 点「保存」。

弹窗里系统页面带 [系统] 标记;一个页面都没有时显示「请先定义好页面!」,取数失败时提示「加载页面列表失败」。微信服务地址未配置时会提示「未配置微信服务地址(Opt_SysInfo/TWXOption/WXServiceUrl),生成的链接缺少域名,可手工补全」——此时回填的链接缺域名,要手工补全后再保存。

步骤 4:生成菜单 JSON ​

菜单项维护完后,由实施或技术人员访问后台接口 /admin/o2o/wxmenus/build-menu/ 取菜单 JSON。列表与表单上都没有「生成微信菜单」按钮,这一步是接口动作。

接口按客户端同款规则先校验二级菜单:

报错原文触发条件
网址不能为空,请检查!二级菜单事件类型为「超链接」但事件KEY/URL 为空
key值不能为空,请检查!二级菜单为点击事件但事件KEY/URL 为空

校验通过后返回 button 数组(一级菜单名 + 其下二级按钮)。没有二级菜单的一级菜单会被跳过,不出现在 JSON 里。返回的 JSON 供外部调用微信接口使用,本页不直接推送微信服务器。

步骤 5:调整与删除 ​

  • 改菜单名称、key 或 URL:点开记录改完保存,列表即时刷新。
  • 删二级菜单:在编辑窗口点「删除」。本表没有删除标志列,若删除后刷新列表记录仍在,请联系技术支持在数据库层处理。
  • 删一级菜单:点「删除」后提示 已删除该一级菜单下的全部二级菜单,一级菜单本身保留,其下二级菜单被清掉。这是客户端同款删除口径,删前确认该一级下没有还要用的按钮。

四、字段详细说明 ​

界面字段落库字段含义与取值
菜单IDWX_Menus.fMenuId主键,新增时系统取号,编辑态只读
上级菜单IDfParentId留空或 0 为一级;填一级菜单ID 为二级。一级菜单保存后本列被回写为自身菜单ID
层级fLevel1 一级 / 2 二级,保存时按上级菜单自动判定,手工改值不生效
菜单名称fTitle公众号上显示的按钮文字,最长 60 字符;留空自动填「新菜单」或「新菜单2」
事件类型fEvent见下方枚举;留空保存后默认 click
事件KEY/URLfEventKey点击事件填回调 key,超链接填完整 URL,最长 250 字符

事件类型枚举 ​

取值界面文案事件KEY/URL 填什么
click点击事件回调 key,需与自动回复定义里的事件KEY一致
view超链接完整 URL,可用「选择网页」回填

结构约束 ​

约束数值
一级菜单数量上限3
每个一级菜单下二级菜单数量上限5
菜单层级只支持两级

五、典型使用场景 ​

场景一:新公众号上线排三个入口。 建「会员中心」「门店服务」「最新活动」三个一级菜单,各挂 2~4 个二级按钮;跳页面的按钮事件类型选「超链接」并用「选择网页」挑页面,回消息的按钮选「点击事件」并填 key,再到自动回复定义里按同一个 key 写内容。

场景二:把服务页面推到菜单上。 先在公众服务页面里把「新品介绍」内容编好并保存,再回本页新增一个二级菜单,事件类型「超链接」,点「选择网页」选中该页面,保存后由技术人员取菜单 JSON 并发布。

场景三:活动结束换按钮。 活动页下线后,把对应二级菜单的事件KEY/URL 改成新的活动页链接,或把该二级菜单删掉;一级菜单保留,避免整组按钮被清空。

六、权限控制与前置条件 ​

  • 本页为网页端新迁移的编码窗体,权限映射里标注为「客户端无对应菜单 / Django 新增,始终放行」,可见性跟随 O2O业务 分组;菜单按账套已开通的模块范围显示,看不到入口时联系深圳市安仕达管理软件有限公司确认开通范围。
  • 前置条件:公众号已认证、微信服务环境已搭好;超链接按钮要跳的页面需先在公众服务页面里定义。
  • 「选择网页」回填的链接依赖系统选项 Opt_SysInfo 中 TWXOption 的 WXServiceUrl(服务地址)与 WXServiceNo(服务号),未配置时链接缺域名。
  • 点击事件类按钮要有回复内容,需在自动回复定义里按相同 key 建好消息。
  • 菜单发布到微信服务器不在本页完成,需客户端或微信服务侧配合。

七、常见问题 ​

问:删了一级菜单,为什么它还在列表里? 答:本页沿用客户端删除口径——删一级菜单只清掉它下面的全部二级菜单,一级本身保留,提示原文是「已删除该一级菜单下的全部二级菜单」。要连一级一起去掉,需技术支持在数据库层处理。

问:二级菜单点了删除,刷新后还在? 答:本表没有删除标志列,若删除后刷新列表记录仍在,先把该按钮的名称与 key 改成停用标识或改挂到别处,真正清理记录请联系技术支持。

问:「选择网页」按钮是灰的? 答:只有事件类型为「超链接」时该按钮才可用。先把事件类型改成超链接,按钮即可点击。

问:生成的菜单 JSON 里少了一个一级菜单? 答:没有二级菜单的一级菜单会被跳过。给该一级菜单补至少一个二级按钮,并确认二级的事件KEY/URL 已填,再重新取 JSON。

问:菜单保存了,公众号上还是旧按钮? 答:本页只维护菜单项并输出 JSON,不推送微信。需由客户端或微信服务侧执行发布动作,发布后在公众号里取消关注再重新关注查看。

问:层级手工改成 2 了,保存后又变回 1? 答:层级由「上级菜单ID」决定,保存时自动回写。要建二级菜单,把上级菜单ID 填成目标一级菜单的菜单ID,不要直接改层级。