微信订阅消息模板消息推送-JAVA

本文详细介绍如何申请小程序订阅消息模板,获取用户授权,以及使用Java后台通过HTTPS调用微信接口发送通知的过程,助你高效搭建消息推送系统。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

最近公司做小程序需要用到订阅消息推送,笔者在一路采坑做完后几个笔记,希望能帮到大家少走弯路。

如果你连小程序都没有注册也没有做,那就不要继续看了。。。。。。。

微信官方文档 小程序订阅消息 | 微信开放文档 


一、申请模板

在小程序的 公共模板库中如果找不到你需要的模板,可以申请自己的模板,如下图所示

公共模板库 - 一次性订阅 - 翻到最后一页 - 点击忙帮我们完善模板库 

 如图填写好模板的 各个属性即可,属性详细点击问号可以查看。然后提交等待审批即可

 审核通过后 即可在我的模板中查看到信息


 二、小程序获得授权

官方文档:  wx.requestSubscribeMessage(Object object)

       wx.requestSubscribeMessage({
            tmplIds: ['你的订阅消息模板id'],
            success(res) {
                console.log(res);
            }, fail(res) {
                console.log(res);
            }
        })

这里测试的时候发现,你同意了几次,后面就可以给你发送几次一次性订阅消息


三、后台java代码编写(HTTPS调用)

官方文档:subscribeMessage.send | 微信开放文档

1、获取微信接口调用凭证

因为需要调用微信接口去发送 服务通知,所以这里首先得获取到调用接口里的参数

官方文档:auth.getAccessToken | 微信开放文档

对照上述文档,java 开发获取token,这里的 token 有效期 2小时,为了避免频繁请求微信服务,所以讲该 token 存起来,过期失效后 再重新请求,这里没有用到redis等,就直接用 JWT附上有效时间加密后存到数据库,然后取出来解密查看是否过期,没有过期就继续用,过期了就找微信再要一次 token 。

    @GetMapping("/test")
    public void test() throws IOException {
        // 1、获取 接口调用凭证
        String wxApiToken = commonService.getWXApiToken();

        // 2、 post
        String url = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=" + wxApiToken;
        HttpClient httpClient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost(url);
        httpPost.setHeader("Content-Type", "application/json");
        httpPost.setHeader("Accept", "application/json");

        Map<String, Object> dataMap = new HashMap<>();
        dataMap.put("touser", "这里是接收通知用户的小程序下唯一openId");
        dataMap.put("template_id", "这里是一次性订阅模板id");
        dataMap.put("page", "这里是跳转小程序的页面,可以不填写"); // 小程序跳转界面
        dataMap.put("miniprogram_state", "developer"); // 跳转小程序类型

        // 按照 模板 拼参数
        Map<String, Map<String, String>> ddMap = new HashMap<>();
        Map<String, String> ddvMap = new HashMap<>();
        ddvMap.put("value", "1"); 
        ddMap.put("thing1", ddvMap);
        ddvMap = new HashMap<>();
        ddvMap.put("value", "2");
        ddMap.put("thing2", ddvMap);
        ddvMap = new HashMap<>();
        ddvMap.put("value", "2022年5月25日 11:25"); 
        ddMap.put("time3", ddvMap);
        ddvMap = new HashMap<>();
        ddvMap.put("value", "落3");
        ddMap.put("short_thing4", ddvMap);

        dataMap.put("data", ddMap);

        String content = JSONObject.toJSON(dataMap).toString();

        StringEntity stringEntity = new StringEntity(content,"UTF-8");
        httpPost.setEntity(stringEntity);


        HttpResponse response = httpClient.execute(httpPost);
        HttpEntity entity = response.getEntity();
        String strEntity = EntityUtils.toString(entity, "UTF-8");

        JSONObject jsonObject = JSON.parseObject(strEntity);

    }
    public String getWXApiToken() throws IOException {

        // 1、从数据库取 微信凭证
        // TODO 这里换成自己的 DAO
        String wxApiToken = baseMapper.getWXData(WX_API_TOKEN);

        // 2、如果是 空,获取 微信凭证 并保存到数据库
        if (StringUtils.isEmpty(wxApiToken)) {
            return createWXApiToken();
        }

        // 3、检查 token 是否过期
        Claims claimByToken = jwtUtils.getClaimByToken(wxApiToken);
        Date expiration = claimByToken.getExpiration();
        if (jwtUtils.isTokenExpired(expiration)) {
            return createWXApiToken();
        }

        // 4、返回 未过期的 数据库中存储的 微信接口调用凭证
        return claimByToken.getSubject();
    }
   private String createWXApiToken() throws IOException {

        // GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
        String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + MNWXConfig.appid + "&secret=" + MNWXConfig.secret;
        HttpClient httpClient = HttpClients.createDefault();
        HttpGet httpGet = new HttpGet(url);
        HttpResponse response = httpClient.execute(httpGet);
        HttpEntity entity = response.getEntity();
        String strEntity = EntityUtils.toString(entity, "UTF-8");
        JSONObject jsonObject = JSON.parseObject(strEntity);

        if (!"null".equals(String.valueOf(jsonObject.get("errcode"))) &&
                !String.valueOf(jsonObject.get("errcode")).equals("0")) {
            return null;
        } else {
            // 凭证有效时间,单位:秒。目前是7200秒之内的值
            String expiresIn = String.valueOf(jsonObject.get("expires_in"));
            // 接口调用凭证
            String accessToken = String.valueOf(jsonObject.get("access_token"));

            // 加密后 存入 数据库
            Date nowDate = new Date();
            Date expireDate = new Date(nowDate.getTime() + Integer.parseInt(expiresIn) * 1000);
            String encryptToken = jwtUtils.generateToken(accessToken, expireDate);

            // TODO 这里换成自己的 DAO
            baseMapper.updateWXData(WX_API_TOKEN, encryptToken);
            return accessToken;
        }

    }
	public String generateToken(String target, Date expireDate) {
        String secret = "替换成你自己的加密秘钥";
		return Jwts.builder().setHeaderParam("type", "JWT").setSubject(target).setIssuedAt(expireDate)
				.setExpiration(expireDate).signWith(SignatureAlgorithm.HS512, secret).compact();
	}


	public boolean isTokenExpired(Date expiration) {
		return expiration.before(new Date());
	}


	public Claims getClaimByToken(String token) {
        String secret = "替换成你自己的加密秘钥"
		try {
			return Jwts.parser().setSigningKey(secret).parseClaimsJws(token).getBody();
		} catch (Exception e) {
			logger.debug("validate is token error ", e);
			return null;
		}
	}

 对应错误码参考官方文档,如果一切顺利,那么对应 openId 的手机微信就会受到服务消息

### Java 后端实现向微信小程序推送订阅消息 #### 准备工作 为了能够顺利地完成Java后端向微信小程序推送订阅消息的任务,需先准备好以下几项: - **微信公众平台账号**:确保已拥有并登录了一个有效的微信公众平台账号,并创建了相应的小程序项目[^3]。 - **获取必要的参数**: - `AppID` 和 `AppSecret`: 这些信息可以在微信公众平台上找到,用于后续API调用的身份验证。 - `OpenID`: 用户唯一标识符,在用户授权给小程序之后可以得到该用户的openid。 - **配置服务器环境** - 设置好开发者服务器的相关URL地址以及Token和EncodingAESKey等安全设置。这些配置将在接收来自微信消息时起到校验作用[^2]。 #### 获取 Access Token Access Token 是调用微信开放接口的前提条件之一,它是一个临时票据,有效期为7200秒(即两小时),因此建议定时刷新以保持有效性。可以通过如下HTTP GET请求来获得此令牌: ```http GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET HTTP/1.1 Host: api.weixin.qq.com ``` 响应数据通常会返回JSON格式的内容,其中包含了所需的access_token字段值[^1]。 #### 发送订阅消息 当获得了合法的access_token之后,则可以根据实际需求构建具体的订阅消息体并向指定的目标用户发送通知。以下是简化后的POST请求示例代码片段: ```java import java.io.OutputStream; import javax.net.ssl.HttpsURLConnection; public class WeChatPushService { private static final String PUSH_URL = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token="; public void sendSubscribeMessage(String accessToken, String openId, String templateId){ try { // 构建完整的url路径 URL url = new URL(PUSH_URL + accessToken); HttpsURLConnection conn = (HttpsURLConnection) url.openConnection(); conn.setRequestMethod("POST"); conn.setDoOutput(true); // 创建json对象作为post body的数据结构 JSONObject jsonBody = new JSONObject(); jsonBody.put("touser", openId); // 接收者(openid) jsonBody.put("template_id", templateId); // 模板ID // 添加其他必要参数... OutputStream os = conn.getOutputStream(); byte[] input = jsonBody.toString().getBytes("utf-8"); os.write(input, 0, input.length); int responseCode = conn.getResponseCode(); System.out.println("\nSending 'POST' request to URL : " + url); System.out.println("Response Code : " + responseCode); BufferedReader in = new BufferedReader( new InputStreamReader(conn.getInputStream())); String output; StringBuffer response = new StringBuffer(); while ((output = in.readLine()) != null) { response.append(output); } in.close(); // 打印结果 System.out.println(response.toString()); } catch (Exception e) { e.printStackTrace(); } } } ``` 上述代码展示了如何利用HTTPS POST方法提交带有特定格式化内容的消息微信服务器上。需要注意的是,这里仅提供了一种基本框架;具体应用中可能还需要考虑更多细节处理,比如错误重试机制、日志记录等功能扩展。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值