wx.requestSubscribeMessage
是微信小程序中用于向用户请求订阅消息的 API。
通过该API,小程序可以向用户申请授权,获取用户订阅消息的权限,然后向用户发送订阅消息。调用该 API 时,在第一次请求时,微信客户端会弹出授权窗口让用户确认是否授权订阅权限。
请求用户订阅消息的流程大致如下:
1、在 用户点击操作时,调用 wx.requestSubscribeMessage
。
2、在 success
回调函数中,获取到用户订阅消息的权限。
3、如果用户授权订阅消息的权限,可以向用户发送订阅消息。
以下是 wx.requestSubscribeMessage
示例代码:
wx.requestSubscribeMessage({
tmplIds: ['','',''], // 订阅消息模板ID 最多只能提醒三个模版消息
success(res) {
console.log("授权完成", res);
},
complete() {
console.log('接口调用结束的回调函数(调用成功、失败都会执行)');
},
fail(err){
console.log('失败了',err);
}
})
需要注意的是,订阅消息模板需要在小程序后台进行配置和审核。在调用 wx.requestSubscribeMessage
时,需要把订阅消息模板的 ID 传入 tmplIds
参数中。
在小程序中,不允许通过「授权提醒」类订阅消息发送广告、促销、抽奖等类似营销性质的订阅消息。如果发布此类订阅消息,小程序将会被封禁发布订阅消息的功能。