Official Account -- 03 -- Java微信公众号模板消息

最新推荐文章于 2022-09-13 17:53:18 发布
最新推荐文章于 2022-09-13 17:53:18 发布
阅读量530 收藏 1
点赞数
分类专栏： WeChat 文章标签： WeChat
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Goodbye_Youth/article/details/107544262
版权

原文链接：Official Account – 03 – Java微信公众号模板消息

相关文章

模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等

官方文档：模板消息接口

一、公共类

  • WXConstants.java

    /**
 * 获取access_token接口
 * 此处的ACCESS_TOKEN与授权登陆获得的ACCESS_TOKEN不同，有效期为7200s
 */
public static final String GET_ACCESS_TOKEN = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s";

/**
 * 设置所属行业接口
 */
public static final String SET_INDUSTRY_URL = "https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=%s";

/**
 * 获得模板ID
 */
public static final String GET_TEMPLATE_ID = "https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=%s";

/**
 * 发送模板消息
 */
public static final String SEND_TEMPLATE_MSG = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=%s";

  • HttpUtils.java

    @Slf4j
public class HttpUtils {

    public static JSONObject sendGetRequest(String requestUrl) {
        return (JSONObject) sendHttpRequest(requestUrl, "GET", null, null, null, null);
    }

    public static JSONObject sendJsonPostRequest(String requestUrl, String data){
        return (JSONObject) sendHttpRequest(requestUrl, "POST", "Content-Type", "application/json; charset=UTF-8", data, null);
    }

    public static String sendXmlPostRequest(String requestUrl, String xmlInfo){
        return (String) sendHttpRequest(requestUrl, "POST", "Content-Type", "text/xml;charset=utf-8", null, xmlInfo);
    }

    private static Object sendHttpRequest(String requestUrl, String requestMethod,
                                          String requestPropertyKey, String requestPropertyValue,
                                          String data, String xmlInfo) {
        BufferedReader bufferedReader = null;
        try {
            URL url = new URL(requestUrl);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setDoOutput(true);
            conn.setDoInput(true);
            conn.setUseCaches(false);
            conn.setRequestMethod(requestMethod);
            if (StringUtils.isNotBlank(requestPropertyKey) && StringUtils.isNotBlank(requestPropertyValue)) {
                conn.setRequestProperty(requestPropertyKey, requestPropertyValue);
            }
            OutputStream outputStream = conn.getOutputStream();
            if (StringUtils.isNotBlank(data) && StringUtils.isBlank(xmlInfo)) {
                // 在输出流中进行转码
                outputStream.write(data.getBytes(StandardCharsets.UTF_8));
                outputStream.close();
            }
            if (StringUtils.isNotBlank(xmlInfo) && StringUtils.isBlank(data)) {
                // 在输出流中进行转码
                outputStream.write(xmlInfo.getBytes(StandardCharsets.UTF_8));
                outputStream.close();
            }
            InputStream inputStream = conn.getInputStream();
            InputStreamReader isr = new InputStreamReader(inputStream);
            bufferedReader = new BufferedReader(isr);
            String str;
            StringBuilder builder = new StringBuilder();
            while ((str = bufferedReader.readLine()) != null) {
                builder.append(str);
            }
            conn.disconnect();
            if (StringUtils.isNotBlank(xmlInfo) && StringUtils.isBlank(data)) {
                return builder.toString();
            } else {
                return JSONObject.fromObject(builder.toString());
            }
        } catch (Exception e) {
            log.error("发送http请求，失败", e);
            return null;
        } finally {
            // 释放资源
            try {
                if(null != bufferedReader) {
                    bufferedReader.close();
                }
            } catch (IOException e) {
                log.error("释放资源，失败", e);
            }
        }
    }
}

  • WXUtils.java

    @Slf4j
public class WXUtils {

    private static String appid = "xxxxxxxxxxxx";
    private static String appsecret = "xxxxxxxxxxxx";

    public static String getAccessToken() {
        // 使用自己公众号的 AppID、AppSecret
        String url = String.format(WXConstants.GET_ACCESS_TOKEN, appid, appsecret);
        JSONObject jsonObject = HttpUtils.sendGetRequest(url);
        if (jsonObject != null) {
            log.info("获取access_token，成功，返回信息为【{}】", jsonObject);
            return (String) jsonObject.get("access_token");
        }
        return null;
    }
}

二、设置所属行业

  • 设置行业可在微信公众平台后台完成，每月可修改行业 1 次，帐号仅可使用所属行业中相关的模板

  • 参数说明

    • 调用接口 (https POST 请求)

      https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN

    • 请求参数

      参数是否必须说明
      access_token是接口调用凭证
      industry_id1是公众号模板消息所属行业编号
      industry_id2是公众号模板消息所属行业编号

    • 行业代码 (其余行业代码详见官方文档)

      主行业副行业代码
      IT科技互联网/电子商务1
      IT科技IT软件与服务2
      IT科技IT硬件与设备3
      IT科技电子技术4
      IT科技通信与运营商5
      IT科技网络游戏6

  • 设置所属行业

    • WXUtils.java

      @Slf4j
public class WXUtils {

    public static void setIndustry() {
        Optional.ofNullable(getAccessToken()).ifPresent(accessToken -> {
            JSONObject industry = new JSONObject();
            // IT科技 IT软件与服务
            industry.put("industry_id1", 2);
            // IT科技 IT硬件与设备
            industry.put("industry_id2", 3);
            String url = String.format(WXConstants.SET_INDUSTRY_URL, accessToken);
            Optional.ofNullable(HttpUtils.sendJsonPostRequest(url, industry.toString())).ifPresent(jsonObject -> {
            if ((Integer) jsonObject.get("errcode") == 0) {
                    log.info("设置所属行业，成功，返回信息为【{}】", jsonObject);
                } else {
                    log.error("设置所属行业，失败，返回信息为【{}】", jsonObject);
                }
            });
        });
    }
    
    public static void main(String[] args) {
        setIndustry();
    }
}

    • 测试结果

      // 设置所属行业，成功，返回信息为【{"errcode":0,"errmsg":"ok"}】

三、获取模板 ID

  • 从行业模板库选择模板到帐号后台，我们即可获取到对应的模板 ID，这里我们尝试下调用接口来获取模板 ID

    • 路径：功能 --> 模板消息 --> 模板库

    • 注意：每调用一次该接口，就等价于在账号后台将模板从【模板库】添加到【我的模板】，同时会生成一个模板 ID

  • 参数说明

    • 调用接口 (https POST 请求)

      https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN

    • 请求参数

      参数是否必须说明
      access_token是接口调用凭证
      template_id_short是模板库中模板的编号，有 “TM**” 和 “OPENTMTM**” 等形式

    • 返回参数

      参数说明
      template_id模板 ID

  • 获取模板 ID

    • WXUtils.java

      @Slf4j
public class WXUtils {

    public static String getTemplateID(String templateIdShort) {
        String accessToken = getAccessToken();
        if (StringUtils.isNotBlank(accessToken)) {
            JSONObject template = new JSONObject();
            // templateIdShort 为模板库中模板的编号
            template.put("template_id_short", templateIdShort);
            String url = String.format(WXConstants.GET_TEMPLATE_ID, accessToken);
            JSONObject jsonObject = HttpUtils.sendJsonPostRequest(url, template.toString());
            if (jsonObject != null) {
                if ((Integer) jsonObject.get("errcode") == 0) {
                    log.info("获取模板ID，成功，返回信息为【{}】", jsonObject);
                    return (String) jsonObject.get("template_id");
                } else {
                    log.error("获取模板ID，失败，返回信息为【{}】", jsonObject);
                }
            }
        }
        return null;
    }
    
    public static void main(String[] args) {
        getTemplateID("TM00201");
    }
}

    • 测试结果

      // 获取模板ID，成功，返回信息为【{"errcode":0,"errmsg":"ok","template_id":"ePgZmrXWAwURCFHbr4p01WTI6GMS594f42YRNjXhcZY"}】

四、发送模板消息

  • 参数说明

    • 调用接口 (https POST 请求)

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

    • 请求参数

      参数是否必须说明
      touser是接收者 openid
      template_id是模板 ID
      url否模板跳转链接 (海外帐号没有跳转能力)
      miniprogram否跳小程序所需数据，不需跳小程序可不用传该数据
      appid是所需跳转到的小程序 appid
      (该小程序 appid 必须与发模板消息的公众号是绑定关联关系，暂不支持小游戏)
      pagepath否所需跳转到小程序的具体页面路径，支持带参数,
      (示例 index?foo=bar)，要求该小程序已发布，暂不支持小游戏
      data是模板数据
      color否模板内容字体颜色，不填默认为黑色

    • 返回参数

      参数说明
      msgid消息 ID

  • 发送模板消息

    • 消息模板

      在这里插入图片描述

    • SendTemplateMsgData.java

      @Data
public class SendTemplateMsgData {

    /**
     * 接收者openid
     */
    private String touser;
    /**
     * 模板ID
     */
    private String template_id;
    /**
     * 模板数据
     */
    private TemplateMsgData data;

    @Data
    public class TemplateMsgData {
        private First first;
        private Keyword1 keyword1;
        private Keyword2 keyword2;
        private Keyword3 keyword3;
        private Remark remark;
    }

    @Data
    public class First {
        private String value;

        public First(String value) {
            this.value = value;
        }
    }

    @Data
    public class Keyword1 {
        private String value;

        public Keyword1(String value) {
            this.value = value;
        }
    }

    @Data
    public class Keyword2 {
        private String value;

        public Keyword2(String value) {
            this.value = value;
        }
    }

    @Data
    public class Keyword3 {
        private String value;

        public Keyword3(String value) {
            this.value = value;
        }
    }

    @Data
    public class Remark {
        private String value;

        public Remark(String value) {
            this.value = value;
        }
    }
}

    • WXUtils.java

      @Slf4j
public class WXUtils {

    private static String openid = "xxxxxxxxxxxx";
    private static String first = "尊敬的用户，你好";
    private static String keyword1 = "1号公寓1001房间";
    private static String keyword2 = "电费剩余低于10度，请尽快缴费";
    private static String keyword3 = "2018年8月6日 12:12";
    private static String remark = "如有疑问，请联系管理员 电话：010-11111111";

    public static void sendTemplateMsg(String templateId) {
        Optional.ofNullable(getAccessToken()).ifPresent(accessToken -> {
            SendTemplateMsgData sendTemplateMsgData = new SendTemplateMsgData();
            sendTemplateMsgData.setTouser(openid);
            sendTemplateMsgData.setTemplate_id(templateId);
            SendTemplateMsgData.TemplateMsgData data = new SendTemplateMsgData().new TemplateMsgData();
            data.setFirst(new SendTemplateMsgData().new First(first));
            data.setKeyword1(new SendTemplateMsgData().new Keyword1(keyword1));
            data.setKeyword2(new SendTemplateMsgData().new Keyword2(keyword2));
            data.setKeyword3(new SendTemplateMsgData().new Keyword3(keyword3));
            data.setRemark(new SendTemplateMsgData().new Remark(remark));
            sendTemplateMsgData.setData(data);
            String url = String.format(WXConstants.SEND_TEMPLATE_MSG, accessToken);
            Optional.ofNullable(HttpUtils.sendJsonPostRequest(url, JSONObject
                .fromObject(sendTemplateMsgData).toString())).ifPresent(jsonObject -> {
                if ((Integer) jsonObject.get("errcode") == 0) {
                    log.info("发送模板消息，成功，返回信息为【{}】", jsonObject);
                } else {
                    log.error("发送模板消息，失败，返回信息为【{}】", jsonObject);
                }
            });
        });
    }
    
    public static void main(String[] args) {
        sendTemplateMsg("tXXutFOKEAI2sQVnXGK82ZR0KJiU868fEu6EBcQz2hQ");
    }
}

    • 测试结果

      在这里插入图片描述

Gene Xu
关注
专栏目录
official-account:微信公众号
03-20
official-account:微信公众号
微信公众号模板消息接口
一朵翔云的博客
03-26 8710
说明 使用规则 其他说明 设置所属行业 行业代码查询 获取设置的行业信息 获得模板ID 获取模板列表 删除模板 发送模板消息 事件推送 送达成功时，推送的XML如下： 送达由于用户拒收（用户设置拒绝接收公众号消息）而失败时，推送的XML如下： 送达由于其他原因失败时，推送的XML如下： 说明 模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷...
微信公众平台 模版消息
felixfeng的专栏
09-10 1020
1.在模板库取模版编号，如TM00335 var msgData = new { template_id_short = "TM00335" };   var serializer = new System.Web.Script.Serialization.JavaScriptSerializer();             string json = serializer.Seriali
使用C# .net开发微信公众号之获取模板ID
国家一级甩锅运动员
08-10 9399
获取模板ID在微信公众号开发文档中是这样描述的： 获得模板ID 从行业模板库选择模板到帐号后台，获得模板ID的过程可在MP中完成。为方便第三方开发者，提供通过接口调用的方式来获取模板ID，具体如下： 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN
微信公众号开发《二》发送模板消息实现消息业务实时通知
半山闲人的专栏
04-21 1万+
本篇文章主要介绍利用上篇文章获取到的微信ID，向已绑定用户发送模板消息，如我们常见的消费通知、订单通知等业务都可以用该功能实现。理论知识就不反复强调了，实践是检验真理的唯一标准，直接看例子，相信大家就能一目了然了。
微信公众号开发---模板消息
YiFeng_888的博客
01-20 1043
原文：https://blog.csdn.net/qq_28506819/article/details/77987013    模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。 1、设置所属行业 设置行业可在微信公众平台后台完成，每月可修改行业1次，帐号仅可使用所属...
node-wechat:nodejs 开发微信公众号
05-17
node-wechat nodejs 开发微信公众号 文档中的reply.js文件中的有些图片和素材的回复因为是...另外我写的创建模板消息相关的方法只是写来方便日后使用的,现在我用的是测试的公众号,没有创建模板消息的权限. 教程地址:
Official-Accounts:微信公众号
04-17
Official-Accounts 微信公众号 程序猿的向往
ChatGPT接入项目实例-微信公众号
最新发布
05-01
WeChat official access chatGPT dev create venv python -m venv .venv rename .env.example to .env run pip install -U -r requirements.txt run python main.py deploy run docker compose build run docker ...
robot-official：＃人类加油＃we-stay-strong用于微信公众号的疫情信息推送机器人
01-31
微信公众号/服务号疫情信息小助手（非官方） 疫情信息小助手个人版本已完成开发，请参见 。 项目目的 该项目还在进行中并且需要您的帮助，我们希望能够所有人在一起成为传播疫情信息的自媒体。您若赋闲在家并拥有...
WX.OfficialAccount:微信公众号
05-27
WX.OfficialAccount 微信公众号
微信公众号开发学习（五）发送模板消息
qq_39602487的博客
08-20 427
1.设置所属行业 在进行模板消息的发送之前，我们需要为我们的公众号设置所属行业。 我们需要往如下url： https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN 发送post请求。 这里直接用test方法设置所属行业： @Test void set(){//测试 设置用于发送模板消息的行业 String at = WeChatService.getAccessT
C#开发微信门户及应用(27)-公众号模板消息管理
weixin_34072637的博客
04-22 514
通过模板消息接口，公众号能向关注其账号的用户发送预设模板的消息。模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。本文主要介绍基于C#开发实现公众号模板消息的管理功能。 “模板消息功能的推出,将极大地增强服务号的服务通知能力”,在一些一直期待微信模板消息功能开放的公众号运...
微信模板消息字体设置变大
野生菌Blog
08-04 8921
微信模板消息字体设置变大,大,大. 小程序发送模板消息,字体变大. 发送消息时发现别人的模板消息有的字特别大,而字体参数只有value和color,他是如何变大的呢? 答案:emphasis_keyword POST参数说明： 参数 必填 说明 touser 是 接收者（用户）的 openid template_id 是 所需下发的模...
微信模板消息跳转小程序
ly2983068126的博客
04-12 2万+
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277模板消息接口模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。关于使用规则，请注意：1、所有服务号都可以在功能->添加功能插件处看...
小程序跳转公众号official-account组件的使用
m0_37751401的博客
09-13 1206
序。
微信公众号 {"errcode"40037,"errmsg""invalid template_id"}
qq_20629025的博客
10-20 5万+
原因是使用微信测试账号时，模板ID只能通过微信测试账号-新增的模板id才有效 相关参考地址：微信公众号 {"errcode"40037,"errmsg""invalid template_id"} ...
【微信公众号】8、SpringBoot整合WxJava发送模板消息
热门推荐
Asurplus
03-23 20万+
模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。 1、主动发送消息 1、在微信公众号中我们多数都是被动回复用户消息，在文章：【微信开发】4、SpringBoot整合WxJava处理微信消息、事件推送 中我们可以收到用户的消息、事件推送，从而被动回复用户信息。 2、微信公众号中能主动给用户发送消息的方式有以下几种： 1、模板消息，每个账号的模板消息的日调用上限为10万次 2、群
微信小程序official-account组件的使用及样式设置
等，你的到来。
09-21 4万+
大家下午好，作为一只写了好几个月的小程序的猿，微信关注了‘微信公众平台’的公众号是必然的，所以头天晚上就收到了这厮推送的消息，说是扫码打开小程序新增公众号关注组件。讲真的，我真的没打开看，困成狗的我心想：反正现在也不用，就先这样吧，用的时候再说，然后就碎了。然而今天早上到了公司，正在认真码字，我们产品经理一个消息发过来了，打开一看，简单明了，于是就有了以下的对话…… 唉~心痛的无法呼吸，没办法，...
CCNP SWITCH 300-115官方认证指南
"CCNP-SWITCH_300-115 - CCNP Routing and Switching SWITCH 300-115 Official Cert Guide - David Hucaby" 本书是针对Cisco认证网络专业（CCNP）路由与交换部分的SWITCH 300-115考试的官方指南，由David Hucaby...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值