通过微信模板消息跳转到小程序

关注小编微信公众号公众号【前端基础教程从0开始】回复“1”,拉你进程序员技术讨论群,群内有大神,可以免费提供问题解答。公众号回复“小程序”,领取300个优秀的小程序开源代码+一套入门教程。公众号回复“领取资源”,领取300G前端,Java,产品经理,微信小程序,Python等资源合集大放送,让我们一起学前端。

微信公众平台模板消息参考地址:

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277

模板消息接口

模板消息仅用于公众号向用户发送重要的服务通知,只能用于符合其要求的服务场景中,如信用卡刷卡通知,商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。

关于使用规则,请注意:

1、所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口,但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限;
2、需要选择公众账号服务所处的2个行业,每月可更改1次所选行业;
3、在所选择行业的模板库中选用已有的模板进行调用;
4、每个账号可以同时使用25个模板。
5、当前每个账号的模板消息的日调用上限为10万次,单个模板没有特殊限制。【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次,可在MP登录后的开发者中心查看】。当账号粉丝数超过10W/100W/1000W时,模板消息的日调用上限会相应提升,以公众号MP后台开发者中心页面中标明的数字为准。

关于接口文档,请注意:

1、模板消息调用时主要需要模板ID和模板中各参数的赋值内容;
2、模板中参数内容必须以".DATA"结尾,否则视为保留字;
3、模板保留符号"{{ }}"。

目录

1 设置所属行业:https://mp.weixin.qq.com/wiki?action=doc&id=mp1433751277&t=0.09714817992554114#0

2 获取设置的行业信息:https://mp.weixin.qq.com/wiki?action=doc&id=mp1433751277&t=0.09714817992554114#1

3 获得模板ID:https://mp.weixin.qq.com/wiki?action=doc&id=mp1433751277&t=0.09714817992554114#2

4 获取模板列表:https://mp.weixin.qq.com/wiki?action=doc&id=mp1433751277&t=0.09714817992554114#3

5 删除模板:https://mp.weixin.qq.com/wiki?action=doc&id=mp1433751277&t=0.09714817992554114#4

6 发送模板消息:https://mp.weixin.qq.com/wiki?action=doc&id=mp1433751277&t=0.09714817992554114#5

7 事件推送:https://mp.weixin.qq.com/wiki?action=doc&id=mp1433751277&t=0.09714817992554114#6

设置所属行业

设置行业可在微信公众平台后台完成,每月可修改行业1次,帐号仅可使用所属行业中相关的模板,为方便第三方开发者,提供通过接口调用的方式来修改账号所属行业,具体如下:

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN

POST数据说明

POST数据示例如下:

  {
      "industry_id1":"1",
      "industry_id2":"4"
   }

参数说明
在这里插入图片描述
行业代码查询
在这里插入图片描述

获取设置的行业信息

获取帐号设置的行业信息。可登录微信公众平台,在公众号后台中查看行业信息。为方便第三方开发者,提供通过接口调用的方式来获取帐号所设置的行业信息,具体如下:

接口调用请求说明

http请求方式:GET
https://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN

参数说明
在这里插入图片描述
返回说明

正确调用后的返回示例:

{
"primary_industry":{"first_class":"运输与仓储","second_class":"快递"},
"secondary_industry":{"first_class":"IT科技","second_class":"互联网|电子商务"}
}

返回参数说明
在这里插入图片描述

获得模板ID

从行业模板库选择模板到帐号后台,获得模板ID的过程可在微信公众平台后台完成。为方便第三方开发者,提供通过接口调用的方式来获取模板ID,具体如下:

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN
POST数据说明

POST数据示例如下:

  {
       "template_id_short":"TM00015"
   }

参数说明
在这里插入图片描述
返回码说明

在调用模板消息接口后,会返回JSON数据包。正常时的返回JSON数据包示例:

{
       "errcode":0,
       "errmsg":"ok",
       "template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"
   }

获取模板列表

获取已添加至帐号下所有模板列表,可在微信公众平台后台中查看模板列表信息。为方便第三方开发者,提供通过接口调用的方式来获取帐号下所有模板信息,具体如下:

接口调用请求说明

http请求方式:GET
https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN

参数说明
在这里插入图片描述
返回说明

正确调用后的返回示例:

{    
 "template_list": [{
      "template_id": "iPk5sOIt5X_flOVKn5GrTFpncEYTojx6ddbt8WYoV5s",
      "title": "领取奖金提醒",
      "primary_industry": "IT科技",
      "deputy_industry": "互联网|电子商务",
      "content": "{ {result.DATA} }\n\n领奖金额:{ {withdrawMoney.DATA} }\n领奖  时间:{ {withdrawTime.DATA} }\n银行信息:{ {cardInfo.DATA} }\n到账时间:  { {arrivedTime.DATA} }\n{ {remark.DATA} }",
      "example": "您已提交领奖申请\n\n领奖金额:xxxx元\n领奖时间:2013-10-10 12:22:22\n银行信息:xx银行(尾号xxxx)\n到账时间:预计xxxxxxx\n\n预计将于xxxx到达您的银行卡"
   }]
}

返回参数说明
在这里插入图片描述

删除模板

删除模板可在微信公众平台后台完成,为方便第三方开发者,提供通过接口调用的方式来删除某帐号下的模板,具体如下:

接口调用请求说明

http请求方式:POST
https://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKEN

POST数据说明如下:

 {
     "template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE"
 }

参数说明
在这里插入图片描述
返回说明

在调用接口后,会返回JSON数据包。正常时的返回JSON数据包示例:

{
   "errcode" : 0,
   "errmsg" : "ok"
}

发送模板消息

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

POST数据说明

POST数据示例如下:

  {
       "touser":"OPENID",
       "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
       "url":"http://weixin.qq.com/download",  
       "miniprogram":{
         "appid":"xiaochengxuappid12345",
         "pagepath":"index?foo=bar"
       },          
       "data":{
               "first": {
                   "value":"恭喜你购买成功!",
                   "color":"#173177"
               },
               "keynote1":{
                   "value":"巧克力",
                   "color":"#173177"
               },
               "keynote2": {
                   "value":"39.8元",
                   "color":"#173177"
               },
               "keynote3": {
                   "value":"2014年9月22日",
                   "color":"#173177"
               },
               "remark":{
                   "value":"欢迎再次购买!",
                   "color":"#173177"
               }
       }
   }

参数说明
在这里插入图片描述
注:url和miniprogram都是非必填字段,若都不传则模板无跳转;若都传,会优先跳转至小程序。开发者可根据实际需要选择其中一种跳转方式即可。当用户的微信客户端版本不支持跳小程序时,将会跳转至url。

返回码说明

在调用模板消息接口后,会返回JSON数据包。正常时的返回JSON数据包示例:

{
       "errcode":0,
       "errmsg":"ok",
       "msgid":200228332
   }

使用效果
在这里插入图片描述

事件推送

在模版消息发送任务完成后,微信服务器会将是否送达成功作为通知,发送到开发者中心中填写的服务器配置地址中。

1、送达成功时,推送的XML如下:

       <xml>
       <ToUserName>< ![CDATA[gh_7f083739789a] ]></ToUserName>
       <FromUserName>< ![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8] ]></FromUserName>
       <CreateTime>1395658920</CreateTime>
       <MsgType>< ![CDATA[event] ]></MsgType>
       <Event>< ![CDATA[TEMPLATESENDJOBFINISH] ]></Event>
       <MsgID>200163836</MsgID>
       <Status>< ![CDATA[success] ]></Status>
       </xml>

参数说明
在这里插入图片描述
2、送达由于用户拒收(用户设置拒绝接收公众号消息)而失败时,推送的XML如下:

       <xml>
       <ToUserName>< ![CDATA[gh_7f083739789a] ]></ToUserName>
       <FromUserName>< ![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8] ]></FromUserName>
       <CreateTime>1395658984</CreateTime>
       <MsgType>< ![CDATA[event] ]></MsgType>
       <Event>< ![CDATA[TEMPLATESENDJOBFINISH] ]></Event>
       <MsgID>200163840</MsgID>
       <Status>< ![CDATA[failed:user block] ]></Status>
       </xml>

参数说明
在这里插入图片描述
3、送达由于其他原因失败时,推送的XML如下:

       <xml>
       <ToUserName>< ![CDATA[gh_7f083739789a] ]></ToUserName>
       <FromUserName>< ![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8] ]></FromUserName>
       <CreateTime>1395658984</CreateTime>
       <MsgType>< ![CDATA[event] ]></MsgType>
       <Event>< ![CDATA[TEMPLATESENDJOBFINISH] ]></Event>
       <MsgID>200163840</MsgID>
       <Status>< ![CDATA[failed: system failed] ]></Status>
       </xml>

参数说明
在这里插入图片描述

公众号模板消息跳转小程序(可能踩坑)

官方实例如下:
在这里插入图片描述
文档中实例对应位置在页面偏下位置
这样就会报错:{“errcode”:40165,“errmsg”:“invalid weapp pagepath hint: [rFe_AA0636shc1]”}

pagepath实际应该是

“pagepath”:“pages/index/index”

这样才会成功。

以上所述是我给大家介绍的通过微信模板消息跳转到小程序的方法,希望对大家有所帮助,如果大家有任何疑问请给我留言,我会及时回复大家的。转载请附上源码地址!

作者微信:欢迎大家交流

在这里插入图片描述

猜你喜欢

转载自blog.csdn.net/baidu_41601299/article/details/88418227