模板消息僅用于公眾號向用戶發(fā)送重要的服務通知，只能用于符合其要求的服務場景中，如信用卡刷卡通知，商品購買成功通知等。不支持廣告等營銷類消息以及其它所有可能對用戶造成騷擾的消息。

關于使用規(guī)則，請注意：

1、所有服務號都可以在功能->添加功能插件處看到申請模板消息功能的入口，但只有認證后的服務號才可以申請模板消息的使用權限并獲得該權限；
2、需要選擇公眾賬號服務所處的2個行業(yè)，每月可更改1次所選行業(yè)；
3、在所選擇行業(yè)的模板庫中選用已有的模板進行調用；
4、每個賬號可以同時使用25個模板。
5、當前每個賬號的模板消息的日調用上限為10萬次，單個模板沒有特殊限制?！?014年11月18日將接口調用頻率從默認的日1萬次提升為日10萬次，可在MP登錄后的開發(fā)者中心查看】。當賬號粉絲數(shù)超過10W/100W/1000W時，模板消息的日調用上限會相應提升，以公眾號MP后臺開發(fā)者中心頁面中標明的數(shù)字為準。

關于接口文檔，請注意：

1、模板消息調用時主要需要模板ID和模板中各參數(shù)的賦值內容；
2、模板中參數(shù)內容必須以".DATA"結尾，否則視為保留字；
3、模板保留符號"{{ }}"。

設置所屬行業(yè)

設置行業(yè)可在MP中完成，每月可修改行業(yè)1次，賬號僅可使用所屬行業(yè)中相關的模板，為方便第三方開發(fā)者，提供通過接口調用的方式來修改賬號所屬行業(yè)，具體如下：

接口調用請求說明

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

POST數(shù)據說明

POST數(shù)據示例如下：

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

參數(shù)說明

行業(yè)代碼查詢

獲取設置的行業(yè)信息

獲取帳號設置的行業(yè)信息?？稍贛P官網中查看行業(yè)信息，為方便第三方開發(fā)者，提供通過接口調用的方式來獲取帳號所設置的行業(yè)信息，具體如下:

接口調用請求說明

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

參數(shù)說明

返回說明

正確調用后的返回示例：

{
"primary_industry":{"first_class":"運輸與倉儲","second_class":"快遞"},
"secondary_industry":{"first_class":"IT科技","second_class":"互聯(lián)網|電子商務"}
}

返回參數(shù)說明

獲得模板ID

從行業(yè)模板庫選擇模板到帳號后臺，獲得模板ID的過程可在MP中完成。為方便第三方開發(fā)者，提供通過接口調用的方式來獲取模板ID，具體如下：

接口調用請求說明

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

POST數(shù)據說明

POST數(shù)據示例如下：

      {
           "template_id_short":"TM00015"
       }

參數(shù)說明

返回碼說明

在調用模板消息接口后，會返回JSON數(shù)據包。正常時的返回JSON數(shù)據包示例：

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

獲取模板列表

獲取已添加至帳號下所有模板列表，可在MP中查看模板列表信息，為方便第三方開發(fā)者，提供通過接口調用的方式來獲取帳號下所有模板信息，具體如下:

接口調用請求說明

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

參數(shù)說明

返回說明

正確調用后的返回示例：

{	
 "template_list": [{
      "template_id": "iPk5sOIt5X_flOVKn5GrTFpncEYTojx6ddbt8WYoV5s",
      "title": "領取獎金提醒",
      "primary_industry": "IT科技",
      "deputy_industry": "互聯(lián)網|電子商務",
      "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到達您的銀行卡"
   }]
}

返回參數(shù)說明

刪除模板

刪除模板可在MP中完成，為方便第三方開發(fā)者，提供通過接口調用的方式來刪除某帳號下的模板，具體如下：

接口調用請求說明

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

POST數(shù)據說明如下：

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

參數(shù)說明

返回說明

在調用接口后，會返回JSON數(shù)據包。正常時的返回JSON數(shù)據包示例：

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

發(fā)送模板消息

接口調用請求說明

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

POST數(shù)據說明

POST數(shù)據示例如下：

      {
           "touser":"OPENID",
           "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "url":"http://weixin.qq.com/download",            
           "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"
                   }
           }
       }

參數(shù)說明

返回碼說明

在調用模板消息接口后，會返回JSON數(shù)據包。正常時的返回JSON數(shù)據包示例：

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

事件推送

在模版消息發(fā)送任務完成后，微信服務器會將是否送達成功作為通知，發(fā)送到開發(fā)者中心中填寫的服務器配置地址中。

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>

參數(shù)說明

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>

參數(shù)說明

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>

參數(shù)說明