公众号消息模板
公众号消息模板用于同步微信公众号后台的模板消息，并面向指定粉丝发送模板通知。当前前端位于 apps/web-antd/src/views/mp/messageTemplate，后端接口由 MpMessageTemplateController 提供。
功能边界
| 能力 | 接口 | 说明 |
|---|---|---|
| 同步模板 | POST /mp/message-template/sync?accountId= | 从微信侧同步当前账号的模板列表 |
| 查询模板 | GET /mp/message-template/list?accountId= | 返回本地模板列表，不分页 |
| 查看详情 | GET /mp/message-template/get?id= | 获取单个模板 |
| 删除模板 | DELETE /mp/message-template/delete?id= | 删除本地/微信侧模板记录 |
| 发送模板 | POST /mp/message-template/send | 给指定粉丝发送模板消息 |
使用流程
发送参数说明
| 字段 | 说明 |
|---|---|
id | 本地模板编号 |
userId | 公众号粉丝编号，最终应能定位 openid |
data | 模板字段数据，按微信模板变量填写 |
url | 点击模板后跳转的网页地址 |
miniProgramAppId / miniProgramPagePath | 小程序跳转配置 |
运维建议
- 先同步再发送：微信后台新增或修改模板后，需要在 RuoYi Office 后台同步。
- 模板变量要精确匹配：
data的 key 必须与模板内容中的变量一致。 - 发送前小范围测试：模板消息触达用户，生产发送前建议用测试粉丝验证内容和跳转。
- 注意微信规则变化：模板消息行业、额度、跳转限制以微信公众平台当前规则为准。
排查清单
| 现象 | 优先检查 |
|---|---|
| 模板列表为空 | 是否选择公众号；是否在微信后台配置模板；是否点击同步 |
| 发送失败 | 粉丝是否关注公众号；模板变量是否完整；后端日志中的微信错误码 |
| 跳转异常 | url 是否合法；小程序 AppId 与路径是否正确 |
| 删除后又出现 | 微信侧仍存在并再次同步；确认删除范围和同步来源 |
