微信小程序订阅消息接入

### 一、进入统一消息平台
#### 1、添加 微信小程序订阅消息 渠道账号
![](/media/202506/2025-06-10_155310_015515.png)
#### 2、添加 微信小程序订阅消息 渠道消息模板
![](/media/202506/2025-06-10_155510_928504.png)
#### 3、根据文档填写完整，保存完成后点击查看，记录下渠道消息模板ID
![](/media/202506/2025-06-10_155600_239112.png)
#### 4、添加消息模板
![](/media/202506/2025-06-06_141930_945038.png)
#### 5、根据文档填写完整，保存完成后点击查看，记录下消息模板ID
![](/media/202506/2025-06-10_155632_658596.png)
#### 6、可在系统中测试是否能发送成功
![](/media/202506/2025-06-10_155647_165176.png)
#### 7、发送
![](/media/202506/2025-06-10_155651_755035.png)
#### 8、成功接收
![](/media/202506/2025-06-10_155656_759204.png)
### 二、接入微信服务号模板消息
#### 1、authorizedGroupIdsSend 以authorizedGroupIds的形式发送，发送成功
![](/media/202506/2025-06-10_160937_404337.png)
![](/media/202506/2025-06-10_161324_822111.png)
#### 发送需要组织的JSON如下
![](/media/202506/2025-06-10_161433_417085.png)
#### 代码例子
```java
    private static void authorizedGroupIdsSend() {
        JSONObject rootInfo = new JSONObject();
        JSONObject msg_send_entity = new JSONObject();
        // 消息发送标题
        msg_send_entity.set("msgSendName", "第三方测试微信小程序订阅消息")
                // 	消息模板id
                .set("msgTemplateId", 193053314L)
                // 授权群体id（分为facultyIds，分为majorIds，分为gradeIds）
                .set("authorizedGroupIds", JSONUtil.toJsonStr(new JSONObject().set("gradeIds", "1926096410550214666")))
                // 发送类型 1.定时 2.实时
                .set("sendType", 2)
                // 期望发送时间
                // .set("expectPushTime", "")
                // 	发送渠道 1短信（101阿里云短信、102腾讯云短信）、2Email、3安卓/iOS Push、4微信服务号（模板消息）、5微信小程序（订阅消息）、6企业微信（应用消息）、7企业微信（机器人）、8钉钉群机器人、9钉钉工作消息、10飞书机器人、11支付宝小程序、12站内信
                .set("sendChannel", "5")
                // 第三方应用的标识id
                .set("appId", 1930506149L)
                // 	是否第三方对接 0.本系统 1.第三方应用
                .set("creatorType", 1);

JSONObject wechat_mini_program_channel = new JSONObject();

wechat_mini_program_channel.set("channelTemplateId", 193053194L)
                        .set("content", new JSONObject().set("miniProgramParam", new JSONObject()
                                .set("${thing5}", "日程标题GroupIdsSend").set("${date4}", "2025-06-22").set("${thing10}", "桑田岛").set("${thing11}", "备注")));

rootInfo.set("msg_send_entity", msg_send_entity)
                .set("wechat_mini_program_channel", wechat_mini_program_channel);

JSONObject result = HttpRequest.post("http://xiaoxi.jzkg.cn/api/blade-message/extraMsgTask/send")
                .addHeader("AppVerify", "123456")
                .bodyJson(rootInfo).execute().onSuccess(res -> res.asValue(JSONObject.class));
        System.out.println(result);
        System.out.println(rootInfo);
    }
```
```
msg_send_entity：
		msgSendName：消息发送标题
		msgTemplateId：消息模板ID，一、中第5条记录下的ID
		authorizedGroupIds: 统一消息平台中组架构的ID，分为facultyIds，分为majorIds，分为gradeIds，填入时将JSON转为字符串，可以facultyIds，majorIds，gradeIds同时传入，每一项以逗号分隔，如majorIds："1563664,5659563"
		sendType: 发送类型 1.定时 2.实时
		expectPushTime: 定时时的发送时间
		appId：接入统一消息平台前说明中申请的第三方应用的id
		creatorType：是否第三方对接 0.本系统 1.第三方应用，这里填入 1

wechat_mini_program_channel：发送微信小程序订阅消息时的信息
	channelTemplateId：渠道模板ID，一、中第3条记录下的ID
	content：消息内容
		miniProgramParam：小程序参数
			"${thing5}": 名称
			"${date4}": 时间
			"${thing10}": 地点
			${thing11}": 备注
			。。。等等等，依据渠道模板严格填写
		url：跳转链接

向部署的平台发送Post请求，如：http://xiaoxi.jzkg.cn/api/blade-message/extraMsgTask/send，携带JSON参数。携带请求头AppVerify值为接入统一消息平台前说明中申请第三方应用时的密码。
```
#### 2、userInfoSend 以userInfoSend的形式发送（不在系统中的用户，可以使用），发送成功
![](/media/202506/2025-06-06_162235_402374.png)
![](/media/202506/2025-06-06_162247_173625.png)
#### 发送需要组织的JSON如下 可以看到，给authorizedGroupIdsSend发送的区别就是，去掉authorizedGroupIds字段，加入user_info对象。
![](/media/202506/2025-06-06_162327_895256.png)
#### 重要变更代码
```java
        JSONArray users_info = new JSONArray();
        users_info.add(new JSONObject().set("wechatMiniProgramAccount", "o87OR7QEFZ3"));
        rootInfo.set("msg_send_entity", msg_send_entity)
                .set("wechat_mini_program_channel", wechat_mini_program_channel)
                .set("users_info", users_info);

users_info：接收人信息，是一个数组
	wechatMiniProgramAccount：订阅此微信小程序用户的openid
```