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

原创

悟空码字

发布于 2023-01-18 12:06:57

1.4K0

发布于 2023-01-18 12:06:57

文章被收录于专栏：悟空码字，程序人生悟空码字，程序人生

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

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

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

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

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

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

https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/uniform-message/uniformMessage.send.html

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

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、效果