统一消息中心、受众与推广入口
统一消息中心
统一消息中心复用现有公众号模板消息和小程序订阅消息，提供有记录、可取消、可重试的运营任务。
支持流程
- 选择当前租户的公众号或小程序。
- 同步该账号微信侧已添加模板。
- 选择模板并填写动态字段。
- 选择单个用户、批量用户、标签或已保存受众方案。
- 保存草稿，或设置立即/定时发送。
- 查看任务汇总和逐收件人结果。
- 只重试失败明细，成功明细不会重复发送。
正式任务会落 wx_message_task 和 wx_message_recipient。单用户“试发”只验证微信是否受理，不生成正式任务留痕。
任务状态原则
- 未开始任务可以取消。
- 执行中的任务由后台原子认领，避免多个实例重复消费。
- 服务重启后由任务调度继续处理。
- 参数错误、用户未授权等永久失败不会无限重试。
- 微信接口受理成功不等于用户最终阅读。
模板同步与模板库
- 公众号模板消息：微信只支持通过公共模板短 ID 添加，未提供可浏览的公共模板标题列表。因此公众号运营人员仍需从微信公众平台模板库取得短 ID。
- 小程序订阅消息：可在后台查询账号类目、公共模板标题和关键词，直接组合并添加。
- 添加成功后同步到本地
wx_template_msg；从微信删除后停用本地记录。 - 删除远端模板前检查是否有未完成消息任务正在使用。
公众号“模板消息”和“订阅通知”是两套能力，不共用模板 ID、授权和发送接口。
受众方案
受众方案用于复用运营筛选条件，不保存一份脱离微信用户状态的永久收件人名单。
可保存的条件包括：
- 指定用户。
- 公众号用户标签。
- 关注状态等页面支持的筛选项。
发送前仍按当前账号、租户、关注/订阅状态重新校验。公众号只允许向仍关注的用户发送模板消息；小程序订阅消息必须满足用户对应模板授权。
账号模板页入口
公众号模板消息页和小程序订阅消息页均提供：
- 同步微信模板。
- 单用户动态字段试发。
- 跳转统一消息中心正式发送。
- 打开微信模板库管理。
模板页面负责维护微信模板；定时发送、收件人明细和失败重试统一由消息中心处理。
推广入口
推广入口统一管理需要异步生成或记录状态的微信入口能力，包括小程序 Short Link 等。
通用流程：
- 选择账号和入口类型。
- 填写页面路径、查询参数、有效期等官方参数。
- 创建入口并保存微信结果。
- 复制入口用于活动投放。
- 失败记录可在修正参数后重试。
推广入口支持维护 Short Link 所需参数。微信对生成数量、有效期、页面路径和账号能力有限制，最终以微信返回为准。
主要权限
| 能力 | 权限 |
|---|---|
| 消息任务列表 | wx:wxmessage:index |
| 任务详情 | wx:wxmessage:get |
| 创建任务/受众方案 | wx:wxmessage:add |
| 启动、取消、试发 | wx:wxmessage:send |
| 重试失败明细 | wx:wxmessage:retry |
| 同步和管理模板库 | wx:wxmessage:sync |
| 推广入口查看 | wx:wxpromotion:index |
| 创建/删除/重试入口 | wx:wxpromotion:add、del、retry |
运营验收
- 同步模板后字段列表与微信账号一致。
- 试发失败时能看到微信错误码。
- 正式任务能看到收件人数量、成功和失败数量。
- 重试后只处理原失败记录。
- 受众方案不能跨账号或跨租户使用。
- Short Link 创建成功后使用真机微信验证落地页面。