公众号 接收规则 消息_微信公众平台 发送模板消息(Java接口开发)
前言：最近一直再弄微信掃碼推送圖文消息和模板消息發(fā)送，感覺學(xué)習(xí)到了不少東西。今天先總結(jié)一下微信公眾平臺(tái)模板消息的發(fā)送。因?yàn)檫@個(gè)自己弄了很久，開始很多地方不明白，所以今天好好總結(jié)一下。
微信公眾平臺(tái)技術(shù)文檔：模板消息接口
一、概述
模板消息僅用于公眾號(hào)向用戶發(fā)送重要的服務(wù)通知，只能用于符合其要求的服務(wù)場(chǎng)景中，如信用卡刷卡通知，商品購買成功通知等。不支持廣告等營銷類消息以及其它所有可能對(duì)用戶造成騷擾的消息。
關(guān)于使用規(guī)則，請(qǐng)注意：
1、所有服務(wù)號(hào)都可以在功能->添加功能插件處看到申請(qǐng)模板消息功能的入口，但只有認(rèn)證后的服務(wù)號(hào)才可以申請(qǐng)模板消息的使用權(quán)限并獲得該權(quán)限；
2、需要選擇公眾賬號(hào)服務(wù)所處的2個(gè)行業(yè)，每月可更改1次所選行業(yè)；
3、在所選擇行業(yè)的模板庫中選用已有的模板進(jìn)行調(diào)用；
4、每個(gè)賬號(hào)可以同時(shí)使用25個(gè)模板。
5、當(dāng)前每個(gè)賬號(hào)的模板消息的日調(diào)用上限為10萬次，單個(gè)模板沒有特殊限制。【2014年11月18日將接口調(diào)用頻率從默認(rèn)的日1萬次提升為日10萬次，可在MP登錄后的開發(fā)者中心查看】。當(dāng)賬號(hào)粉絲數(shù)超過10W/100W/1000W時(shí)，模板消息的日調(diào)用上限會(huì)相應(yīng)提升，以公眾號(hào)MP后臺(tái)開發(fā)者中心頁面中標(biāo)明的數(shù)字為準(zhǔn)。
關(guān)于接口文檔，請(qǐng)注意：
1、模板消息調(diào)用時(shí)主要需要模板ID和模板中各參數(shù)的賦值內(nèi)容；
2、模板中參數(shù)內(nèi)容必須以”.DATA”結(jié)尾，否則視為保留字；
3、模板保留符號(hào)”{{ }}”。
看微信公眾平臺(tái)接口文檔最開始我的內(nèi)心是崩潰的，因?yàn)槟夸浟斜硪婚_始就是設(shè)置所屬行業(yè)，獲取所屬行業(yè)信息等。后來整理思路，我們主要負(fù)責(zé)的功能的實(shí)現(xiàn)，就不去考慮那么多其他的內(nèi)容，直接弄模板消息的發(fā)送。但是發(fā)送模板之前有一個(gè)很重要的步驟，就是模板ID(template_id)。微信公眾平臺(tái)發(fā)送模板消息有嚴(yán)格的要求，參考模板消息運(yùn)營規(guī)范。
二、模板消息的設(shè)計(jì)
這里是依靠微信公眾平臺(tái)測(cè)試公眾號(hào)的模板消息接口來設(shè)計(jì)消息模板，通過行業(yè)類型來獲取模板的同學(xué)還是參考微信公眾平臺(tái)的官方文檔來學(xué)習(xí)。
1 新增模板消息
微信的測(cè)試公眾號(hào)為我們提供了測(cè)試的消息模板，最多可添加10個(gè)(感覺夠用，畢竟只是測(cè)試)，新增測(cè)試模板。
(1)添加模板標(biāo)題和模板內(nèi)容
模板標(biāo)題比較好理解，模板內(nèi)容需要設(shè)計(jì)參數(shù)，參數(shù)需以{{開頭，以.DATA}}結(jié)尾。
例如：{{first.DATA}}
first就是我們接口傳的參數(shù)。
{{first.DATA}}
商品：{{keynote1.DATA}}
價(jià)格：{{keynote2.DATA}}
日期：{{keynote3.DATA}}
{{remark.DATA}}
新增之后就可以看到模板記錄，就有我們需要的模板ID了。有了模板ID我們就可以按照接下來的微信公眾平臺(tái)發(fā)送模板消息接口來實(shí)現(xiàn)我們的功能。
三、發(fā)送模板消息
1 接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POST
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN
2 POST數(shù)據(jù)說明
POST數(shù)據(jù)示例如下：
{
"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"
}
}
}
3 參數(shù)說明
參數(shù)
是否必填
說明、
touser
是
接收者openid
template_id
是
模板ID
url
否
模板跳轉(zhuǎn)鏈接
miniprogram
否
跳小程序所需數(shù)據(jù)，不需跳小程序可不用傳該數(shù)據(jù)
appid
是
所需跳轉(zhuǎn)到的小程序appid(該小程序appid必須與發(fā)模板消息的公眾號(hào)是綁定關(guān)聯(lián)關(guān)系)
pagepath
是
所需跳轉(zhuǎn)到小程序的具體頁面路徑，支持帶參數(shù),(示例index?foo=bar)
data
是
模板數(shù)據(jù)
注：url和miniprogram都是非必填字段，若都不傳則模板無跳轉(zhuǎn)；若都傳，會(huì)優(yōu)先跳轉(zhuǎn)至小程序。開發(fā)者可根據(jù)實(shí)際需要選擇其中一種跳轉(zhuǎn)方式即可。當(dāng)用戶的微信客戶端版本不支持跳小程序時(shí)，將會(huì)跳轉(zhuǎn)至url。
4 java接口開發(fā)
(1)封裝請(qǐng)求參數(shù)Demo
public class TemplateData {
private String value;
private String color;
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
public String getColor() {
return color;
}
public void setColor(String color) {
this.color = color;
}
}
public class WechatTemplate {
private String touser;
private String template_id;
private String url;
private Map data;
public String getTouser() {
return touser;
}
public void setTouser(String touser) {
this.touser = touser;
}
public String getTemplate_id() {
return template_id;
}
public void setTemplate_id(String template_id) {
this.template_id = template_id;
}
public String getUrl() {
return url;
}
public void setUrl(String url) {
this.url = url;
}
public Map getData() {
return data;
}
public void setData(Map data) {
this.data = data;
}
}
(2)發(fā)送模板消息方法
public class TemplateMessageServiceImpl implements TemplateMessageService{
private RestTemplate restTemplate ;
private String serviceHost = "https://api.weixin.qq.com";
public TemplateMessageServiceImpl() {
restTemplate = RestTemplateFactory.makeRestTemplate();
}
@Override
public WeixinResponse sendTemplateMessage(String accessToken, WeixinTemplate weixinTemplate) {
WeixinResponse weixinResponse = null;
String url = new StringBuffer(serviceHost).append("/cgi-bin/message/template/send?access_token=")
.append(accessToken).toString();
weixinResponse = restTemplate.postForObject(url, weixinTemplate, WeixinResponse.class,new HashMap());
return weixinResponse;
}
}
說明：簡單理解模板消息發(fā)送，首先是獲取accessToken，(如何獲取請(qǐng)參考：微信公眾平臺(tái) 獲取access_token)。其次是模板消息的參數(shù)封裝，最后就是http的post請(qǐng)求。我的http請(qǐng)求是使用Spring的restTemplate進(jìn)行請(qǐng)求，就不用我單獨(dú)寫一個(gè)http請(qǐng)求方法，如果沒有使用可以寫一個(gè)http請(qǐng)求的工具類。
(3)封裝響應(yīng)參數(shù)Demo
package com.plateno.weixin.message.model;
public class WeixinResponse {
private String msgid;
private int errcode;
private String errmsg;
public String getMsgid() {
return msgid;
}
public void setMsgid(String msgid) {
this.msgid = msgid;
}
public int getErrcode() {
return errcode;
}
public void setErrcode(int errcode) {
this.errcode = errcode;
}
public String getErrmsg() {
return errmsg;
}
public void setErrmsg(String errmsg) {
this.errmsg = errmsg;
}
@Override
public String toString() {
StringBuffer buf = new StringBuffer("WeixinResponse[msgid=");
buf.append(msgid)
.append(",errcode=").append(errcode)
.append(",errmsg=").append(errmsg)
.append("]");
return buf.toString();
}
}
模板消息發(fā)送效果：
四、事件推送
在模版消息發(fā)送任務(wù)完成后，微信服務(wù)器會(huì)將是否送達(dá)成功作為通知，發(fā)送到開發(fā)者中心中填寫的服務(wù)器配置地址中。
1 送達(dá)成功時(shí)
(1)推送的XML如下
1395658920
200163836
(2)參數(shù)說明
參數(shù)
說明
ToUserName
公眾號(hào)微信號(hào)
FromUserName
接收模板消息的用戶的openid
CreateTime
創(chuàng)建時(shí)間
MsgType
消息類型是事件
Event
事件為模板消息發(fā)送結(jié)束
MsgID
消息id
Status
發(fā)送狀態(tài)為成功
2 送達(dá)由于用戶拒收(用戶設(shè)置拒絕接收公眾號(hào)消息)而失敗時(shí)
(1)推送的XML如下
1395658984
200163840
(2)參數(shù)說明
參數(shù)
說明
ToUserName
公眾號(hào)微信號(hào)
FromUserName
接收模板消息的用戶的openid
CreateTime
創(chuàng)建時(shí)間
MsgType
消息類型是事件
Event
事件為模板消息發(fā)送結(jié)束
MsgID
消息id
Status
發(fā)送狀態(tài)為用戶拒絕接收
3 送達(dá)由于其他原因失敗時(shí)
(1)推送的XML如下
1395658984
200163840
(2)參數(shù)說明
參數(shù)
說明
ToUserName
公眾號(hào)微信號(hào)
FromUserName
接收模板消息的用戶的openid
CreateTime
創(chuàng)建時(shí)間
MsgType
消息類型是事件
Event
事件為模板消息發(fā)送結(jié)束
MsgID
消息id
Status
發(fā)送狀態(tài)為發(fā)送失敗(非用戶拒絕)
以上就是本文的全部內(nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來咯，堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)總結(jié)
以上是生活随笔為你收集整理的公众号 接收规则 消息_微信公众平台 发送模板消息(Java接口开发)的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： linux open 头文件_linux
- 下一篇： springboot 添加拦截器之后中文