springboot进行微信公众号相关开发：（三）发送模板消息并设置通用回调消息接收接口

已于 2022-08-15 18:33:04 修改
阅读量4.5k 收藏 15
点赞数 1
分类专栏： 微信公众号 文章标签： 微信 微信模板消息 模板消息 模板消息发送 微信回调消息
于 2022-08-15 18:29:45 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yssa1125001/article/details/126352199
版权

在微信公众号相关的功能开发中，时常涉及一些与用户的消息交互，微信为了公众号运行方不对用户进行骚扰操作，所以对公众号方发送给用户方的消息设置了很多限制。在公众号方涉及一些需要主动提醒、通知用户的提升用户体验的操作时，允许开发者在公众平台网站中模板消息库中选择模板，选择后获得模板ID，再根据模板ID向用户主动推送提醒、通知消息。本文主要讲述模板消息的模板创建，消息发送，通用回调消息接收等功能的使用方式。

本文还是以测试号为例，测试号页面：
在这里插入图片描述

我们可以看到测试号二维码模块，首先我们使用微信扫码关注这个测试号，关注成功后再用户列表会多出一条用户信息，昵称即为关注方的微信昵称，而微信号即为关注方的微信在本测试号的内唯一标识，我们可以通过该标识跟该关注用户实现交互，在正式公众号内这个标识叫做openId。

（一）模板消息的设定

在二维码的下方可以看到模板消息接口模块，我们点击新增测试模板创建新的消息模板：
在这里插入图片描述

需要注意到相关消息提示：

  • 1、测试模板的模板ID仅用于测试，不能用来给正式帐号发送模板消息
  • 2、为方便测试，测试模板可任意指定内容，但实际上正式帐号的模板消息，只能从模板库中获得
  • 3、需为正式帐号申请新增符合要求的模板，需使用正式号登录公众平台，按指引申请
  • 4、模板内容可设置参数(模板标题不可)，供接口调用时使用，参数需以{{开头，以.DATA}}结尾

本文模拟以核酸报告提醒为主题，设定完毕后，如图所示：
在这里插入图片描述

其中模板ID是我们调用这个消息模板的标识，可以看到我在模板内容中设定了三个变量参数，“one”、“two”、“three”，我们调用这个模板的时候必须携带这三个参数的值，否则就会报格式错误等提示。

（二）模板消息的发送

我们点击下方模板消息的功能接口调用文档，文档内有详细的调用说明和示例：

具体调用方法
第一步：获取template_id（注意：仅微信开放平台同事可获取）

通过向微信公众平台申请模板，来获取模板id。

第二步：请求接口
请注意，URL置空，则在发送后，点击模板消息会进入一个空白页面（ios），或无法点击（android）。

POST请求

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

请求包为一个json：

{
 "touser":"OPENID",
 "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY","url":"http://weixin.qq.com/download",
 "topcolor":"#FF0000",
 "data":{
         "User": {
             "value":"黄先生",
             "color":"#173177"
         },
         "Date":{
             "value":"06月07日 19时24分",
             "color":"#173177"
         },
         "CardNumber": {
             "value":"0426",
             "color":"#173177"
         },
         "Type":{
             "value":"消费",
             "color":"#173177"
         },
         "Money":{
             "value":"人民币260.00元",
             "color":"#173177"
         },
         "DeadTime":{
             "value":"06月07日19时24分",
             "color":"#173177"
         },
         "Left":{
             "value":"6504.09",
             "color":"#173177"
         }
 }
}

发送效果图：
在这里插入图片描述

事件推送

在模版消息发送任务完成后，微信服务器会将是否送达成功作为通知，发送到开发者在开发模式中填写的URL中。

1、送达成功时，推送的XML如下：

	<xml>
	<ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
	<FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
	<CreateTime>1395658920</CreateTime>
	<MsgType><![CDATA[event]]></MsgType>
	<Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
	<MsgID>200163836</MsgID>
	<Status><![CDATA[success]]></Status>
	</xml>

2、送达由于用户拒收（用户设置拒绝接收公众号消息）而失败时，推送的XML如下：

	<xml>
	<ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
	<FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
	<CreateTime>1395658984</CreateTime>
	<MsgType><![CDATA[event]]></MsgType>
	<Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
	<MsgID>200163840</MsgID>
	<Status><![CDATA[failed:user block]]></Status>
	</xml>

3、送达由于其他原因失败时，推送的XML如下：

	<xml>
	<ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
	<FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
	<CreateTime>1395658984</CreateTime>
	<MsgType><![CDATA[event]]></MsgType>
	<Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
	<MsgID>200163840</MsgID>
	<Status><![CDATA[failed: system failed]]></Status>
	</xml>
返回码说明

在调用模板消息接口后，会返回JSON数据包。正常时的返回JSON数据包示例：

{
	"errcode":0,
	"errmsg":"ok",
	"msgid":200228332
}

错误时的返回JSON数据，形式类似，错误码请见本页下方返回码说明。

返回码说明
-1系统繁忙
0请求成功
40001验证失败
40002不合法的凭证类型
40003不合法的OpenID
40004不合法的媒体文件类型
40005不合法的文件类型
40006不合法的文件大小
40007不合法的媒体文件id
40008不合法的消息类型
40009不合法的图片文件大小
40010不合法的语音文件大小
40011不合法的视频文件大小
40012不合法的缩略图文件大小
40013不合法的APPID
41001缺少access_token参数
41002缺少appid参数
41003缺少refresh_token参数
41004缺少secret参数
41005缺少多媒体文件数据
41006access_token超时
42001需要GET请求
43002需要POST请求
43003需要HTTPS请求
44001多媒体文件为空
44002POST的数据包为空
44003图文消息内容为空
45001多媒体文件大小超过限制
45002消息内容超过限制
45003标题字段超过限制
45004描述字段超过限制
45005链接字段超过限制
45006图片链接字段超过限制
45007语音播放时间超过限制
45008图文消息超过限制
45009接口调用超过限制
46001不存在媒体数据
47001解析JSON/XML内容错误

可以看到我们只需要

"touser":"用户微信号/openId",
"template_id":"模板消息Id",
"url":"用户点击模板消息跳转到的页面或调用的接口",
"topcolor":"模板消息顶部背景色",
"data":{存放变量参数的值和其字体对应颜色}

这五个参数再加上access_token即可实现对模板消息的发送，其中变量的值需要以字段名对应一个value和color对象的方式统一包裹在“data”中。

另外，调用说明中：

在模版消息发送任务完成后，微信服务器会将是否送达成功作为通知，发送到开发者在开发模式中填写的URL中

所以，据此我们可以了解到模板消息的发送在微信内应该是一个异步操作，微信收到我们的调用请求后立即回复给我们能不能执行，但执行是否成功了它会通过一个额外的接口给我们提醒，这个接口就是我们最初绑定激活所用的配置信息内的URL，它承担了所有微信功能接口调用的回调消息接收操作。但需要注意的是，此时承担接收回调消息的接口类型是POST，所以接口地址不变的情况下我们还需要设定一个接收消息的POST接口，接收成功后统一回复字符串“success”即可，否则微信会重发三次左右，编写代码如下：

    /**
     * 恒定配置接口，post类型用于接收各种消息推送和回调
     *
     * @param request 请求体
     * @return 请求合法的情况下恒定返回字符串 “success”
     */
    @PostMapping("/auth")
    public String sayHi(HttpServletRequest request) {
        //获取param参数(可用以验签，确定请求方身份是否合法)
        String reqStr = "";
        try {
            Map<String, String[]> parameterMap = request.getParameterMap();
            if (ObjectUtil.isNotEmpty(parameterMap)) {
                reqStr = JSONObject.toJSONString(parameterMap, SerializerFeature.WriteMapNullValue);
            }
        } catch (Exception e) {
            log.error("接收param消息异常" + e.getMessage(), e);
        }
        log.info("恒定配置接口接收param参数：" + reqStr);

        //获取xml参数（可用以具体业务处理）
        Map<String, String> xmlMap = new HashMap<>(16);
        try {
            // 从request中取得输入流
            InputStream inputStream = request.getInputStream();
            // 读取输入流
            SAXReader reader = new SAXReader();
            Document document = reader.read(inputStream);
            // 得到xml根元素
            Element root = document.getRootElement();
            // 得到根元素的所有子节点
            List<Element> elementList = root.elements();
            // 遍历所有子节点
            for (Element e : elementList) {
                xmlMap.put(e.getName(), e.getText());
            }
        } catch (Exception e) {
            log.error("接收xml消息异常" + e.getMessage(), e);
        }
        log.info("恒定配置接口接收xml参数：" + JSONObject.toJSONString(xmlMap, SerializerFeature.WriteMapNullValue));

        return "success";
    }

因为回调业务消息基本为xml消息，所以我们需要从流中获取xml消息并转换为java对象，所需pom依赖：

        <dependency>
            <groupId>dom4j</groupId>
            <artifactId>dom4j</artifactId>
            <version>1.6</version>
        </dependency>

另外，回调消息内也会携带相关签名身份信息，可以用以确定身份是否合法，正式号还可以设置消息使用密钥加密传输，此处不涉及。

编写好了回调消息接收方法，我们再编写模板消息调用方法：

    /**
     * 发送模板消息
     *
     * @param reqMap 包含所需参数的集合
     * @return 响应结果
     */
    @PostMapping("/tem-msg")
    public String sendTemplateMsg(@RequestBody Map<String, String> reqMap) {
        String uri = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN";
        String accessToken = reqMap.get("accessToken");
        uri = uri.replace("ACCESS_TOKEN", accessToken);

        String temId = reqMap.get("temId");
        String redirectUri = reqMap.get("redirectUri");
        String openId = reqMap.get("openId");

        Map<String, Object> wxMap = new HashMap<>(16);
        wxMap.put("touser", openId);
        wxMap.put("template_id", temId);
        wxMap.put("url", redirectUri);
        wxMap.put("topcolor", "#FF0000");

        Map<String, Map<String, String>> dataMap = new HashMap<>(16);
        Map<String, String> map1 = new HashMap<>(2);
        map1.put("value", "孙武");
        map1.put("color", "#173177");
        dataMap.put("one", map1);

        Map<String, String> map2 = new HashMap<>(2);
        map2.put("value", "核酸检测报告");
        map2.put("color", "#173177");
        dataMap.put("two", map2);

        Map<String, String> map3 = new HashMap<>(2);
        map3.put("value", "http://www.baidu.com");
        map3.put("color", "#173177");
        dataMap.put("three", map3);

        wxMap.put("data", dataMap);

        JSONObject jsonObject = JSONObject.parseObject(JSONObject.toJSONString(wxMap));
        String res = RestClientUtils.sendPostString(restTemplate, uri, null, jsonObject, null);

        return res;
    }

postman调用参数：

{
	"accessToken": "59_qzI8PAKyHTPtYbFU2VNOxYqoef2JRiOcfFESsCWJh8CAzGnFZALWH4-gtaU3H52KZgYcbN7T4v6FfkRkAlReDgtxZ02TC7i9EQvk7OEOtSBdWuMVNZ0voVnq6FYL1AANWkScYEYE_eQObTJJUBNjACAFMY",
	"temId": "EWxi5NXmiZkJIHiYtfnA_WOTPosRqt6UR7li4RCRODw",
	"redirectUri": "https://XXXXXXXX.wocp.fun/module/wx/v1/init/redirect-page",
	"openId": "xxxxxwbxxxxxE-Whk"
}

PS: Hutool工具的post调用方法博主在使用时，微信一直提示参数格式异常，所以这里使用是自己的一个工具类，工具类在之前博文，具体链接。

因为博主没有页面部署，所以跳转路径url使用的是一个接口用以测试，接口编写如下：

    /**
     * 点击模板消息跳转的页面路径或接口（此处使用接口，一般情况下应为前端页面路径）
     *
     * @return 处理结果
     */
    @GetMapping("/redirect-page")
    public String senTemplateMsgCallback() {
        log.info("进入页面跳转接口......");
        return "success页面消息";
    }

至此，代码编写完成，我们首先获取access_token，然后再postman调用接口进行模板消息的发送操作：
在这里插入图片描述

可以看到，响应消息提示成功，我们再查看springboot日志：
在这里插入图片描述

可以看到，在回调消息接收方法内接受到了模板消息发送的结果为success。xml参数内，ToUserName接收者即为我们的公众号微信号，FromUserName发送者即为用户的微信号（openId）。

打开我们的手机，可以看到订阅号内有一条提示消息：
在这里插入图片描述

我们点击这个消息：
在这里插入图片描述

可以看到，页面参数和颜色都是跟我们设定发送的一致，我们再点击这个消息：
在这里插入图片描述

可以看到页面消息与我们跳转接口内返回参数一致，查看后端日志：
在这里插入图片描述

至此，模板消息发送功能完成！

yssa1125001
关注
  • 1
    点赞
  • 踩
  • 15
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
springboot实现微信公众号模版消息推送
07-09
springboot实现微信公众号模版消息推送，用的是构架：springboot+redis,详细教程：https://blog.csdn.net/chenhongming888/article/details/95173079
微信公众号集成SpingBoot开发---消息收发
weixin_37199234的博客
07-15 125
Contorller import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletRequest; import java.util.Map; /
5行代码实现微信模版消息推送，springboot实现微信推送，java微信推送
最新发布
2401_83977626的博客
05-16 338
如果你选择了IT行业并坚定的走下去，这个方向肯定是没有一丝问题的，这是个高薪行业，但是高薪是凭自己的努力学习获取来的，这次我把P8大佬用过的一些学习笔记（pdf）都整理在本文中了。desc: 模版消息推送模拟。微信：2501902696。微信：2501902696。
SpringBoot助力！轻松实现微信模版消息推送
知道的越多 不知道的就越多
02-19 1843
通过本教程的学习，您将掌握如何在Spring Boot项目中集成微信SDK，如何编写代码发送微信模板消息，并了解整个推送的过程。
微信事件推送接口（原创总结）
weixin_30737433的博客
03-10 576
微信中所有的推送事件都会发送到开发者填写的URL，MP中的，左侧最下面的开发-》基本配置-》服务器配置-》第一个就是，这个URL有要有处理所有事件推送的能力，当然不是每个都需要处理，只需要将需要的接受处理即可，其他的可直接忽略。 1.首先接收推送过来的数据包。 $postStr = isset($GLOBALS["HTTP_RAW_POST_DATA"]) ? $GLOBALS["HTTP...
微信公众平台发送模板消息
weijinbo5741的专栏
02-09 8279
一、申请模版消息权限 模版消息的申请需账号已经开通微信支付权限。 在微信公众平台的后台，依次进入“功能->添加功能插件->模版消息”，即可申请模版消息。 点击申请 申请时，选择2个和自己相关的行业即可。 提交并且申请通过后，可以在模版库中看到模版消息列表 进入想要使用的模版，点击添加 添加后就存放到“我的模版库”中了
SpringBoot 实现微信模板消息通知推送提醒
qq_34709784的博客
08-31 2794
SpringBoot 实现微信模板消息通知推送提醒
微信小程序学习之路——API模板消息
创作星球
04-09 1073
模板消息 1.调用模板消息接口 发送模板消息需要通过POST方式调用微信后台接口，接口调用可以是前台调用，也可以是后台调用，接口地址为： POST https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN post参数如下: 属性 类型 默认值 必填...
微信公众号开发之发送模板消息
热门推荐
朱哲的博客
11-10 11万+
在我们做微信公众号开发时，发送模板消息往往是必不可少的功能。今天我们就来说说吧！ 1、申请模板消息 首先我们应该知道，模板消息是需要申请的。这个申请就其本身来说是很easy的（我前一天晚上申请的，显示需要2--3个工作日，结果第二天早上就发现已经开通了，所以说腾讯官方还是比较给力的哈）。 但是我们在申请时还是有一些东西要注意，这个在官方的文档有非常详细的说明。 这个我建议你好好看看。选...
SpringBoot微信公众号开发
06-14
通过热门框架spring boot来学习微信公众号开发，帮助同学们快速入门微信公众号开发。
微信公众号开发-接收消息+模板消息
08-14
微信公众号开发-接收消息+模板消息。包含所有源代码、工具类、JAR包，MyEclipse开发的，其他软件开发的可以参考着修改。
java实现微信公众号发送模版消息
08-27
以订单推送为例，主要为大家详细介绍了java实现微信公众号发送模版消息，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
C#微信公众号开发之接收事件推送与消息排重的方法
09-04
主要介绍了C#微信公众号开发之接收事件推送与消息排重的方法,详细分析了事件推送与消息排重的使用技巧,对微信开发有一定参考借鉴价值,需要的朋友可以参考下
微信公众平台开发之模板消息(Java)
xiejiawanwei2_bb的专栏
11-01 2万+
由于刘峰老师的新书还没有出来
基于SpringBoot实现微信消息推送
m0_63823719的博客
11-19 6706
SpringBoot微信推送
nginx + lua 请求转发
wang896599331的博客
12-24 1417
记录一次 公众号大量同一时间发送模板，微信回调公众号告诉后台是否发送成功，因为没有业务处理，直接返回的success，报错Event=Template Send Job Finish。 这时候，nginx写了个转发到lua脚本处理请求，期间也出现过各种问题来阻碍我，简直疯了。实测有效~ -- 将请求交给PHP处理 function return_declined() ngx.req.set_uri('/' .. ngx.var.uri .. '?' .. ngx.var.args..
C#开发微信门户及应用(27)-公众号模板消息管理
weixin_34072637的博客
04-22 498
通过模板消息接口，公众号能向关注其账号的用户发送预设模板的消息。模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。本文主要介绍基于C#开发实现公众号模板消息的管理功能。 “模板消息功能的推出,将极大地增强服务号的服务通知能力”,在一些一直期待微信模板消息功能开放的公众号运...
WeiXin组件Senpac(四)【消息处理流程】
极客神殿
10-19 378
最基的接口。所有请求响应的基接口。请求的基接口。请求的基类文本类型的请求消息图片请求消息其它请求消息事件基接口。事件基类。事件消息基类的子类还有其它共同属性，通过一个接口来实现。事件订阅消息取消订阅事件消息。
微信公众平台开发-发送模板消息
g1812453421的专栏
09-04 1万+
微信公众账号开发-发送模板消息：   内容概要 本篇文章主要叙述如何在微信公众帐号上实现“发送模板消息开发”功能。包含json的封装与解析。   何谓模板消息 为了保证用户不受到骚扰，在开发者出现需要主动提醒、通知用户时，才允许开发者在公众平台网站中模板消息库中选择模板，选择后获得模板ID，再根据模板ID向用户主动推送提醒、通知消息。   注意：模板消息只能开发者主动向微信用户发送
springboot uniapp微信公众号开发
07-28
微信公众号开发是指基于微信平台的应用程序开发，通过微信公众号，我们可以实现与用户的互动交流、推送消息、提供各种服务等。 在使用 Spring Boot 和 UniApp 进行微信公众号开发时，可以采用前后端分离的开发模式...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值