基于微信的通知渠道，
，，我们为开发者提供了可以高效触达用户的模板新闻能力，
，，以便实现服务的闭环并提供更佳的体验。。
。。
。

模板推送位置：服务通知

模板下发条件：用户自己在微信系统内与页面有交互行为后触发，
，，详见下发条件说明

模板跳转能力：点击审查详情仅能跳转下发模板的该帐号的各个页面

使用说明

---

?登录https://mp.weixin.qq.com获取模板，
，，若是没有合适的模板，
，，可以申请添加新模板，
，，审核通事后可使用，
，，详见模板审核说明

方法二：页面的<form/>组件，
，，属性report-submit为true时，
，，可以声明为需发模板新闻，
，，此时点击按钮提交表单可以获取formId，
，，用于发送模板新闻。。
。。
；；；；；；蛘叩庇没瓿支付行为，
，，可以获取prepay_id用于发送模板新闻。。
。。
。

方法三：挪用接口下发模板新闻（详见发送模板新闻）

 

 

模版新闻治理

---

1.获取小程序模板库问题列表

 

接口地点

https://api.weixin.qq.com/cgi-bin/wxopen/template/library/list?access_token=ACCESS_TOKEN

HTTP请求方式：

POST

POST参数说明：

参数	必填	说明
access_token	是	接口挪用凭证
offset	是	offset和count用于分页， ，，体现从offset最先， ，，拉取count条纪录， ，，offset从0最先， ，，count最大为20。。 。。 。
count	是	offset和count用于分页， ，，体现从offset最先， ，，拉取count条纪录， ，，offset从0最先， ，，count最大为20。。 。。 。

示例：

{
"offset":0,
"count":5
}

返回码说明：

在挪用模板新闻接口后，
，，会返回JSON数据包。。
。。
。

正常时的返回JSON数据包示例：

{
"errcode":0,
"errmsg":"ok",
"list":[
{"id":"AT0002","title":"购置乐成通知"},
{"id":"AT0003","title":"购置失败通知"},
{"id":"AT0004","title":"生意提醒"},
{"id":"AT0005","title":"付款乐成通知"},
{"id":"AT0006","title":"付款失败通知"}
],
"total_count":599
}

返回参数说明：

参数	说明
id	模板问题id（获取模板问题下的要害词库时需要）
title	模板问题内容
total_count	模板库问题总数

2.获取模板库某个模板问题下要害词库

接口地点

https://api.weixin.qq.com/cgi-bin/wxopen/template/library/get?access_token=ACCESS_TOKEN

HTTP请求方式：

POST

POST参数说明：

参数	必填	说明
access_token	是	接口挪用凭证
id	是	模板问题id， ，，可通过接口获取， ，，也可登录小程序后台审查获取

示例：

{
"id":"AT0002"
}

返回码说明：

在挪用模板新闻接口后，
，，会返回JSON数据包。。
。。
。

正常时的返回JSON数据包示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "id": "AT0002",
    "title": "购置乐成通知",
    "keyword_list": [
        {
            "keyword_id": 3,
            "name": "购置所在",
            "example": "TIT造舰厂"
        },
        {
            "keyword_id": 4,
            "name": "购置时间",
            "example": "2016年6月6日"
        },
        {
            "keyword_id": 5,
            "name": "物品名称",
            "example": "咖啡"
        }
    ]
}

返回参数说明：

参数	说明
keyword_id	要害词id， ，，添加模板时需要
name	要害词内容
example	要害词内容对应的示例

3.组合模板并添加至帐号下的个人模板库

接口地点

https://api.weixin.qq.com/cgi-bin/wxopen/template/add?access_token=ACCESS_TOKEN

HTTP请求方式：

POST

POST参数说明：

参数	必填	说明
access_token	是	接口挪用凭证
id	是	模板问题id， ，，可通过接口获取， ，，也可登录小程序后台审查获取
keyword_id_list	是	开发者自行组合好的模板要害词列表， ，，要害词顺序可以自由搭配（例如[3,5,4]或[4,5,3]）， ，，最多支持10个要害词组合

示例：

{
"id":"AT0002", 
"keyword_id_list":[3,4,5] 
}

返回码说明：

在挪用模板新闻接口后，
，，会返回JSON数据包。。
。。
。

正常时的返回JSON数据包示例：

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

返回参数说明：

参数	说明
template_id	添加至帐号下的模板id， ，，发送小程序模板新闻时所需

4.获取帐号下已保存的模板列表

接口地点

https://api.weixin.qq.com/cgi-bin/wxopen/template/list?access_token=ACCESS_TOKEN

HTTP请求方式：

POST

POST参数说明：

参数	必填	说明
access_token	是	接口挪用凭证
offset	是	offset和count用于分页， ，，体现从offset最先， ，，拉取count条纪录， ，，offset从0最先， ，，count最大为20。。 。。 。最后一页的list长度可能小于请求的count
count	是	offset和count用于分页， ，，体现从offset最先， ，，拉取count条纪录， ，，offset从0最先， ，，count最大为20。。 。。 。最后一页的list长度可能小于请求的count

示例：

{
"offset":0,
"count":1
}

返回码说明：

在挪用模板新闻接口后，
，，会返回JSON数据包。。
。。
。

正常时的返回JSON数据包示例：

{
"errcode": 0,
"errmsg": "ok",
"list": [
        {
            "template_id": "wDYzYZVxobJivW9oMpSCpuvACOfJXQIoKUm0PY397Tc",
            "title": "购置乐成通知",
            "content": "购置所在{{keyword1.DATA}}\n购置时间{{keyword2.DATA}}\n物品名称{{keyword3.DATA}}\n",
            "example": "购置所在：TIT造舰厂\n购置时间：2016年6月6日\n物品名称：咖啡\n"
        }
    ]
}

返回参数说明：

参数	说明
list	帐号下的模板列表
template_id	添加至帐号下的模板id， ，，发送小程序模板新闻时所需
title	模板问题
content	模板内容
example	模板内容示例

5.删除帐号下的某个模板

接口地点

https://api.weixin.qq.com/cgi-bin/wxopen/template/del?access_token=ACCESS_TOKEN

HTTP请求方式：

POST

POST参数说明：

参数	必填	说明
access_token	是	接口挪用凭证
template_id	是	要删除的模板id

示例：

{
"template_id":"wDYzYZVxobJivW9oMpSCpuvACOfJXQIoKUm0PY397Tc"
}

返回码说明：

在挪用模板新闻接口后，
，，会返回JSON数据包。。
。。
。

正常时的返回JSON数据包示例：

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

 

发送模板新闻

---

1. 获取access_token

access_token是全局唯一接口挪用凭证，
，，开发者挪用各接口时都需使用access_token，
，，请妥善生涯。。
。。
。access_token的存储至少要保存512个字符空间。。
。。
。access_token的有用期现在为2个小时，
，，需准时刷新，
，，重复获取将导致上次获取的access_token失效。。
。。
。

公众平台的API挪用所需的access_token的使用及天生方式说明：

1. 为了保密appsecrect，
   ，，第三方需要一个access_token获取和刷新的中控服务器。。
   。。
   。而其他营业逻辑服务器所使用的access_token均来自于该中控服务器，
   ，，不应该各自去刷新，
   ，，否则会造成access_token笼罩而影响营业；；；；；；
2. 现在access_token的有用期通过返回的expire_in来转达，
   ，，现在是7200秒之内的值。。
   。。
   。中控服务器需要凭证这个有用时间提前往刷新新access_token。。
   。。
   。在刷新历程中，
   ，，中控服务器对外输出的依然是老access_token，
   ，，此时公众平台后台会包管在刷新短时间内，
   ，，新老access_token都可用，
   ，，这包管了第三方营业的平滑过渡；；；；；；
3. access_token的有用时间可能会在未来有调解，
   ，，以是中控服务器不但需要内部准时自动刷新，
   ，，还需要提供被动刷新access_token的接口，
   ，，这样便于营业服务器在API挪用获知access_token已超时的情形下，
   ，，可以触发access_token的刷新流程。。
   。。
   。

开发者可以使用AppID和AppSecret挪用本接口来获取access_token。。
。。
。AppID和AppSecret可登录微信公众平台官网-设置-开发设置中获得（需要已经绑定成为开发者，
，，且帐号没有异常状态）。。
。。
。AppSecret天生后请自行生涯，
，，由于在公众平台每次天生审查都会导致AppSecret被重置。。
。。
。注重挪用所有微信接口时均需使用https协议。。
。。
。若是第三方不使用中控服务器，
，，而是选择各个营业逻辑点各自去刷新access_token，
，，那么就可能会爆发冲突，
，，导致服务不稳固。。
。。
。

接口地点：

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

HTTP请求方式:

GET

参数说明 :

参数	必填	说明
grant_type	是	获取access_token填写client_credential
appid	是	第三方用户唯一凭证
secret	是	第三方用户唯一凭证密钥， ，，即appsecret

返回参数说明：

正常情形下，
，，微信会返回下述JSON数据包给开发者：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

参数	说明
access_token	获取到的凭证
expires_in	凭证有用时间， ，，单位：秒

过失时微信会返回过失码等信息，
，，JSON数据包示例如下（该示例为AppID无效过失）:

{"errcode":40013,"errmsg":"invalid appid"}

2. 发送模板新闻

接口地点：(ACCESS_TOKEN需换成上文获取到的access_token)

https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN

HTTP请求方式：

POST

POST参数说明：

参数	必填	说明
touser	是	吸收者（用户）的openid
template_id	是	所需下发的模板新闻的id
page	否	点击模板审查详情跳转页面， ，，不填则模板无跳转
form_id	是	表单提交场景下， ，，为submit事务带上的formId；；；；；；支付场景下， ，，为本次支付的prepay_id
value	是	模板内容， ，，不填则下发空模板
color	否	模板内容字体的颜色， ，，不填默认玄色
emphasis_keyword	否	模板需要放大的要害词， ，，不填则默认无放大

示例：

{
  "touser": "OPENID",  
  "template_id": "TEMPLATE_ID", 
  "page": "index",          
  "form_id": "FORMID",         
  "data": {
      "keyword1": {
          "value": "339208499", 
          "color": "#173177"
      }, 
      "keyword2": {
          "value": "2015年01月05日 12:30", 
          "color": "#173177"
      }, 
      "keyword3": {
          "value": "粤海喜来登旅馆", 
          "color": "#173177"
      } , 
      "keyword4": {
          "value": "广州市天河区天河路208号", 
          "color": "#173177"
      } 
  },
  "emphasis_keyword": "keyword1.DATA" 
}

返回码说明：

在挪用模板新闻接口后，
，，会返回JSON数据包。。
。。
。

正常时的返回JSON数据包示例：

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

过失时会返回过失码信息，
，，说明如下：

 

返回码	说明
40037	template_id不准确
41028	form_id不准确， ，，或者逾期
41029	form_id已被使用
41030	page不准确
45009	接口挪用凌驾限额（现在默认每个帐号日挪用限额为100万）

 

使用效果：

下发条件说明

---

1. 支付

   当用户在小程序内完成过支付行为，
   ，，可允许开发者向用户在7天内推送有限条数的模板新闻（1次支付可下发3条，
   ，，多次支付下发条数自力，
   ，，相互不影响）

2. 提交表单

   当用户在小程序内爆发过提交表单行为且该表单声明为要发模板新闻的，
   ，，开发者需要向用户提供服务时，
   ，，可允许开发者向用户在7天内推送有限条数的模板新闻（1次提交表单可下发1条，
   ，，多次提交下发条数自力，
   ，，相互不影响）

审核说明

---

1.问题

1.1问题不可保存相同

1.2问题意思不可保存太过相似

1.3问题必需以“提醒”或“通知”最后

1.4问题不可带特殊符号、个性化字词等没有行业通用性的内容

1.5问题必需能体现详细服务场景

1.6问题不可涉及营销相关内容，
，，包括不限于：

消耗优惠类、购物返利类、商品更新类、优惠券类、代金券类、红包类、会员卡类、积分类、活动类等营销倾向通知

2.要害词

2.1统一问题下，
，，要害词不可保存相同

2.2统一问题下，
，，要害词不可保存太过相似

2.3要害词不可带特殊符号、个性化字词等没有行业通用性的内容

2.4要害词内容示例必需与要害词对应匹配

2.5要害词不可太过宽泛，
，，需要具有限制性，
，，例如：“内容”这个就太宽泛，
，，不可审核通过

违规说明

---

除不可违反运营规范外，
，，还不可违反以下规则，
，，包括但不限于：

1. 不允许恶意诱导用户举行触发操作，
   ，，以抵达可向用户下发模板目的
2. 不允许恶意骚扰，
   ，，下发对用户造成骚扰的模板
3. 不允许恶意营销，
   ，，下发营销目的模板

处分说明

---

凭证违规情形给予响应梯度的处分，
，，一般处分规则如下：

第一次违规，
，，删除违规模板以示忠言，
，，

第二次违规，
，，封禁接口7天，
，，

第三次违规，
，，封禁接口30天，
，，

第四次违规，
，，永世封禁接口

处分效果及原因以站内信形式见告

 

 

Bug & Tip

1. tip: 微信6.5.2及以上版本支持模板功效。。
   。。
   。低于该版本将无法收到模板新闻。。
   。。
   。

 

更多微信小程序开发教程，
，，可以关注。。
。。
。

KESION 金狮贵宾会软件

KESION 金狮贵宾会软件是海内领先的在线教育软件及私域社交电商软件服务提供商，
，，恒久专注于为企业提供在线教育软件及社交电商SaaS平台解决方案。。
。。
。
公司焦点产品云开店SaaS社交电商服务平台、在线教育SaaS服务平台、教育企业数字化SaaS云平台、企微营销助手、私有化自力安排品牌网校和在线教育咨询等。。
。。
。

KESION 一直通过手艺立异，
，，提供产品和服务，
，，助力企业向数字化转型，
，，通过科技驱动商业刷新，
，，让商业变得更智慧！

▼点击进入金狮贵宾会官网相识更多