微信公众号模板消息发送_binarywang公共号

前段时间有幸在工作中用到了微信公众号模板消息推送，在这里把自己在使用过程中的一些心得发一下，如有不明白的大家一起讨论。

前提准备

申请微信公众号–申请开通模板消息（如果主页面没有，请到左下方的那个+号点开；还有一点注意：只有认证的服务号才可以使用模版消息接口,订阅号无法使用这一功能。）

微信公众号基本设置–记住这里的AppID和AppSecret（AppSecret初始是无值的，需要生成），后续需要设置微信配置

OpenID：每个用户的唯一标识（注意：这里的openId和微信小程序的openId不是同一个）
消息模板ID：需要提前在微信公众后台，从模板库中添加自己需要的模板（当然也可以自己申请）

注意：在未关注公众号时，用户访问公众号的网页，也会产生一个用户和公众号唯一的OpenID
准备参数：
1.公众号用户的openId
2.消息模板ID
3.小程序跳转页面 pagePath
4.消息内容WxMpTemplateData

获取用户openId步骤：
参考文档地址：微信开放文档
第一步：用户同意授权，前端获取code
第二步：通过code获取session_key、openId和unionId
请求以下链接获取：
https://api.weixin.qq.com/sns/jscode2session?appid=appid&js_code=code&grant_type=authorization_code

maven包引入

<dependency>
    <groupId>com.github.binarywang</groupId>
    <artifactId>weixin-java-mp</artifactId>
    <version>3.7.0</version>
</dependency>
1
2
3
4
5

代码示例：

配置类

import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.api.impl.WxMpServiceImpl;
import me.chanjar.weixin.mp.config.impl.WxMpDefaultConfigImpl;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class WeiXinConfig {
	//我这里是用的SpringBoot项目，在yml配置文件配置了开头提到的AppID和AppSecret
    @Value("${weChatOfficial.appid}")
    private String appid;

    @Value("${weChatOfficial.secret}")
    private String secret;

    @Bean
    public WxMpDefaultConfigImpl wxMpDefaultConfig() {
        WxMpDefaultConfigImpl config = new WxMpDefaultConfigImpl();
        config.setAppId(appid);
        config.setSecret(secret);
        return config;
    }

    @Bean
    public WxMpService wxMpService() {
        WxMpService wxService = new WxMpServiceImpl();
        wxService.setWxMpConfigStorage(wxMpDefaultConfig());
        return wxService;
    }

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

公众号模板消息发送

import me.chanjar.weixin.mp.bean.template.WxMpTemplateData;

    @GetMapping("/sendTemplateMsg")
    @ResponseBody
    public DataPipe sendTemplateMsg(){
        //pagePath暂时不传，小程序还未发布
        String pagePath="";
        String first = "您有一个新的审核信息需要处理";
        String keyword1="审核申请";
        String keyword2="张三";
        String remark="这是个备注";
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm");
        String keyword3 = sdf.format(new Date());
        List<WxMpTemplateData> data = new ArrayList<WxMpTemplateData>(){{
            add(new WxMpTemplateData("first", first));
            add(new WxMpTemplateData("keyword1", keyword1));
            add(new WxMpTemplateData("keyword2", keyword2));
            add(new WxMpTemplateData("keyword3", keyword3));
            add(new WxMpTemplateData("remark",  remark));
        }};
        sendTemplateMsgService.sendTemplateMsg("用户公众号openId", templateId, "小程序跳转地址，可填可不填", data);
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

import lombok.extern.slf4j.Slf4j;
import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.bean.template.WxMpTemplateData;
import me.chanjar.weixin.mp.bean.template.WxMpTemplateMessage;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import javax.annotation.Resource;
import java.util.List;

/***
 * 发送公众号模板消息
 */
@Service
@Slf4j
public class SendTemplateMsgService {
	
	/***
	* 微信小程序appId
	*/
    private String appid;

    @Resource
    private WxMpService wxMpService;

    /***
     * 发送公众号模板消息
     * @param openId 接收人微信OpenId
     * @param templateId 模板ID
     * @param pagePath 小程序跳转路径
     * @param list 模板内容
     * @return
     */
    public void sendTemplateMsg(String openId, String templateId, String pagePath, List<WxMpTemplateData> list) {
        WxMpTemplateMessage.MiniProgram miniProgram = new WxMpTemplateMessage.MiniProgram();
        miniProgram.setAppid(appid);
        miniProgram.setPagePath(pagePath);
        WxMpTemplateMessage wxMpTemplateMessage = WxMpTemplateMessage
                .builder()
                .templateId(templateId)
                .toUser(openId)
                .miniProgram(miniProgram)
                .build();
        wxMpTemplateMessage.setData(list);
        wxMpTemplateMessage.setTemplateId(templateId);
        try {
            String result = wxMpService.getTemplateMsgService().sendTemplateMsg(wxMpTemplateMessage);
            log.info(result);
        } catch (WxErrorException e) {
//            e.printStackTrace();
            log.error("[微信模板消息发送] 发送失败 , {}",e);
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55