小程序之模板消息

使用模板消息

1. 获取模板 id

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

 

1. 页面的 <form/> 组件，属性report-submit为true时，能够声明为需发模板消息，此时点击按钮提交表单能够获取formId，用于发送模板消息。或者当用户完成支付行为，能够获取prepay_id用于发送模板消息。

2. 调用接口下发模板消息（详见接口说明）

接口说明

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 的有效期经过返回的 expires_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

 

正常状况下，微信会返回下述 JSON 数据包给开发者：返回参数说明：

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

　　

{"errcode": 40013, "errmsg": "invalid appid"}错误时微信会返回错误码等信息，JSON 数据包示例以下（该示例为 AppID 无效错误）:

2. 发送模板消息

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

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

　　HTTP请求方式: POST

 eg：

{
  "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",
}

　　

下发条件说明

1. 支付

   当用户在小程序内完成过支付行为，可容许开发者向用户在7天内推送有限条数的模板消息（1次支付可下发1条，屡次支付下发条数独立，互相不影响）

2. 提交表单

   当用户在小程序内发生过提交表单行为且该表单声明为要发模板消息的，开发者须要向用户提供服务时，可容许开发者向用户在7天内推送有限条数的模板消息（1次提交表单可下发1条，屡次提交下发条数独立，相互不影响）

模板消息填坑指南：

一开始的时候下发模板消息是在微信吊起支付成功后触发，此时发现模板消息有时好用，偶尔很差用，很差用的仍是报错是 41028，form_id不正确，或者过时。问询了一些前辈才知道是存在网络延迟，致使不起做用，采用定时器这种发现，循环调用模板消息，在

调用成功后中止定时器。

给一个具体的例子：

 

var time = setInterval(function () {
        tem();//定时发起模板消息请求，校验

  }, 5000) 

function tem(){
　　var  l = 'https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN;
　　var g = { 
　　
     touser: openId, 
　　
　   template_id: '申请的模板id',
　
　　　page: '模板入口页面',
　
　　 form_id: 本次支付的prepay_id,  //只有在支付成功时 form_id 才有值 
　　　　 data: {

            "keyword1": {
              "value":key1,
              "color": "#4a4a4a"
            },
            "keyword2": {
              "value": key2,
              "color": "#9b9b9b"
            },
            "keyword3": {
              "value": key3,
              "color": "#9b9b9b"
            },
            "keyword4": {
              "value": key4,
              "color": "#9b9b9b"
            },
            "keyword5": {
              "value": key5, 
              "color": "#172177"
            },
          },
          emphasis_keyword: 'keyword1.DATA' //模板须要放大的关键词
}

wx.request({
          url: l,　　//
          data: g, //模板数据
          method: 'POST',
          success: function (res) {
            if (res.data.errcode == 0) { console.log("sucess"); clearInterval(time); }
            console.log(res);
            // wx.showToast({
            //   title: '订单支付成功',
            //   icon: 'success',
            //   duration: 1000
            // })
          },
          fail: function (err) {
            // fail  
            console.log("push err")
            console.log(err);
            // 测试
            wx.showToast({
              title: err.errmsg,//'系统繁忙'
              icon: 'success',
              duration: 1000
            })
          },
          complete: function (res) {
            console.log("tem-complete")
          }
        });
      };
}

　　另外有一个问题是 在微信吊起支付，支付完成后点击完成才会发送模板消息 这一点问了不少人 不知道怎么解决 ，若是有方案欢饮沟通。