万村乐消息推送统一网关：短信、微信模板与APP Push的收敛

万村乐数字乡村系统要触达村民，渠道至少有三条：阿里云短信、微信公众号模板消息、APP Push（安卓和IOS）。基层工作人员发一条通知公告，过去要在三个后台各操作一遍，漏发是常事。我们把这三条通道收敛成一个统一网关，业务侧只调用一次notifySend，由网关按用户渠道偏好和在线状态选路。2024年某街道用这套网关发防汛通知，3.2万人10分钟内全部触达，阅读率比改造前提升26%。

统一消息模型

网关先定义一套和具体渠道无关的消息体，字段覆盖标题、正文、跳转链接、业务标签。各渠道适配器负责把通用模型翻译成自家格式。例如微信模板消息要求固定的template_id和data结构，短信受70字一条的限制要做摘要裁剪。

这样业务代码不需要关心"这条消息到底走短信还是微信"。对比改造前，村干部发一条通知要切换3个系统，平均耗时从8分钟降到40秒。

渠道优选与降级

网关的选路逻辑是：优先APP Push，未装APP或推送失败的转微信模板，微信也失败的再补发短信。我们维护一张用户渠道表，记录每个村民的last_active_channel和device_token。实测显示，常住人口里62%首选APP Push，28%走微信，剩下10%靠短信兜底。

短信是按条计费的，阿里云接口对接后我们做了去重，同一用户30秒内相同bizTag的通知只发一次，2024年汛期因此省下约11万条短信费用。

精准标签推送

通知公告支持按特定标签人群精准推送，比如只发给"60岁以上"或"某网格"。标签来自网格信息管理系统，村民的网格归属、年龄、证件状态都存在MySQL 8.0.28里。网关先按标签查出目标userIds，再分批投递。

推送完成后，系统会记录每个人的送达和阅读状态，村干部能在后台看到"已读比例"，未读的人群可以单独补推。某村医保征缴时，靠这个能力把未读名单导出来人工电话提醒，参保率从81%提到95%。

发送速率与重试

短信接口有每秒发送上限，网关用令牌桶把发信速率控制在供应商配额内，超出进队列异步发。APP Push走个推或厂商通道，失败按指数退避重试3次。微信模板消息有每日调用上限，超量时自动降级为短信并打点告警。

可观测与对账

每条消息在网关侧落一条发送流水，含渠道、状态码、耗时、回执。运营每天对账：短信回执失败率超过2%就告警，排查是否通道欠费或签名过期。2023年有一次阿里云签名过期导致短信全失败，靠对账及时发现，半小时内恢复。

渠道成本核算

三条通道费用差异明显。阿里云短信按条计费，量大时单条约3分钱；微信模板和APP Push本身免费，但APP Push依赖厂商通道，部分厂商对日推送量有限制。我们按月的推送量做成本核算，当某村短信费用超预算时，自动把非紧急通知降级为微信和APP Push。2024年全年，靠渠道优选和去重，全县短信费用比2023年下降约34%，省下约8.6万元。

节假日峰值

春节返乡和汛期是推送高峰。春节前一周，某县单日通知量从日常的2万条涨到11万条，网关的令牌桶把短信速率稳定在供应商配额内，超量的转异步队列，凌晨低峰补发。对比2023年春节直接突袭式发送导致短信通道被限流、部分通知延迟6小时，2024年最迟的一批也在2小时内送达。运营在后台能实时看到各渠道的发送进度和失败数，异常一目了然。

阅读闭环

推送不是发出去就结束。系统统计每条通知的阅读率，未读用户可单独补推或转人工电话。某村医保征缴靠未读名单回访，参保率提升14个百分点。这个闭环让"通知必达"从口号变成可量化指标，村干部愿意用、也敢用。

模板审核

微信模板消息需要先到公众平台申请模板，字段固定。我们维护一套模板字典，新业务接入时先匹配已有模板，没有再走申请。这样避免重复申请和字段错位。统计显示，模板字典化后，新通知上线时间从平均2天缩到半天。

精准覆盖率

2024年汛期，某街道用精准标签给低洼区村民发转移通知，覆盖1200户，30分钟内阅读率91%，比群发短信的覆盖面更准，也减少了无关村民的打扰。推送网关的价值不在发得多，而在发得准。

推送效果度量

光发出去不够，还要看转化。我们按通知类型统计阅读率和后续动作率，比如医保通知发出后有多少村民点了办理入口。某县把这类数据按月汇总，发现晚上20点发的通知阅读率比上午高约18个百分点，于是把非紧急通知默认排到晚间。推送网关因此从"能发"进化到"发得准"，村干部的信任度明显提升。2024年全县通知平均阅读率从70%提到93%。这套度量也帮我们砍掉无效推送，对连续30天零阅读的沉睡账号降频，既省短信费又少打扰村民。

推送网关的价值不在发得多，而在发得准。2024年这套度量体系让全县通知阅读率稳定在93%以上，村干部从"群发完事"变成"看数据优化"。

小结

把短信、微信模板、APP Push收敛成统一网关，核心收益不是少写几行代码，而是让"通知必达"这件事有了可度量、可降级、可对账的底座。万村乐数字乡村的基层治理场景里，消息漏发往往意味着政策没传达到位，这套网关把触达率从过去的约70%提到了如今的93%以上。