微信开发：Java 实现推送模板消息

谁借莪１个温暖的怀抱￠ 2023-06-19 01:58 23阅读 0赞

**介绍一下啥是模板消息，模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等，模版消息可以不通过用户主动交互向用户推送消息，但是个人建议尽量少推送消息，避免被举报，下方是关于微信模板消息的使用规则**

官方文档：[https://developers.weixin.qq.com/doc/offiaccount/Message\_Management/Template\_Message\_Interface.html][https_developers.weixin.qq.com_doc_offiaccount_Message_Management_Template_Message_Interface.html]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NTM3NTQ2_size_16_color_FFFFFF_t_70][]

--------------------

**接口调用请求说明**

> http请求方式: [https://api.weixin.qq.com/cgi-bin/message/template/send?access\_token=ACCESS\_TOKEN][https_api.weixin.qq.com_cgi-bin_message_template_send_access_token_ACCESS_TOKEN]

**第一步**

**    申请测试公众号，通过测试公众号 ID 和 密钥，获取 access\_token 信息**  
**       ** 申请一个测试号公众号，详情请看 [微信开发：申请测试公众号（一）][Link 1]  
        获取 access\_token 信息，详细请看 [微信开发：获取 access\_token（二）][access_token]

**第二步**

**    配置模板类，微信模板推送采用的是 JSON 格式，因此我们有两种方式对他进行配置，第一种就是我们下边这个配置模板，然后一步一步中规中矩的来搞，第二种就是我们手动拼 JSON 内容串，然后进行推送，这个地方其实我个人喜欢第二种**

**    分别为 微信消息参数，模版消息内容，模版消息**（模版名称规范建议和本博文一样，反正是一个公用的类）

微信消息参数模版  WechatTemplate

package org.ry.utils;
    
    import lombok.Data;
    
    import java.util.Map;
    
    /**
     * @ClassName：WechatTemplate
     * @Description：TODO 微信消息参数模板
     * @Author LinLuoChen
     * @Date 2019/11/1/17:32
     * @Version V1.0
     **/
    @Data
    public class WechatTemplate {
    
        // 接收人
        private String touser;
    
        // 模板消息 ID
        private String template_id;
    
        // 跳转路径
        private String url;
    
        // 标题颜色
        public String topcolor;
    
        // 模板内容信息
        private Map<String, TemplateData> data;
    
    }

模版消息内容  TemplateData

package org.ry.utils;
    
    import lombok.Data;
    
    /**
     * @ClassName：TemplateData
     * @Description：TODO 模板消息的内容,封装模板消息具体内容的类
     * @Author LinLuoChen
     * @Date 2019/11/1/17:31
     * @Version V1.0
     **/
    @Data
    public class TemplateData {
    
        private String value; // 消息内容
        private String color; // 消息颜色
    
    }

微信消息模版 MessageTemplate      这个根据 你获取的消息模版的字段来定义

package org.ry.utils;
    
    import lombok.Data;
    
    /**
     * @ClassName：wxMessageTemplate
     * @Description：TODO 微信消息模板
     * @Author LinLuoChen
     * @Date 2019/11/4/9:45
     * @Version V1.0
     **/
    @Data
    public class MessageTemplate {
    
        // 标题
        private String first;
    
        // 内容1
        private String keyword1;
    
        // 内容2
        private String keyword2;
    
        // 内容3
        private String keyword3;
    
        // 内容4
        private String keyword4;
    
        // 结束
        private String remark;
    
    }

配置这一块就到此结束了

--------------------

**第三步**

配置好上边所需要的参数之后们就可以进最后一步，配置推送

package org.ry.demo;
    
    import com.alibaba.fastjson.JSON;
    import com.alibaba.fastjson.JSONObject;
    import org.apache.log4j.Logger;
    import org.ry.utils.HttpRequestUtil;
    import org.ry.utils.MessageTemplate;
    import org.ry.utils.TemplateData;
    import org.ry.utils.WechatTemplate;
    import org.springframework.stereotype.Service;
    
    import java.util.HashMap;
    import java.util.Map;
    
    /**
     * @ClassName：wx_message
     * @Description：TODO 微信消息模版，详细文档说明请查看 instructions/wx_massage_txt 文件
     * @Author LinLuoChen
     * @Date 2019/11/1/17:01
     * @Version V1.0
     **/
    @Service
    public class WxMassage {
    
        // 调用 log 日志
        static Logger log = Logger.getLogger(WxMassage.class.getClass());
    
        // 发起救援
        public static Integer send_template_messageStart(String openId, MessageTemplate messageTemplate, String access_token) {
            // 配置推送连接
            String url = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=" + access_token;
            WechatTemplate wechatTemplate = new WechatTemplate();
            //设置模板id
            wechatTemplate.setTemplate_id("ouEWjE5zczKwhCcLPtLdZcokWZ0sY1BA3IErXoBneV4");  //需要替换成自己的
            wechatTemplate.setTouser(openId);
            wechatTemplate.setTopcolor("#000000");
            //模板消息点击跳转路径, 如果不配置跳转小程序,可以设置跳转该路径
            wechatTemplate.setUrl("http://www.baidu.com");
    
            // 配置模版消息
            Map<String, TemplateData> m = new HashMap<String,TemplateData>();
            TemplateData first = new TemplateData();
            first.setColor("#000000");
            first.setValue(messageTemplate.getFirst());
            m.put("first", first);
    
            TemplateData keyword1 = new TemplateData();
            keyword1.setColor("#000000");
            keyword1.setValue(messageTemplate.getKeyword1());
            m.put("keyword1", keyword1);
    
            TemplateData keyword2 = new TemplateData();
            keyword2.setColor("#000000");
            keyword2.setValue(messageTemplate.getKeyword2());
            m.put("keyword2", keyword2);
    
            TemplateData keyword3 = new TemplateData();
            keyword3.setColor("#000000");
            keyword3.setValue(messageTemplate.getKeyword3());
            m.put("keyword3", keyword3);
    
            TemplateData keyword4 = new TemplateData();
            keyword4.setColor("#000000");
            keyword4.setValue("2018-11-10");
            m.put("keyword4", keyword4);
    
            TemplateData remark = new TemplateData();
            remark.setColor("#000000");
            remark.setValue(messageTemplate.getRemark());
            m.put("remark", remark);
            wechatTemplate.setData(m);
    
            String jsonString = JSON.toJSONString(wechatTemplate).toString();
            JSONObject jsonObject = HttpRequestUtil.httpRequest(url, "POST",jsonString);
            System.out.println("消息模版："+jsonObject);
            log.info("消息模版："+jsonObject);
            int result = 0;
            if (null != jsonObject) {
                if (0 != jsonObject.getInteger("errcode")) {
                    result = jsonObject.getInteger("errcode");
                }
            }
            return result;
        }
    
        public static void main(String[] args) {
            MessageTemplate messageTemplate = new MessageTemplate();
            messageTemplate.setFirst("尊敬的用户");
            messageTemplate.setKeyword1("测试");
            messageTemplate.setKeyword2("测试的服务");
            messageTemplate.setRemark("感谢您的使用");
            send_template_messageStart("oLv4UwlggsT1U58k60zetFXi5d3k",messageTemplate,"28_PxuakRwvBI_BTDBleYPQJMUVSsp5fmJTpkeoFr3ZkHtuw3BULX_YGdopWOW4ZF8-Ajnm7ku0HBosGQ3u2oay49XVbFkyKKVPDXvuUxV2XtuA8OGW2s7CwQKQIH_fn42_EKNJJm0XodMxn1E9VFMhADAYIP");
        }
    
    }

--------------------

**第二种拼接 JSON 串，以这个为例子**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NTM3NTQ2_size_16_color_FFFFFF_t_70 1][]

// 最外层 
    JSONObject data = new JSONObject();
    // 存放内容
    JSONObject map = new JSONObject();
    // 循环遍历内容
    for(int i=0;i<strArr.length;i++){
       JSONObject o = new JSONObject();
       o.put("value",strArrData[i]);
       o.put("color","#000000");
       map.put(strArr[i],o);
    }
    // 模板 ID 
    data.put("template_id","xxxxx");
    // 模板颜色
    data.put("topcolor","#000000");
    // 接收人
    data.put("touser","xxxxx");
    // 要跳转的路径
    data.put("url","www.baidu.com");
    // 把内容放进 data 总 json 里边
    data.put("data",map);
    String jsonString = JSON.toJSONString(data);
    // 执行推送
    JSONObject jsonObject = HttpRequestUtil.httpRequest(url, "POST",jsonString);

[https_developers.weixin.qq.com_doc_offiaccount_Message_Management_Template_Message_Interface.html]: https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Template_Message_Interface.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NTM3NTQ2_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191203165918722.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NTM3NTQ2,size_16,color_FFFFFF,t_70
[https_api.weixin.qq.com_cgi-bin_message_template_send_access_token_ACCESS_TOKEN]: https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN
[Link 1]: https://blog.csdn.net/qq_36537546/article/details/105140260
[access_token]: https://blog.csdn.net/qq_36537546/article/details/103369488
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NTM3NTQ2_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/202003311545379.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NTM3NTQ2,size_16,color_FFFFFF,t_70