微信开发中的消息推送

大家好，欢迎来到IT知识分享网。

​ 因为微信开发需要配置服务器域名，所以需要一个已备案的域名。可以通过 NPS内网穿透工具的增强功能，使用 https将域名的 https请求穿透到本地网关端口。 NPS使用： NPS内网穿透-CSDN博客

​ 文末附有后端服务代码。

1. 小程序消息推送

1.1 功能介绍

​ 消息能力是小程序能力中的重要组成，我们为开发者提供了订阅消息能力，以便实现服务的闭环和更优的体验。

​ 订阅消息推送位置：服务通知

​ 订阅消息下发条件：开发者通过一定的方式触发用户主动订阅

​ 订阅消息卡片跳转能力：点击查看详情可跳转至该小程序的页面

​ 简单来讲，用户通过点击或支付完成后调用模板消息授权的弹窗，当用户成功授权后，开发者才可以通过调用微信接口，使用用户已授权模板发送订阅消息，进行消息提醒。

1.2 前提条件

​ 一个微信小程序账号，一个已备案域名。

1.3 准备工作

1.3.1 开通订阅消息

​ 登录小程序账号后，点击功能下的订阅消息，点击开通。

1.3.2 配置服务器域名

​ 登录小程序账号后，点击开发的开发管理，在开发设置下，找到服务器域名模块，修改request合法域名为 自己已备案域名。

1.3.3 生成小程序密钥

​ 若没有生成小程序密钥，则需要在开发设置下，生成小程序密钥。

1.4 订阅消息

1.4.1 一次性订阅

​ 一次性订阅消息指的是：用户订阅模板消息一次，只能推送一条模板消息。当第一次推送过后，用户尚未进行下一次的订阅操作，再次推送就会提示 用户未订阅消息 的错误信息。

1）获取并保存用户openid

​ 获取用户openid主要为两步，小程序获取用户登录凭证返回至后端服务，后端服务通过登录凭证获取用户的openid。

① 获取登录凭证

​ 小程序通过调用登录开放接口wx.login()获取到用户登陆凭证code，发送到自己的后端服务。

​ 详情请见: 微信官方文档-wx.login

参数：

​ Object object

object.success 回调函数

​ 参数：

​ Object res

object.fail 回调函数

​ 参数：

​ Object err

示例代码：

wx.login({ 
     success (res) { 
     if (res.code) { 
     //发起网络请求 wx.request({ 
     url: 'https://example.com/wx/login', data: { 
     code: res.code, userId："001" } }) } else { 
     console.log('登录失败！' + res.errMsg) } } }) 

② 获取用户openid

​ 后端服务通过调用 code2Session接口，获取到用户openid

​ 详情请见: 微信官方文档-小程序登录

接口文档：

GET https://api.weixin..com/sns/jscode2session 

请求参数：

返回参数

错误码：

示例代码：

 private final String appletAppid = "小程序的appid"; private final String appletSecret = "小程序的appSecret"; public void getAppletOpenid(String code) { 
     RestTemplate restTemplate = new RestTemplate(); // 调用 code2Session 接口 String codeJson = restTemplate.getForObject("https://api.weixin..com/sns/jscode2session" + "?appid=" + appletAppid + "&secret=" + appletSecret + "&js_code=" + code + "&grant_type=authorization_code", String.class); // 反序列化 Map bean = JSONUtil.parseObj(codeJson).toBean(Map.class); if (bean.get("openid") != null){ 
     saveOpenid(bean.get("openid").toString()); }else { 
     throw new RuntimeException("openid获取失败， 错误码:" + bean.get("errcode") + " 错误信息:" + bean.get("errmsg")); } } private void saveOpenid(String openid){ 
     // 可以从token中获取到用户信息，并将openid保存至数据库 System.out.println("用户的openid:" + openid + " 获取成功"); } 

2）用户授权

​ 这里我们首先需要选择需要用户授权的模板，然后让用户调起订阅界面。

① 选用模板

​ 为了简单测试，这里选用了公共模板库中的一个下单提醒模板。若为了满足业务需求，可以申请一个模板（每月有申请次数限制！）。

​ 如果公共模板库没有模板，需先在小程序设置中，选择服务类目。

​ 申请模板在公共模板库的最后一页帮忙我们完善模板库，点击进去，完善相关信息，等待审核。若审核通过，就可以使用了。

② 用户调用

​ 通过用户点击调起客户端小程序订阅消息模板界面，返回用户订阅消息模板的操作结果。当用户勾选了”总是保持以上选择，不再询问”，在下次授权时，默认确定，不再进行弹窗提示（真机调试才会出现）。

​ 详情请见: 微信官方文档-wx.requestSubscribeMessage

接口：

wx.requestSubscribeMessage(Object object) 

参数：

​ Object object

object.success 回调函数

​ 参数：

​ Object res

object.fail 回调函数

​ 参数：

​ Object res

错误码：

示例代码：

 var TemplateId = '第一步选用的模板Id' var TemplateStatus = wx.getStorageSync('TemplateID') if(TemplateStatus != 'accept'){ wx.requestSubscribeMessage({ tmplIds: [TemplateId], complete (res) { console.log("complete: ",res) wx.setStorageSync('TemplateId', res[TemplateId]) }, }) } 

效果展示：

​ PC效果：

​ 真机效果：

3）发送订阅消息

​ 后端服务首先调用getAccessToken接口，获取接口调用凭证。再调用sendMessage接口，实现向用户推送一条已订阅的模板消息。

① 获取接口调用凭证

​ token有效期为7200s

​ 详情请见: 微信官方文档-获取接口调用凭据

接口：

GET https://api.weixin..com/cgi-bin/token 

请求参数：

返回参数：

其他说明：

• access_token 的存储至少要保留 512 个字符空间；
• access_token 的有效期目前为 2 个小时，需定时刷新，重复获取将导致上次获取的 access_token 失效；
• access_token 的有效期通过返回的 expires_in 来传达，目前是7200秒之内的值，中控服务器需要根据这个有效时间提前去刷新。在刷新过程中，中控服务器可对外继续输出的老 access_token，此时公众平台后台会保证在5分钟内，新老 access_token 都可用，这保证了第三方业务的平滑过渡；

示例代码：

 private String getAccessToken(){ // 这里可以结合redis进行缓存 RestTemplate restTemplate = new RestTemplate(); String accessTokenJson = restTemplate.getForObject("https://api.weixin..com/cgi-bin/token" + "?grant_type=client_credential" + "&appid=" + appletAppid + "&secret=" + appletSecret, String.class); Map bean = JSONUtil.parseObj(accessTokenJson).toBean(Map.class); if (bean.get("access_token") != null){ return bean.get("access_token").toString(); }else { throw new RuntimeException("凭证获取失败， 错误码:" + bean.get("errcode") + " 错误信息:" + bean.get("errmsg")); } } 

② 推送订阅消息

​ 详情请见: 微信官方文档-推送订阅消息

接口：

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

Post参数：

返回参数：

错误码：

其他说明：

​ 符号表示除中文、英文、数字外的常见符号，不能带有换行等控制字符。 时间格式支持HH:MM:SS或者HH:MM。 日期包含年月日，为y年m月d日，y年m月、m月d日格式，或者用‘-’、‘/’、‘.’符号连接，如2018-01-01，2018/01/01，2018.01.01，2018-01，01-01。 每个模板参数都会以类型为前缀，例如第一个数字模板参数为number01.DATA，第二个为number02.DATA

示例代码：

 public void appletSendMessage() { String accessToken = getAccessToken(); RestTemplate restTemplate = new RestTemplate(); Map<String, Object> map = new HashMap<String, Object>(); map.put("touser", "用户的openid"); map.put("template_id", "消息模板id"); // 模板数据 Map<String, Object> data = new HashMap<String, Object>(); data.put("thing1", Collections.singletonMap("value", "测试订阅推送")); data.put("number2", Collections.singletonMap("value", 10001)); data.put("amount3", Collections.singletonMap("value", "100元")); data.put("thing4", Collections.singletonMap("value", "测试订单消息推送")); map.put("data", data); HttpEntity<Map<String, Object>> request = new HttpEntity<Map<String, Object>>(map); String resultJson = restTemplate.postForObject("https://api.weixin..com/cgi-bin/message/subscribe/send" + "?access_token=" + accessToken, request, String.class); Map bean = JSONUtil.parseObj(resultJson).toBean(Map.class); if (Integer.parseInt(bean.get("errcode").toString()) != 0){ throw new RuntimeException("发送失败， 错误码:" + bean.get("errcode") + " 错误信息:" + bean.get("errmsg")); } } 

效果展示：

1.4.2 长期订阅

​ 目前长期性订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，后期将逐步支持到其他线下。 因为目前没有涉及线下服务业务，所以本文不进行过多介绍。

2. 公众号消息推送

2.1 一次性订阅消息

2.1.1 功能介绍

​ 开发者可以通过一次性订阅消息授权让微信用户授权第三方移动应用（接入说明）或公众号，获得发送一次订阅消息给到授权微信用户的机会。授权微信用户可以不需要关注公众号。微信用户每授权一次，开发者可获得一次下发消息的权限。（注意：同一用户在同一scene场景值下的多次授权不累积下发权限，只能下发一条。若要订阅多条，需要不同scene场景值）

​ 消息下发位置说明：对于已关注公众号的，消息将下发到公众号会话里；未关注公众号的，将下发到服务通知。

​ 详情请见：微信官方文档-公众号一次性订阅消息

2.1.2 前提条件

​ 一个已认证的服务号，一个已备案域名。

2.1.3 准备工作

​ 注意：若服务号未进行认证，则不能进行相关信息的配置。

配置业务域名

​ 登录服务号账号后，点击设置与开发下的公众号设置，选择功能设置，找到业务域名进行设置。

​ 这里我把TXT文件放到了后端服务的 resources下的static目录下，通过nps的使用https，即可将服务请求转发到本机后端服务完成校验。

2.1.4 消息推送

1）用户授权

​ 在确保微信公众账号拥有订阅消息授权的权限的前提下（已认证的公众号即有权限，可登录公众平台在接口权限列表处查看），引导用户在微信客户端打开如下链接：

https://mp.weixin..com/mp/subscribemsg?action=get_confirm&appid=wxaba38c7f163da69b&scene=1000&template_id=1uDxHNXwYQfBmXOfPJcjAS3FynHArD8aWMEFNRGSbCc&redirect_url=http%3a%2f%2fsupport..com&reserved=test#wechat_redirect 

参数：

示例代码：

 // 这里通过生成二维码引导用户授权 public void officialAuth(HttpServletResponse response) { String url = "https://mp.weixin..com/mp/subscribemsg" + "?action=get_confirm" + "&appid=" + officialAppid + "&scene=" + "0001" + "&template_id=" + "接口权限列表处一次性订阅消息模板id" + "&redirect_url=" + "https://业务域名/wx/official/send( urlEncode 进行处理)" + "#wechat_redirect"; response.setContentType("image/png"); try { QrCodeUtil.generate(url,300,300,"jpg",response.getOutputStream()); } catch (IOException e) { throw new RuntimeException(e); } } 

​ 打开页面localhost:8080/wx/official/auth，通过微信扫一扫进行扫码，点击确认接收。

效果展示：

回调接口：

​ 如果用户点击同意或取消授权，页面将跳转至：

redirect_url/?openid=OPENID&template_id=TEMPLATE_ID&action=ACTION&scene=SCENE 

参数：

示例代码：

 public void getOfficialOpenid(Map<String, Object> params) { String openid = params.get("openid").toString(); if (openid != null){ saveOpenid(openid); }else { String action = "confirm".equals(params.get("action").toString()) ? "确定授权" : "取消授权"; throw new RuntimeException("openid获取失败， 用户行为:" + action); } } 

2）发送订阅消息

① 获取接口调用凭证

​ 获取方式如同 1.4.1节第三部分第一步。

② 推送订阅消息

​ 通过API推送订阅模板消息给到授权微信用户。

接口：

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

Post参数：

​ 注：url和miniprogram都是非必填字段，若都不传则模板无跳转；若都传，会优先跳转至小程序。开发者可根据实际需要选择其中一种跳转方式即可。当用户的微信客户端版本不支持跳小程序时，将会跳转至url。

返回说明：

{ "errcode":0, "errmsg":"ok" } 

示例代码：

 public void officialSendMessage() { String accessToken = getAccessToken(officialAppid, officialSecret); RestTemplate restTemplate = new RestTemplate(); Map<String, Object> map = new HashMap<String, Object>(); map.put("touser", "用户openid"); map.put("template_id", "接口权限列表处一次性订阅消息模板id"); map.put("title", "阅读消息推送"); map.put("scene", "0001"); map.put("data", Collections.singletonMap("content", Collections.singletonMap("value", "文章制作不易，请留下一个小赞，谢谢。"))); String resultJson = restTemplate.postForObject("https://api.weixin..com/cgi-bin/message/template/subscribe?access_token=" + accessToken, map, String.class); Map result = JSONUtil.parseObj(resultJson).toBean(Map.class); if (Integer.parseInt(result.get("errcode").toString()) != 0){ throw new RuntimeException("发送失败， 错误码:" + result.get("errcode") + " 错误信息:" + result.get("errmsg")); } } 

效果展示：

2.2 模板消息

2.2.1 功能介绍

​ 模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。

​ 详情请见：微信官方文档-模板消息

2.2.2 前提条件

​ 一个已注册服务号，已备案域名。

​ 若没有注册服务号，也可以使用测试账户。

​ 若没有备案域名，也可以使用免费Cpolar内网穿透工具。

​ 本文使用已注册服务号进行演示。

2.2.3 准备工作

1）设置服务类目

​ 登录服务号账号后，点击设置与开发下的公众号设置，选择账号详情，找到服务类目，点击详情，进行设置。

2) 开通模板消息

​ 登录服务号账号后，点击+ 新的功能，找到 广告与服务中的模板消息 ，点击去开通，进行开通。

3）选择模板消息

​ 登录服务号账号后，点击广告与服务下的模板消息，选择模板库，选择模板。若没有贴合业务的模板，可点击右上角 帮助我们完善类目模板库，进行模板申请。

4）网页授权及业务域名配置

​ 登录服务号账号后，点击设置与开发下的公众号设置，选择功能设置，找到网页授权域名和业务域名，点击设置，进行配置。

2.2.4 消息推送

1）获取并保存用户openid

​ 详情请见： 微信官方文档-网页授权

​ 引导用户在微信客户端打开网页授权页面，获取登录凭证。

接口：

https://open.weixin..com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect 

​ 若提示“该链接无法访问”，请检查参数是否填写错误，是否拥有scope参数对应的授权作用域权限。

​ 尤其注意：由于授权操作安全等级较高，所以在发起授权请求时，微信会对授权链接做正则强匹配校验，如果链接的参数顺序不对，授权页面将无法正常访问。

参数：

​ 下图为scope等于snsapi_userinfo时的授权页面：

示例代码：

 // 这里通过生成二维码引导用户授权 public void officialRouter(HttpServletResponse response) { String redirectUrl = URLEncoder.encode("https://" + doMainName + "/wx/official/login"); String url = "https://open.weixin..com/connect/oauth2/authorize" + "?appid=" + officialAppid + "&redirect_uri=" + redirectUrl + "&response_type=code" + "&scope=snsapi_base" + "&state=" + "0001" + "#wechat_redirect"; response.setContentType("image/png"); try { QrCodeUtil.generate(url,300,300,"jpg",response.getOutputStream()); }catch (IOException e){ throw new RuntimeException(e); } } 

用户同意授权后

​ 如果用户同意授权，页面将跳转至

 redirect_uri/?code=CODE&state=STATE。 

code说明：

code作为换取access_token的票据，每次用户授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。

错误码：

示例代码：

 public void officialLogin(Map<String, Object> params) { RestTemplate restTemplate = new RestTemplate(); String resultJson = restTemplate.getForObject("https://api.weixin..com/sns/oauth2/access_token" + "?appid=" + officialAppid + "&secret=" + officialSecret + "&code=" + params.get("code").toString() + "&grant_type=authorization_code", String.class).toString(); Map result = JSONUtil.parseObj(resultJson).toBean(Map.class); if (result.get("openid") != null){ saveOpenid(result.get("openid").toString()); }else { throw new RuntimeException("openid获取失败， 错误码:" + result.get("errorcode") + "错误信息：" + result.get("errmsg")); } } 

2）消息推送

接口：

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

Post参数：

​ 注：url和miniprogram都是非必填字段，若都不传则模板无跳转；若都传，会优先跳转至小程序。开发者可根据实际需要选择其中一种跳转方式即可。当用户的微信客户端版本不支持跳小程序时，将会跳转至url。

返回码说明

其他说明：

​ 符号表示除中文、英文、数字外的常见符号，不能带有换行等控制字符。 时间格式支持HH:MM:SS或者HH:MM。 日期包含年月日，为y年m月d日，y年m月、m月d日格式，或者用‘-’、‘/’、‘.’符号连接，如2018-01-01，2018/01/01，2018.01.01，2018-01，01-01。 每个模板参数都会以类型为前缀，例如第一个数字模板参数为number01.DATA，第二个为number02.DATA

代码示例：

 public void officialTemplateSend() { String accessToken = getAccessToken(officialAppid, officialSecret); RestTemplate restTemplate = new RestTemplate(); Map<String, Object> map = new HashMap<String, Object>(); map.put("touser", "用户openid"); map.put("template_id", "公众号下模板消息的模板id"); Map<String, Object> data = new HashMap<String, Object>(); data.put("thing3", Collections.singletonMap("value", "测试模板")); data.put("thing13", Collections.singletonMap("value", "张三")); data.put("thing6", Collections.singletonMap("value", "李四")); data.put("time5", Collections.singletonMap("value", "2024-07-30")); map.put("data", data); String resultJson = restTemplate.postForObject("https://api.weixin..com/cgi-bin/message/template/send?access_token=" + accessToken, map, String.class); Map result = JSONUtil.toBean(resultJson, Map.class); if (0 != Integer.parseInt(result.get("errcode").toString())){ throw new RuntimeException("发送失败， 错误码:" + result.get("errcode") + " 错误信息:" + result.get("errmsg")); } } 

效果展示：

3. 后端代码仓库

​ 代码地址：微信消息推送后端演示代码