微信模板消息接口已于2023年10月1日停用，c#现仅能通过订阅通知（需用户授权+模板审核）或客服消息（48小时内被动触发）发送消息，二者均受严格限制。
微信模板消息接口已停用，C# 不能再发
微信官方在 2023 年 10 月 1 日起全面下线「模板消息」接口（https://api.weixin.qq.com/cgi-bin/message/template/send），所有调用返回 {"errcode":48002,"errmsg":"template message api is deprecated"}。这不是你代码写错了，是微信彻底砍掉了这个能力。
现在能用的只有两种替代方案：「订阅通知」和「服务号客服消息」，但二者限制极严，且需用户主动触发。
用 C# 发订阅通知：必须用户点击按钮授权 + 模板需审核
订阅通知（subscribe_msg.send）不是“群发”，而是用户在小程序或网页里点一次「允许接收」后，你才能发一条（且仅限该模板 ID 对应的类目）。C# 调用时要注意：
- 请求地址是
https://api.weixin.qq.com/cgi-bin/message/subscribe/send，不是旧模板消息地址 - 必须携带
access_token，且该 token 必须由服务号（非测试号）获取，测试号不支持订阅通知 - 请求体中的
template_id必须已在公众号后台「功能 → 订阅通知」中提交并审核通过，未审核或类目不匹配会返回errcode: 43101 - 用户
openid必须是该服务号的粉丝，且用户最近 90 天内与公众号有交互（如关注、点击菜单、打开网页等），否则发不出
示例关键字段（JSON body）：
{
"touser": "oAbcD1234567890abcdef1234567890",
"template_id": "ZxYvWuTsrQpOnMlKjIhGfEdCbA987654",
"data": {
"thing1": { "value": "订单已发货" },
"date2": { "value": "2024-06-15 14:30" }
}
}
C# 调用时 access_token 容易失效或拿错
很多人卡在 token 这一步：用测试号的 appid/appsecret 去拿 token，或者缓存了过期的 token（2 小时失效），导致请求直接报 errcode: 40001 或 40014。
- 务必确认你用的是服务号的
appid和appsecret，不是测试号的 - token 必须单独做刷新逻辑：首次获取后存入内存或 Redis，并在失效前 5 分钟主动刷新；不要每次请求都重新拉一遍
- 微信返回的 token 是字符串，不含引号，别手动加双引号再拼 URL
- 如果用 HttpClient，记得设置
DefaultRequestHeaders.Accept为application/json，否则某些代理环境会返回 HTML 错误页
客服消息是唯一能“主动推”的补救方式，但有 48 小时限
如果用户刚给你发过消息（任意文本、图片、事件），你可以在 48 小时内用客服消息接口（message/custom/send）回复任意内容——包括带跳转链接的图文卡片。这成了目前最实用的“准推送”手段。
- 接口地址：
https://api.weixin.qq.com/cgi-bin/message/custom/send - 只能发给最近 48 小时内主动发起过对话的用户，超时发就返回
errcode: 45015 - 消息类型支持
text、image、news（图文），但news的 url 必须是公众号已发布过的文章链接，不能外链 - C# 发送时注意 JSON 中的
msgtype字段名大小写敏感，写成MsgType或MSGTYPE都会失败
客服消息没有模板审核环节，适合紧急通知（比如支付成功后立刻发个带订单详情的卡片），但无法用于定时、批量场景。
真正麻烦的不是代码怎么写，而是微信把“主动触达权”收得越来越紧——哪怕你 C# 写得再稳，没用户授权、没合规模板、没 48 小时窗口，照样发不出去。别在过时文档里打转，先去公众号后台看清楚「订阅通知」的类目开放情况，再决定要不要切小程序或企业微信。
