| 【微信公众号】【消息推送】订阅通知（一次性订阅） | 您所在的位置：网站首页 › 苹果换屏幕多少钱xsmax › 【微信公众号】【消息推送】订阅通知（一次性订阅） |
【微信公众号】【消息推送】订阅通知（一次性订阅）
|
1 什么是订阅通知
订阅通知是一个用户主动订阅、服务号按需下发的通知能力，详情可见官方文档。 2 通知类型分类及区别通知类型：分为一次性订阅和长期订阅 一次性订阅，指用户订阅一次，服务号可不限时间地下发一条对应的订阅通知； 长期订阅，指用户订阅一次，服务号可长期多次下发通知，长期订阅通知仅向政务民生、医疗等公共服务领域开放。两者的使用区别： 一次性是用户同意一次，我们才能给用户发一条通知消息，是用户同意一次，发一次； 长期订阅是用户同意一次，可长期发送多次通知消息，但这个一般申请不下来，只有政务、医疗等才允许创建这种类型的订阅通知； 3 一次性订阅通知的消息发送步骤 3.1 用户授权进行用户同意授权，获得发送一次消息的机会，详情可见官方文档。 （1）准备授权的链接： 让用户在手机微信端打开如下链接信息，替换下方内容即可。 https://mp.weixin.qq.com/mp/subscribemsg?action=get_confirm&appid=公众号的APPID&scene=1000&template_id=订阅通知的模板ID&redirect_url=重定向的地址&reserved=test#wechat_redirect 注意： 订阅通知的模板ID，取图1中所示的授权模板ID，千万别取图2的； 重定向的地址，要取公众号里配置的业务域名下的地址，如图3； SDK方式的请求，返回的字符串即是上边手工拼出来的链接，SDK的好处是access_token不需要自己管理。 com.github.binarywang weixin-java-mp 3.2.0 public static void main(String[] args) { // 配置公众号信息 WxMpInMemoryConfigStorage wxStorage = new WxMpInMemoryConfigStorage(); wxStorage.setAppId("appId"); wxStorage.setSecret("secret"); wxStorage.setTemplateId("一次性授权模板ID"); // 服务 WxMpService wxMpService = new WxMpServiceImpl(); wxMpService.setWxMpConfigStorage(wxStorage); WxMpSubscribeMsgService subscribeMsgService = new WxMpSubscribeMsgServiceImpl(wxMpService); String res = subscribeMsgService.subscribeMsgAuthorizationUrl("跳转的路径", scene, "reserved"); System.out.println(res); }
图1 一次性订阅通知授权模板ID
图2 错误的授权模板ID
图3 重定向地址配置的域名位置 （2）微信授权 准备好授权链接以后，把链接复制到手机微信里打开，会出现如下图的授权弹窗，点击确认接收即可。 注意：电脑微信打开不行，我试的是不行。 用户授权完成，即可调接口发送订阅通知一次。 http请求方式: post https://api.weixin.qq.com/cgi-bin/message/template/subscribe?access_token=ACCESS_TOKEN 参数是否必须说明 touser 是 填接收消息的用户openid template_id 是 订阅消息模板ID url 否 点击消息跳转的链接，需要有 ICP 备案 miniprogram 否 跳小程序所需数据，不需跳小程序可不用传该数据 appid 是 所需跳转到的小程序appid（该小程序 appid 必须与发模板消息的公众号是绑定关联关系，并且小程序要求是已发布的） pagepath 是 所需跳转到小程序的具体页面路径，支持带参数,（示例index?foo=bar） scene 是 订阅场景值 title 是 消息标题，15字以内 data 是 消息正文，value为消息内容文本（200字以内），没有固定格式，可用\n换行，color为整段消息内容的字体颜色（目前仅支持整段消息为一种颜色） POST示例数据： { "touser":"OPENID", "template_id":"TEMPLATE_ID ！！！注意这里的模板ID 还是取第一步里用户授权模板ID", "url":"URL", "miniprogram":{ "appid":"xiaochengxuappid12345", "pagepath":"index?foo=bar ！！！这里的域名还是要在公众号里配置的业务域名范围里取" }, "scene":"SCENE", "title":"TITLE", "data":{ "content":{ "value":"VALUE", "color":"COLOR" } } }示例代码一（使用SDK的方式）： public static void main(String[] args) { // 配置公众号信息 WxMpInMemoryConfigStorage wxStorage = new WxMpInMemoryConfigStorage(); wxStorage.setAppId("appId"); wxStorage.setSecret("secret"); // 服务 WxMpService wxMpService = new WxMpServiceImpl(); wxMpService.setWxMpConfigStorage(wxStorage); WxMpSubscribeMsgService subscribeMsgService = new WxMpSubscribeMsgServiceImpl(wxMpService); // 配置小程序信息 WxMpSubscribeMessage.MiniProgram miniProgram = new WxMpSubscribeMessage.MiniProgram(); miniProgram.setAppid("跳转小程序appId"); WxMpSubscribeMessage subscribeMessage = WxMpSubscribeMessage.builder() .toUser("发送用户openId") .templateId("一次性授权模板ID") .miniProgram(miniProgram) .title("我是标题") .scene("scene") .contentValue("我是value\n 你好不好\n我不好") .build(); try { boolean b = subscribeMsgService.sendSubscribeMessage(subscribeMessage); System.out.println(b); } catch (WxErrorException e) { e.printStackTrace(); } }示例代码二（不使用SDK的方式）： public static void main(String[] args) { // 请求的API地址 String url = "https://api.weixin.qq.com/cgi-bin/message/template/subscribe"; // API token String accessToken = "你的access_token 这个你不会不知道怎么获取吧= = 不会的话建议改行吧"; // 准备内容数据 --消息主体内容 Map data = Maps.newHashMap(); data.put("content", Maps.immutableEntry("value", "尊敬的\n你好不好\n我不好")); // 准备请求数据 Map req = Maps.newHashMap(); req.put("touser", "发送用户的open_id"); //必须 req.put("template_id", "第一步里授权模板ID"); //必须 req.put("title", "我是标题"); //必须 req.put("scene", "1000"); //必须 不传的话 也会出现43101 user refuse to accept the msg req.put("miniprogram", Maps.immutableEntry("appid", "自己的小程序APPID")); //非必须 req.put("data", data); //必须 // 发送请求 String sendRes = HttpUtil .createPost(url + "?access_token=" + accessToken) .body(JSONObject.toJSONString(req)).execute().body(); System.out.println(sendRes); // 正常返回结果{ "errcode":0, "errmsg":"ok" } } {"errcode":42001,"errmsg":"access_token expired rid: 63800a69-7dccc6da-44475ab8"} access_token过期了 {"errcode":40001,"errmsg":"invalid credential, access_token is invalid or not latest rid: 63800a97-1ddcaeff-058ec99c"} access_token非法值不对 都需要检查一下access_token的获取对不对 4.2 错误码43101 这个很频繁！！！{"errcode":43101,"errmsg":"user refuse to accept the msg rid: 63800af8-2c456ad2-71a09b6f"} 检查步骤： （1）3.1 中的第一步，用户是否确认允许接受的授权 ！！！ 这个很重要 用户没允许的话 你再怎么发，微信都会拒绝掉 （2）检查参数里发送的url （3）检查参数里的模板ID，是不是和你授权用户订阅通知的模板ID是否一致，都是接口权限菜单里的一次性订阅模板ID （4）检查参数里是否有scene 这个不传也会报错 5 总结我第一次摸索的时候，导致卡顿的点在 1、压根不知道要先授权然后才能调接口发通知，否则你参数都对的话也会报错误码43101 2、模板ID 我一直是取的订阅通知里具体的哪个模板的ID 这个取的是错的，所以一直导致莫名的43101 希望大家能调试顺利，大家加油。 |
【本文地址】