微信小程序订阅消息授权弹窗问题整理-编程知识

文档

小程序订阅消息（用户通过弹窗订阅）开发指南 | 微信开放文档

1.报错10004

errCode: 10004
errMsg: "requestSubscribeMessage:fail Invalid template id"

真机调试也不行

wx.requestSubscribeMessage({tmplIds: result,// 用户同意与否都需要传标识给后端success(res) {
}

[{ "templateId": "MvyaI3UcBWMpjFLcM_4_quuSJDftIsgbJ3ykuD", "title": "福利包到账提醒" },{ "templateId": "sDCqzUaMapgSETh_LHpuf0VuKaLXKMDltrOSlz8YADE", "title": "优惠券过期提醒" },]

原因：tmplIds参数必须是数组

const result = ["MvyaI3UcBWMpjFLcM_4_quuSJDftIsgbJ3ykuD","sDCqzUaMapgSETh_LHpuf0VuKaLXKMDltrOSlz8YADE"]

2.用户第一次拒绝，第二次不掉弹窗直接到success

wx.requestSubscribeMessage接口的success中res参数

我试着加了第三个模板ID：发现第二次弹窗只谈了加的模板id对应的模板title，之前被拒绝过的没有再显示

const result = ["MvyaI3UcBWMpjFLcM_4_quuSJDftIsgbJ3ykuD-bHW4","sDCqzUaMapgSETh_LHpuf0VuKaLXKMDltrOSlz8YADE","PokxmMG5bvk_LK7hrz40qqaliqKzAn6vyKkJPwbN7Sc"]

3.用户选择总是保持以上选择后，点击了拒绝

正常情况下，用户选择了总是保持以上选择后，点击了拒绝，之后就不会再次弹窗，如果下次进入时想要弹窗，需要通过微信小程序wx.openSetting()去引导用户到设置页面主动设置接收订阅消息

主要流程：

调用后端接口获取需要授权的模板ID；
通过wx.requestSubscribeMessage调用订阅消息授权弹窗；
检测到有拒绝授权情况就引导用户去设置页面设置接收订阅消息；
否则直接调用后端接口将已经同意过的模板进行上报；

/*** 根据pushSceneId场景ID获取没有授权的模板* @param {*} pushSceneId */
function commSubscribeMessage(pushSceneId) {return new Promise((resolve, reject) => {// 根据场景ID获取需要订阅消息的模板// ajax('get', 'api/wechat/auth/unsubscribe/list', {//   pushSceneId// }, ({ code, msg, result }) => {//   console.log('订阅结果上报', code, result)//   // 模板ID不为空才进行授权弹窗//   if (code === 0 && result.length > 0) {// wx.requestSubscribeMessage调起授权订阅消息弹窗// 优惠券// const tmplIds = ["MvyaI3UcBWMpjFLcM_4_quuSJDftIsgbJ3ykuD-bHW4",//   "sDCqzUaMapgSETh_LHpuf0VuKaLXKMDltrOSlz8YADE"]// 活动// const tmplIds = ["PokxmMG5bvk_LK7hrz40qqaliqKzAn6vyKkJPwbN7Sc"]const tmplIds = ["Uc-DA-Jr3N4ih7d5M3PkPrTFOi6t-AX0MGj4S8hvHqU"]// 提单// const tmplIds = ["3d6zsNMfQ3Wpgq1V8duO31v9gE8un7Lka_2E17sJZjs"]wx.requestSubscribeMessage({tmplIds,// 用户同意与否都需要传标识给后端async success(res) {let acceptTmplIds = [];let rejectTmplIds = [];tmplIds.forEach(item=>{if(res[item] === 'accept'){acceptTmplIds.push(item);}else if( res[item] === 'reject'){rejectTmplIds.push(item);}});// 检测到有拒绝授权情况if(rejectTmplIds.length > 0){console.log("引导用户授权");await guideOpenSubscribeMessage(tmplIds,pushSceneId);resolve(true);}else{console.log("用户之前已经同意过授权");await agreeSubscribe(tmplIds,pushSceneId);resolve(true);}},async fail(res) {console.log("用户拒绝授权", res);if (res.errCode == 20004) {// console.log(res, 'fail:用户关闭了主开关，无法进行订阅,引导开启---');await guideOpenSubscribeMessage(tmplIds,pushSceneId);resolve(true);}}})
});
}function guidSubscribeMessageAuthAfter(templateIds) {return new Promise((resolve, reject) => {//引导用户 开启订阅消息 之后，「openSetting」 接口暂时不会返回，用户手动设置后的状态，所以采用「getSetting」接口重新进行查询wx.openSetting({success: res => {console.log(res, "guidSubscribeMessageAuthAfter");}})resolve(true);});
}
function guideOpenSubscribeMessage(templateIds,pushSceneId) {return new Promise((resolve, reject) => {//引导用户，手动引导用户去设置页开启，wx.showModal({title: '提示',content: '检测到您有未开启的订阅消息权限，是否去设置？',showCancel: true,confirmText: '确认',success: function (res) {if (res.confirm) {// 新版禁用，需要通过按钮触发console.log("去设置授权信息");guidSubscribeMessageAuthAfter(templateIds);resolve(true);} else {console.log(`您已拒绝订阅消息授权，无法预约领取`);disagreeSubscribe(templateIds,pushSceneId);resolve(true);}}})
});
}
function agreeSubscribe(templateIds,pushSceneId) {ajax('post', '/api/wechat/auth/subscribe', {templateIds,pushSceneId,allow: 1}, res1 => {console.log('订阅结果上报', res, res1)})
}
function disagreeSubscribe(templateIds,pushSceneId) {ajax('post', '/api/wechat/auth/subscribe', {templateIds,pushSceneId,allow: 0}, res1 => {console.log('用户拒绝授权订阅结果上报', res, res1)})
}

使用：

  async goPage(e) {// 授权订阅消息弹窗await commSubscribeMessage("SC_001");
}

4.不引导用户去设置页面，但是要将用户是否选择过永远选中此项传给后端；且需要传openId和每个模板id都有个是否允许授权订阅的状态

 let openId = wx.getStorageSync('userInfo').openId;

5.弹窗涉及所有成功或失败场景：

1.模板数据超过3个，报错20003
2.用户关闭了总开关（设置里面订阅消息的总开关关闭） 20004
3.之前弹窗过，且选择了拒绝，且选中了永远保持以上选择，只会返回以下信息，不会弹窗

MvyaI3UcBWMpjFLcM_4_quuSJDftIsgbJ3ykuD-bHW4: "reject"
PokxmMG5bvk_LK7hrz40qqaliqKzAn6vyKkJPwbN7Sc: "reject"
Uc-DA-Jr3N4ih7d5M3PkPrTFOi6t-AX0MGj4S8hvHqU: "reject"

4.用户手动在设置页面设置了接收消息，不会弹窗，只会显示一下信息

MvyaI3UcBWMpjFLcM_4_quuSJDftIsgbJ3ykuD-bHW4: "accept"
PokxmMG5bvk_LK7hrz40qqaliqKzAn6vyKkJPwbN7Sc: "accept"
Uc-DA-Jr3N4ih7d5M3PkPrTFOi6t-AX0MGj4S8hvHqU: "accept"

5.所以想在获取用户是否选中了永远保持以上选择需要通过 wx.getSetting 进行获取

6.用户弹窗总流程

1.通过wx.getSetting()判断用户是否选择了"永远保持以上选择"，如果选中了，需要通知后端，同时通知后端拒绝或者接受订阅的模板

2.如果用户没有选中，每次都会调用弹窗，调用微信小程序接口wx.requestSubscribeMessage()调起弹窗

7.小程序userId和openId关系

userid是用户登录小程序的荷叶的唯一标识
openid是小程序账号的唯一标识
openid跟手机号没关系的，跟微信号一一对应；
次数限制是订阅一次推一次，看产品意思是userid维度订阅，一天订阅一次是咱们这边业务上的限制，不是微信的限制，微信一天内不限制一次性订阅的次数
还有个场景，如果推送消息也是按userid维度推送，小程序只能登录一个手机号，如果同一个小程序多个手机号登录且订阅授权过，那推送消息的时候，当时小程序登录的只有其中一个手机号，那么其他未登录手机号的订阅消息会在同一个小程序内收到，或者其他手机号在另外的微信上登录，一个userid可能对应多个openid,会在两个小程序上都收到订阅消息
推送消息，使用userid+openid维度进行推送