微信小程序模板消息接口下线了，不用慌，调用统一服务消息接口来实现相同功能

精选原创

悟空码字 2023-03-05 09:58:15 博主文章分类：微信开发 ©著作权

文章标签 模板消息 Java 文章分类 软件研发 yyds干货盘点

©著作权归作者所有：来自51CTO博客作者悟空码字的原创作品，请联系作者获取转载授权，否则将追究法律责任

大家好，我是小悟

1、前言

做过微信开发的应该都有一点感触，就是他的开发文档不是一成不变的，接口有时候会被下线，但也不是一下子就不能用了，一般会兼容旧接口，然后提醒你使用新接口有更多好处。

如果接口真的直接下线了，也会提供另一种能够实现相同功能的接口给你替换。所以有天你以为代码都写好了，没有bug了，悠哉悠哉的时候，忽然产品经理说微信的哪个接口不能用了，快去改一下，不要惊讶，老老实实去改就对了哈。

这不，微信将小程序的模板消息接口下线了，之前用formid来调这个接口的功能都就用不了了。

微信小程序模板消息接口下线了，不用慌，调用统一服务消息接口来实现相同功能_Java

看官方文档提示，是提供了订阅消息的功能来替换，顾名思义，要用户主动订阅了才可以发送成功，像下面这样：

微信小程序模板消息接口下线了，不用慌，调用统一服务消息接口来实现相同功能_Java_02

除了这种订阅消息外，还有没有其他方法来实现同等效果呢，答案是of course。

翻阅小程序开发文档发现，官方还提供了一个统一服务消息的接口。为便于开发者对用户进行服务消息触达，简化小程序和公众号模板消息下发流程，小程序提供统一的服务消息下发接口。就是在小程序里发送公众号模板消息，这个好处就是不需要formid的

要注意：以下几类消息是目前不允许发的模板消息

1、模板内容与服务场景（含标题、关键词）不一致的模板

2、涉嫌广告营销类消息模板

3、发送频率过高，有骚扰用户倾向类消息模板

4、涉及红包、卡券、优惠券、代金券、会员卡、积分类消息模板

微信小程序模板消息接口下线了，不用慌，调用统一服务消息接口来实现相同功能_Java_03

接下来我们就来实现下。

2、准备

调用这个接口的前提是公众号和小程序有绑定且是同主体的，这个好办，登录公众号后台 -> 小程序 -> 小程序管理 -> 添加即可绑定小程序。

微信小程序模板消息接口下线了，不用慌，调用统一服务消息接口来实现相同功能_模板消息_04

因为实质上还是发的公众号模板消息，所以还是要在公众号后台添加消息模板获取模板id。

微信小程序模板消息接口下线了，不用慌，调用统一服务消息接口来实现相同功能_模板消息_05

3、开发

好了，做好以上两个准备就可以开发了，主要代码如下面：

/**
* 在小程序里使用同主体的关联公众号发送模板消息
* 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("统一消息推送模板jsnotallow======{}",jsonObject);
  }
  return jsonObject;
}