微信公众号模板消息发送

浅浅的花香味﹌ 2021-09-25 08:30 471阅读 0赞

### 微信公众号模板消息发送 ###

*   *  前提准备
     *  代码示例

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

## 前提准备 ##

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

获取用户openId步骤：  
参考文档地址：[微信开放文档][Link 1]  
第一步：用户同意授权，获取code  
第二步：通过code换取网页授权access\_token  
请求以下链接获取access\_token： [获取openId][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);
            }
        }
    }

[Link 1]: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html
[openId]: https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code