做过微信开发的应该都有一点感触,就是他的开发文档不是一成不变的,接口有时候会被下线,但也不是一下子就不能用了,一般会兼容旧接口,然后提醒你使用新接口有更多好处。如果接口真的直接下线了,也会提供另一种能够实现相同功能的接口给你替换。所以有天你以为代码都写好了,没有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;
}
针对入参要说下mpTemplateMsg.put("data",data)里面的data这个参数,它是first.DATA,
(keyword1.DATA,keyword2.DATA。。。),remark.DATA组成的,所以for循环里面
拼接数据的时候要分三个,分别对应first.DATA,(keyword1.DATA,keyword2.DATA。。。),remark.DATA的字段值。
3、效果
山水有相逢,来日皆可期,谢谢阅读,我们再会
我手中的金箍棒,上能通天,下能探海