微信公众号模板消息发送

• • 前提准备
  • 代码示例

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

前提准备

OpenID：用户唯一标识
消息模板ID：需要提前在微信公众后台，从模板库中添加自己需要的模板（当然也可以自己申请）
注意：在未关注公众号时，用户访问公众号的网页，也会产生一个用户和公众号唯一的OpenID
准备参数：
1.公众号用户的openId
2.消息模板ID
3.小程序跳转页面 pagePath
4.消息内容WxMpTemplateData

获取用户openId步骤：
参考文档地址：微信开放文档
第一步：用户同意授权，获取code
第二步：通过code换取网页授权access_token
请求以下链接获取access_token： 获取openId

代码示例

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);
    }

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 {

    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);
        try {
            String result = wxMpService.getTemplateMsgService().sendTemplateMsg(wxMpTemplateMessage);
            System.out.println(result);
        } catch (WxErrorException e) {
//            e.printStackTrace();
            log.error("[微信模板消息发送] 发送失败 , {}",e);
        }
    }
}