微信小程序模板消息推送

时序图

​​​​​​​

 

首先，我们需要知道一件事情，小程序的模板推送分为“一次性订阅”和“长期订阅”

一次性订阅：用户订阅小程序后，程序只能对指定OpenId进行一次推送模板消息，无法多次推送

长期订阅：用户长期订阅，能够多次推送模板消息（长期订阅模板需要向微信官方发起申请）

推送模板消息前置配置

1.需要配置消息推送

2.需要根据AppId、AppSecret调用开发文档Api获取access_token 

GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

2.需要使用access_token调用以下Api获取到微信用户的open_id

POST https://api.weixin.qq.com/wxa/getpluginopenpid?access_token=ACCESS_TOKEN

推送模板消息API

微信开发文档中的模板消息已经废弃不进行使用了，我们现在应该使用“订阅消息”——>“send”这个API（下方链接）

subscribeMessage.send | 微信开放文档

 其中参数的data属性，需要我们在代码中与之对应：

例如：

模板格式

参数类型：

 类型：（需要注意一些长度限制）

 上边的准备好就可以进行代码编写。

代码实现

1.模板消息：（所要传的参数实体）

public class WxSubscribeMsg {

    // 接收人id
    private String touser;
    // 模板id
    private String template_id;
    // 跳转小程序
    private String page;
    // 模板数据
    private Map<String, WxTemplateValue> data;
    // 跳转小程序类型 默认正式版
    private String miniprogram_state;
    // 语言类型 默认中文
    private String lang = "zh_CN";

    public String getTouser() {
        return touser;
    }

    public void setTouser(String touser) {
        this.touser = touser;
    }

    public String getTemplate_id() {
        return template_id;
    }

    public void setTemplate_id(String template_id) {
        this.template_id = template_id;
    }

    public String getPage() {
        return page;
    }

    public void setPage(String page) {
        this.page = page;
    }

    public Map<String, WxTemplateValue> getData() {
        return data;
    }

    public void setData(Map<String, WxTemplateValue> data) {
        this.data = data;
    }

    public String getMiniprogram_state() {
        return miniprogram_state;
    }

    public void setMiniprogram_state(String miniprogram_state) {
        this.miniprogram_state = miniprogram_state;
    }

    public String getLang() {
        return lang;
    }

    public void setLang(String lang) {
        this.lang = lang;
    }
}

 2.模板内容：（API中的data属性）

public class WxTemplateValue {

    private String value;

    public String getValue() {
        return value;
    }

    public void setValue(String value) {
        this.value = value;
    }

    @Override
    public String toString() {
        return "WxTemplateValue{" +
                "value='" + value + '\'' +
                '}';
    }
}

 3.返回数据接收

public class WxUserInfo {
    private String openid;

    private String session_key;

    private String unionid;

    private int errcode;

    private String errmsg;

    public String getOpenid() {
        return openid;
    }

    public void setOpenid(String openid) {
        this.openid = openid;
    }

    public String getSession_key() {
        return session_key;
    }

    public void setSession_key(String session_key) {
        this.session_key = session_key;
    }

    public String getUnionid() {
        return unionid;
    }

    public void setUnionid(String unionid) {
        this.unionid = unionid;
    }

    public int getErrcode() {
        return errcode;
    }

    public void setErrcode(int errcode) {
        this.errcode = errcode;
    }

    public String getErrmsg() {
        return errmsg;
    }

    public void setErrmsg(String errmsg) {
        this.errmsg = errmsg;
    }
}

 推送代码：

调用的API接口：

POST https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN

WxSubscribeMsg wxSubscribeMsg = new WxSubscribeMsg();
                            wxSubscribeMsg.setTouser(openId);
                            wxSubscribeMsg.setTemplate_id(templateId);
                            // 模板消息到小程序跳转页面
                            wxSubscribeMsg.setPage("pages/workbench/workbench?id=" + dto.getId()+"&pageTpye=task");
//                             开发版
//                            wxSubscribeMsg.setMiniprogram_state("developer");
//                             跳转体验版
                            wxSubscribeMsg.setMiniprogram_state("trial");
//                             跳转正式版
//                            wxSubscribeMsg.setMiniprogram_state("formal");

                            // 模板消息
                            Map<String, WxTemplateValue> map = new HashMap<>();

                            // 发布内容
                            WxTemplateValue keyword1 = new WxTemplateValue();
                            keyword1.setValue(sendContent);
                            map.put("thing1", keyword1);

                            // 影响区域
                            WxTemplateValue keyword2 = new WxTemplateValue();
                            String taskArea = dto.getSecondAreaName()+dto.getThirdAreaName();
                            if(taskArea.length() < 20){
                                keyword2.setValue(taskArea);
                            }else{
                                keyword2.setValue("");
                            }
                            map.put("thing2", keyword2);

                            // 发布时间
                            WxTemplateValue keyword3 = new WxTemplateValue();
                            String date = dto.getTaskStartTime()

                            keyword3.setValue(date);
                            map.put("date3", keyword3);

                            // 发布单位
                            WxTemplateValue keyword4 = new WxTemplateValue();
                            String group = dto.getName();
                            if(group.length() < 20){
                                keyword4.setValue(group);
                            }else{
                                String substring = group.substring(0, 20);
                                keyword4.setValue(substring);
                            }
                            map.put("thing4", keyword4);
                            // 推送模板参数
                            wxSubscribeMsg.setData(map);

                            // 参数转json
                            String json = JSONObject.toJSONString(wxSubscribeMsg);
                            // 调用微信推送模板接口
                            String doPostJson = HttpClientUtil.doPostJson(requestUrl, json);
                            // 将获取到的数据进行判断进行日志写入
                            JSONObject jsonObject = JSONObject.parseObject(doPostJson);
                            LOGGER.info("调用微信模板消息回调结果："+ com.wanwei.oneview.base.utils.JsonUtils.objectToJson(jsonObject));