Java開(kāi)發(fā)公眾號(hào)發(fā)送模板消息

• • 1：獲取模版ID
  • 2：請(qǐng)求接口
  • • 效果展示圖
  • 事件推送
  • 返回碼說(shuō)明

1：獲取模版ID

通過(guò)在模版消息功能的模版庫(kù)中使用需要的模版，可以獲得模版ID。

2：請(qǐng)求接口

請(qǐng)注意，URL置空，則在發(fā)送后，點(diǎn)擊模版消息會(huì)進(jìn)入一個(gè)空白頁(yè)面（ios），或無(wú)法點(diǎn)擊（android）。

POST請(qǐng)求

https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN
請(qǐng)求包為一個(gè)json：

{
"touser":"OPENID",
"template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
"url":"http://weixin.qq.com/download",
"topcolor":"#FF0000",
"data":{
"User": {
"value":"黃先生",
"color":"#173177"
},
"Date":{
"value":"06月07日 19時(shí)24分",
"color":"#173177"
},
"CardNumber":{
"value":"0426",
"color":"#173177"
},
"Type":{
"value":"消費(fèi)",
"color":"#173177"
},
"Money":{
"value":"人民幣260.00元",
"color":"#173177"
},
"DeadTime":{
"value":"06月07日19時(shí)24分",
"color":"#173177"
},
"Left":{
"value":"6504.09",
"color":"#173177"
}
}
}

效果展示圖

事件推送

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

1、送達(dá)成功時(shí)，推送的XML如下：

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

2、送達(dá)由于用戶拒收（用戶設(shè)置拒絕接收公眾號(hào)消息）而失敗時(shí)，推送的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、送達(dá)由于其他原因失敗時(shí)，推送的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>

返回碼說(shuō)明

在調(diào)用模版消息接口后，會(huì)返回JSON數(shù)據(jù)包。正常時(shí)的返回JSON數(shù)據(jù)包示例：

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

錯(cuò)誤時(shí)的返回JSON數(shù)據(jù)，形式類似，錯(cuò)誤碼請(qǐng)見(jiàn)本頁(yè)下方返回碼說(shuō)明。

返回碼說(shuō)明-1系統(tǒng)繁忙0請(qǐng)求成功40001驗(yàn)證失敗40002不合法的憑證類型40003不合法的OpenID40004不合法的媒體文件類型40005不合法的文件類型40006不合法的文件大小40007不合法的媒體文件id40008不合法的消息類型40009不合法的圖片文件大小40010不合法的音頻文件大小40011不合法的視頻文件大小40012不合法的縮略圖文件大小40013不合法的APPID41001缺少access_token參數(shù)41002缺少appid參數(shù)41003缺少refresh_token參數(shù)41004缺少secret參數(shù)41005缺少多媒體文件數(shù)據(jù)41006access_token超時(shí)42001需要GET請(qǐng)求43002需要POST請(qǐng)求43003需要HTTPS請(qǐng)求44001多媒體文件為空44002POST的數(shù)據(jù)包為空44003圖文消息內(nèi)容為空45001多媒體文件大小超過(guò)限制45002消息內(nèi)容超過(guò)限制45003標(biāo)題字段超過(guò)限制45004描述字段超過(guò)限制45005鏈接字段超過(guò)限制45006圖片鏈接字段超過(guò)限制45007音頻播放時(shí)間超過(guò)限制45008圖文消息超過(guò)限制45009接口調(diào)用超過(guò)限制46001不存在媒體數(shù)據(jù)47001解析JSON/XML內(nèi)容錯(cuò)誤