微信小程序发送一次性订阅消息

原文

本文记录用户在微信小程序中主动订阅一次性消息，服务器接收订阅请求，定时通过发送订阅消息，最终在微信“服务通知”中显示。

一次性订阅消息用于解决用户使用小程序后，后续服务环节的通知问题。用户自主订阅后，开发者可不限时间地下发一条对应的服务消息；每条消息可单独订阅或退订。

一、在微信小程序后台启用并配置消息推送

登录微信小程序后台，在开发->开发管理->开发设置，下拉到消息推送面板，填写自己的服务器推送地址。

Token(令牌)和EncodingAESKey(消息加密密钥)随意，设置后最好不要再改变也不要泄露。

二、搭建服务器推送接口服务

步骤一中提到的服务器推送地址，需要自己编写代码搭建一个web api服务。

此接口服务要求，包括2个同名的接口，一个支持http get ，另外一个是http post。

在步骤一中设置推送地址时，腾讯服务器将请求http get的接口以进行权限归属认证，只调用一次。

当用户在微信小程序中主动订阅一次性消息时，腾讯服务器将请求http post的接口，发送用户的相关行为事件结果到开发者服务器。

http get接口示例：

[HttpGet]

public string Get(string signature, string timestamp, string nonce, string echostr)

{

return echostr;

}

http post接口示例：

[HttpPost]

public string Get()

{

try

{

StreamReader stream = new StreamReader(Request.Body);

string requestContent = stream.ReadToEndAsync().GetAwaiter().GetResult();

stream.Close();

//Tools.Log.WriteLog($"接收：{requestContent}");

return string.Empty;

}

请注意到这两个接口名称都是Get，其中http post接口中的参数requestContent就是当用户触发订阅消息弹框后，用户的相关行为事件结果。开发者须保存并解析这些数据，后续发送订阅消息时将会用到。

requestContent数据示例：

{

"ToUserName": "gh_123456789abc",

"FromUserName": "o7esq5OI1Uej6Xixw1lA2H7XDVbc",

"CreateTime": "1620973045",

"MsgType": "event",

"Event": "subscribe_msg_popup_event",

"List": [ {

"TemplateId": "hD-ixGOhYmUfjOnI8MCzQMPshzGVeux_2vzyvQu7O68",

"SubscribeStatusString": "accept",

"PopupScene": "0"

}],

}

三、获取模板 ID

登录微信小程序后台，打开功能->订阅消息，如果没有合适的模板，可以申请添加新模板，审核通过后可使用。

四、在微信小程序获取下发权限

在微信小程序中引导用户订阅消息，调用wx.requestSubscribeMessage(Object object)获取权限。

参考文档：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/subscribe-message/wx.requestSubscribeMessage.html

注意，wx.requestSubscribeMessage函数不能在回调函数中触发，可以在bindtap事件中绑定。

wx.requestSubscribeMessage({

tmplIds: [''],

success (res) { }

})

其中tmplIds填写的是步骤三中的模板ID

如图在微信小程序“密码盾”中的“习惯打卡”功能模块。

点击消息提醒按钮，选择提醒时间

确定后，提醒次数加1

五、服务器接收处理用户的相关行为事件结果

用户订阅消息后，腾讯将调用步骤二中的http post接口，并发送用户订阅的相关行为事件结果。最好在服务器后台保存这些事件结果，包括模板ID，发送者，订阅次数、发送时间等信息。

六、服务器按时发送订阅消息

参考文档：https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-message-management/subscribe-message/sendMessage.html

新建一个服务程序，定时查询用户的订阅消息列表，符合条件的组装数据下发订阅消息。

POST https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN

获取ACCESS_TOKEN，参考文档：https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-access-token/getAccessToken.html

每小时定时发送代码参考：

Thread t3 = new Thread(new ThreadStart(delegate ()

{

Tools.Log.WriteLog("定时发送订阅消息");

while (action)

{

try

{

DateTime now = DateTime.Now;

int nextMin = 60 - now.Minute;

Thread.Sleep(1000 * 60 * nextMin + 2000);

//调用发送订阅消息函数...

Thread.Sleep(1000 * 60 * 1);

}

catch (Exception ex)

{

Thread.Sleep(1000 * 60 * 1);

}

}

}));

t3.IsBackground = true;

t3.Start();

七、问题记录

1、一次性订阅必须是用户自主订阅后，开发者方可以不限时间地下发一条对应的服务消息。且订阅1次发送一次。

2、目前发现发送的数据中包含“优惠券”等字眼，发送失败。

3、当用户自主订阅时选择拒绝，则该模板的订阅次数将清0。如已经订阅了100次，一朝拒绝，次数清0。

4、wx.requestSubscribeMessage不能传递业务参数，可以在订阅成功后再次调用自定义的接口，进而完善业务流程。

原文：https://www.luweidong.cn/details/141