springboot整合微信公众号实现模版消息推送

news2024/11/14 18:27:18

欢迎来到我的博客，代码的世界里，每一行都是一个故事

在这里插入图片描述

🎏：你只管努力，剩下的交给时间

🏠 ：小破站

springboot整合微信公众号实现模版消息推送

- 前言
- 前提工作
- 整合springboot
- - 配置
  - 实现逻辑
  - - 基础
    - 1、要获取access_token
    - 2、推送模版信息给用户
    - 3、用户在公众号点击跳转到小程序

前言

在如今的互联网时代，微信已成为人们日常生活中不可或缺的一部分。微信公众号作为企业与用户互动的重要渠道，模版消息推送功能更是提升用户体验的关键之一。然而，对于很多开发者来说，如何将这一功能集成到现有的Spring Boot项目中，可能是一大挑战。本文将带你一步步实现这一目标，让你在实际开发中得心应手。

前提工作

1 、首先保证你的公众号认证为服务号，而非订阅号

2、白名单中加入了自己平台的ip

3 、已经设置了模版消息

整合springboot

配置

对于公众号的相关信息，可以存到数据库中的相关配置表中，也可以放到yaml中

# application.yml
wechat:
  app-id: 你的微信公众号appid
  app-secret: 你的微信公众号secret
  token-url: https://api.weixin.qq.com/cgi-bin/token
  token-grant-type: client_credential
  xcx-app-id: 你的小程序appid
  template_id: 模版id
  template_url: https://api.weixin.qq.com/cgi-bin/message/template/send

实现逻辑

基础

因为项目实现属于gs项目，所以没法贴代码，这里给大家提供一个基本的思路

这里我们仅仅使用了http工具进行调用，简单的例子说明

/**
* description: 获取公众号access_token
*
* @return java.lang.String
*/
public static String getWechatAccessToken() {
		// 这里参数代码省略
  try {
    // 如果redis中有，那么直接从redis拿
    if (haveToken) {
      accessToken = JedisUtil.getJson(tokenKey);
    } else {
      // 获取access_token
      HttpResponse execute = HttpRequest.get(tokenRequestUrl).form(map).execute();
      JSONObject jsonObject = JSON.parseObject(execute.body());
      String returnAccessToken = jsonObject.getString("access_token");

      if (StrUtil.isBlank(returnAccessToken)) {
        throw new CustomException("获取微信公众号access_token失败");
      }
      JedisUtil.setJson(tokenKey, returnAccessToken, 7100);
      accessToken = returnAccessToken;
    }
  } catch (Exception e) {
    throw new CustomException("获取微信公众号access_token失败");
  }
  return accessToken;
}

上面的获取access_token使用了hutool工具类中的HttpRequest，对于get类型，最后的form中我们只需要加入参数map即可

1、要获取access_token

获取access_token官方文档

代码中实现注意点

1、对于获取access_token来说因为它的返回是有过期时间的，所以我们没必要每次都去调用，比如可以把他放到redis中，可以少去频繁的调用

2、好多操作的前置操作都是获取这个token，所以可以把它作为一个通用方法

3、在本地环境调用的时候，会出现白名单问题，所以日志的输出还是很有必要性(本地ip会频繁变化)

2、推送模版信息给用户

推送模版信息给用户官方文档

入参说明：

{
  "touser":"OPENID",
  "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
  "url":"http://weixin.qq.com/download",  
  "miniprogram":{
    "appid":"xiaochengxuappid12345",
    "pagepath":"index?foo=bar"
  },
  "client_msg_id":"MSG_000001",
  "data":{

    "keyword1":{
      "value":"巧克力"
    },
    "keyword2": {
      "value":"39.8元"
    },
    "keyword3": {
      "value":"2014年9月22日"
    }
  }
}