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

| 用途 | 说明 |
|---|---|
| 排两级菜单 | 一级菜单最多 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:建一级菜单
- 点「新增」,「上级菜单ID」留空或填 0;
- 填「菜单名称」,例如「会员中心」;「事件类型」按需选,留空保存后默认为「点击事件」;
- 点「保存」。列表刷新后出现一条层级为 1 的记录,菜单名称为空时自动写成「新菜单」。
一级菜单已有 3 个时再新增会被拦下,提示 一级菜单最多只能三个!。
步骤 2:在一级菜单下建二级菜单
- 先在列表里记下目标一级菜单的菜单ID;
- 点「新增」,「上级菜单ID」填那个菜单ID,填菜单名称与事件类型;
- 点「保存」。该记录层级自动为 2,树形表格里挂在对应一级菜单下。
结构不符时按原文提示处理:
| 报错原文 | 原因 |
|---|---|
| 上级菜单 [填写的ID] 不存在 | 上级菜单ID 填错或该菜单已不在表里 |
| 微信菜单只支持两级:二级菜单的上级必须是一级菜单 | 把另一个二级菜单当成了上级 |
| 二级菜单最多只能有5个! | 该一级菜单下已有 5 个二级菜单 |
步骤 3:给超链接按钮挑一个服务页面
- 把「事件类型」选为「超链接」,此时「选择网页」按钮可点;
- 点「选择网页」,弹窗标题为「选择网页」,上方过滤框提示「按页面标题过滤」;
- 选中一个页面,事件KEY/URL 自动回填成微信服务链接,形如
服务地址/wechat.php/ACTION_HTML?srvid=服务号&page_id=页面ID; - 点「保存」。
弹窗里系统页面带 [系统] 标记;一个页面都没有时显示「请先定义好页面!」,取数失败时提示「加载页面列表失败」。微信服务地址未配置时会提示「未配置微信服务地址(Opt_SysInfo/TWXOption/WXServiceUrl),生成的链接缺少域名,可手工补全」——此时回填的链接缺域名,要手工补全后再保存。
步骤 4:生成菜单 JSON
菜单项维护完后,由实施或技术人员访问后台接口 /admin/o2o/wxmenus/build-menu/ 取菜单 JSON。列表与表单上都没有「生成微信菜单」按钮,这一步是接口动作。
接口按客户端同款规则先校验二级菜单:
| 报错原文 | 触发条件 |
|---|---|
| 网址不能为空,请检查! | 二级菜单事件类型为「超链接」但事件KEY/URL 为空 |
| key值不能为空,请检查! | 二级菜单为点击事件但事件KEY/URL 为空 |
校验通过后返回 button 数组(一级菜单名 + 其下二级按钮)。没有二级菜单的一级菜单会被跳过,不出现在 JSON 里。返回的 JSON 供外部调用微信接口使用,本页不直接推送微信服务器。
步骤 5:调整与删除
- 改菜单名称、key 或 URL:点开记录改完保存,列表即时刷新。
- 删二级菜单:在编辑窗口点「删除」。本表没有删除标志列,若删除后刷新列表记录仍在,请联系技术支持在数据库层处理。
- 删一级菜单:点「删除」后提示
已删除该一级菜单下的全部二级菜单,一级菜单本身保留,其下二级菜单被清掉。这是客户端同款删除口径,删前确认该一级下没有还要用的按钮。
四、字段详细说明
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 菜单ID | WX_Menus.fMenuId | 主键,新增时系统取号,编辑态只读 |
| 上级菜单ID | fParentId | 留空或 0 为一级;填一级菜单ID 为二级。一级菜单保存后本列被回写为自身菜单ID |
| 层级 | fLevel | 1 一级 / 2 二级,保存时按上级菜单自动判定,手工改值不生效 |
| 菜单名称 | fTitle | 公众号上显示的按钮文字,最长 60 字符;留空自动填「新菜单」或「新菜单2」 |
| 事件类型 | fEvent | 见下方枚举;留空保存后默认 click |
| 事件KEY/URL | fEventKey | 点击事件填回调 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,不要直接改层级。
