做过微信开发的应该都有一点感触，就是他的开发文档不是一成不变的，接口有时候会被下线，但也不是一下子就不能用了，一般会兼容旧接口，然后提醒你使用新接口有更多好处。如果接口真的直接下线了，也会提供另一种能够实现相同功能的接口给你替换。所以有天你以为代码都写好了，没有bug了，悠哉悠哉的时候，忽然产品经理说微信的哪个接口不能用了，快去改一下，不要惊讶，老老实实去改就对了哈。
这不，微信将小程序的模板消息接口下线了，之前用formid来调这个接口的功能都就用不了了。
看官方文档提示，是提供了订阅消息的功能来替换，顾名思义，要用户主动订阅了才可以发送成功，像下面这样：
除了这种订阅消息外，还有没有其他方法来实现同等效果呢，答案是of course。
翻阅小程序开发文档发现，官方还提供了一个统一服务消息的接口。为便于开发者对用户进行服务消息触达，简化小程序和公众号模板消息下发流程，小程序提供统一的服务消息下发接口。就是在小程序里发送公众号模板消息，这个好处就是不需要formid的，文档地址：
要注意：以下几类消息是目前不允许发的模板消息
1、模板内容与服务场景（含标题、关键词）不一致的模板
2、涉嫌广告营销类消息模板
3、发送频率过高，有骚扰用户倾向类消息模板
4、涉及红包、卡券、优惠券、代金券、会员卡、积分类消息模板
接下来我们就来实现下。
1、准备
调用这个接口的前提是公众号和小程序有绑定且是同主体的，这个好办，登录公众号后台 -> 小程序 -> 小程序管理 -> 添加即可绑定小程序
因为实质上还是发的公众号模板消息，所以还是要在公众号后台添加消息模板获取模板id
2、开发
好了，做好以上两个准备就可以开发了，主要代码如下面：
* 在小程序里使用同主体的关联公众号发送模板消息
* https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Template_Message_Interface.html
* @param vo
* @return {"errcode":0,"errmsg":"ok"} 向没有关注公众号的用户发送会返回{"errcode":43004,"errmsg":"require subscribe hint: [LGcpYa05528672]"}
*/
public static JSONObject uniformSend(SendVo vo){
boolean flag = false;
JSONObject object = new JSONObject();
JSONObject mpTemplateMsg = new JSONObject();
JSONObject miniprogram = new JSONObject();
String url = "https://api.weixin.qq.com/cgi-bin/message/wxopen/template/uniform_send?access_token="+vo.getToken();
object.put("touser", vo.getToUser());
mpTemplateMsg.put("appid", vo.getPublicAppId());
mpTemplateMsg.put("url", vo.getUrl());
mpTemplateMsg.put("template_id", vo.getTemplateId());
miniprogram.put("appid",vo.getMiniAppId());
miniprogram.put("pagepath",vo.getPagePath());
mpTemplateMsg.put("miniprogram",miniprogram);
List<String> list = vo.getValue();
JSONObject jsonObject = null;
if (list != null && list.size() > 0) {
int size = list.size();
JSONObject data = new JSONObject();
for (int i = 0; i < size; i++) {
if (i == 0) {
JSONObject first = new JSONObject();
first.put("value",list.get(0));
first.put("color",vo.getColor());
data.put("first",first);
} else if (i == size-1) {
JSONObject remark = new JSONObject();
remark.put("value",list.get(0));
remark.put("color",vo.getColor());
data.put("remark",remark);
} else {
JSONObject keyword = new JSONObject();
keyword.put("value",list.get(i));
keyword.put("color",vo.getColor());
data.put("keyword"+i,keyword);
}
}
mpTemplateMsg.put("data",data);
object.put("mp_template_msg",mpTemplateMsg);
jsonObject = CommonUtil.httpsRequestJson(url, "POST", object.toJSONString());
logger.info("统一消息推送模板json======{}",jsonObject);
}
return jsonObject;
}
AI 代码解读
针对入参要说下mpTemplateMsg.put("data",data)里面的data这个参数，它是first.DATA，
（keyword1.DATA,keyword2.DATA。。。），remark.DATA组成的，所以for循环里面
拼接数据的时候要分三个，分别对应first.DATA，（keyword1.DATA,keyword2.DATA。。。），remark.DATA的字段值。
3、效果
山水有相逢，来日皆可期，谢谢阅读，我们再会
我手中的金箍棒，上能通天，下能探海
