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

简介: 做过微信开发的应该都有一点感触,就是他的开发文档不是一成不变的,接口有时候会被下线,但也不是一下子就不能用了,一般会兼容旧接口,然后提醒你使用新接口有更多好处。如果接口真的直接下线了,也会提供另一种能够实现相同功能的接口给你替换。所以有天你以为代码都写好了,没有bug了,悠哉悠哉的时候,忽然产品经理说微信的哪个接口不能用了,快去改一下,不要惊讶,老老实实去改就对了哈。

做过微信开发的应该都有一点感触,就是他的开发文档不是一成不变的,接口有时候会被下线,但也不是一下子就不能用了,一般会兼容旧接口,然后提醒你使用新接口有更多好处。如果接口真的直接下线了,也会提供另一种能够实现相同功能的接口给你替换。所以有天你以为代码都写好了,没有bug了,悠哉悠哉的时候,忽然产品经理说微信的哪个接口不能用了,快去改一下,不要惊讶,老老实实去改就对了哈。

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

image.png

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

image.png

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

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

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

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

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

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

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

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

image.png

接下来我们就来实现下。

1、准备

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

image.png

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

image.png

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

image.png

山水有相逢,来日皆可期,谢谢阅读,我们再会

我手中的金箍棒,上能通天,下能探海

上一篇:实现微信扫描二维码关注公众号,直接注册登录网站

相关文章
|
26天前
|
人工智能 JavaScript 定位技术
微信的接口都有哪些?
【10月更文挑战第17天】微信的接口都有哪些?
116 43
|
1月前
|
JSON 小程序 应用服务中间件
微信的接口wxLogin()的返回值都有什么?
【10月更文挑战第4天】微信的接口wxLogin()的返回值都有什么?
176 1
|
1月前
|
JSON 前端开发 API
使用微信JS-SDK调用发票接口的完整开发指南
本文介绍了如何使用微信JS-SDK的`chooseInvoiceTitle`接口来调用微信的发票功能。通过微信发票接口,用户可以选择开具个人或单位发票,并获取相关发票信息,如抬头、税号、公司地址等。在文中,详细描述了JS-SDK的初始化、发票接口的调用方式,并提供了完整的代码示例。文章还介绍了如何处理返回的发票信息,帮助开发者快速集成微信发票功能。
75 2
|
1月前
|
存储 自然语言处理 小程序
微信小程序多语言切换神器:简繁体切换功能完全指南
随着全球化的发展,支持多种语言的应用程序愈发重要。本文介绍了如何在微信小程序中实现简体与繁体字体之间的切换功能,以满足不同地区用户的需求。通过创建utils文件夹并编写相应的转换函数,开发者可以方便地实现语言切换,从而提升用户体验。文章中还附带了示例代码和效果图,帮助读者更好地理解和应用这一功能。
85 0
微信小程序多语言切换神器:简繁体切换功能完全指南
|
26天前
|
小程序 安全 数据库连接
为什么已经提交的小程序无法连接后台服务?
【10月更文挑战第17天】为什么已经提交的小程序无法连接后台服务?
44 0
|
2月前
|
算法 JavaScript 前端开发
切西瓜法实现微信抢红包功能
该文章介绍了使用“切西瓜法”和“栅栏法”两种算法来模拟微信抢红包的随机分配机制,并通过具体的JavaScript代码实现了红包金额的公平随机分配过程。
切西瓜法实现微信抢红包功能
|
1月前
|
小程序
java--微信小程序发送模板消息
java--微信小程序发送模板消息
102 0
|
2月前
|
人工智能 前端开发 JavaScript
MacTalk 测评通义灵码,实现“微信表情”小功能
墨问西东创始人池建强分享了团队使用通义灵码的经验。
|
2月前
|
小程序 API 开发工具
使用python 实现微信签到提醒功能
【9月更文挑战第4天】使用python 实现微信签到提醒功能
70 2
|
3月前
|
存储 小程序 数据可视化
小程序开发问题之使用小程序云服务开发个人相册小程序如何解决
小程序开发问题之使用小程序云服务开发个人相册小程序如何解决