模板消息僅用於公衆號向用戶發送重要的服務通知,只能用於符合其要求的服務場景中,如信用卡刷卡通知,商品購買成功通知等。不支持廣告等營銷類消息以及其它所有可能對用戶造成騷擾的消息。對於一般的服務號而言,模板ID行業之類會事先配置好,所以用代碼控制的只有發送了。
準備工作:已通過認證的服務號或者測試公衆號
一、使用規則
- 所有服務號都可以在功能->添加功能插件處看到申請模板消息功能的入口
- 需要選擇公衆賬號服務所處的2個行業,每月可更改1次所選行業
- 在所選擇行業的模板庫中選用已有的模板進行調用
- 每個賬號可以同時使用25個模板
- 當前每個賬號的模板消息的日調用上限爲10萬次,單個模板沒有特殊限制,以公衆號MP後臺開發者中心頁面中標明的數字爲準
二、接口文檔規範
- 模板消息調用時主要需要模板ID和模板中各參數的賦值內容
- 模板中參數內容必須以".DATA"結尾,否則視爲保留字
- 模板保留符號"{{ }}"
測試公衆號可以隨意定義,正式的必須用模板庫中的
三、 封裝模板消息
以下是我使用的模板消息示例
{{first.DATA}}
旅行活動名稱:{{keyword1.DATA}}
訂單金額:{{keyword2.DATA}}
旅行時間:{{keyword3.DATA}}
參與人數:{{keyword4.DATA}}
{{remark.DATA}}
POST數據示例如下:
{
"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"
}
}
}
@Getter
@Setter
@NoArgsConstructor
public class WechatTemplateMessage implements Serializable {
private static final long serialVersionUID = -1035536196053732735L;
@SerializedName("touser")
private String touser; //接收者openid
@SerializedName("template_id")
private String templateId; //模板ID
@NotRequire//只是個標識
private String url; //模板跳轉鏈接
// "miniprogram":{ 未加入
// "appid":"xiaochengxuappid12345",
// "pagepath":"index?foo=bar"
// },
private Map<String, Map<String, String>> data; //data數據
public WechatTemplateMessage(String templateId, String url) {
this.templateId = templateId;
this.url = url;
}
/**
* 參數
*
* @param value
* @param color 可不填
* @return
*/
public Map<String, String> item(String value, String color) {
Map<String, String> params = new HashMap<>();
params.put("value", value);
params.put("color", color == null ? "#000000" : color);
return params;
}
public String toJson() {
return JsonUtil.toJson(this);
}
}
四、發送模板消息
// 發送模板消息
public static final String SEND_TEMPLATE_MESSAGE = "https://api.weixin.qq.com/cgi-bin/message/template/send";
/**
* 發送模板消息
*
* @param accessToken
* @param data
* @return 狀態
*/
@Override
public TemplateMessageResult sendTemplate(String accessToken, String data) {
Map<String, String> params = new HashMap<>();
params.put("access_token", accessToken);
String result = HttpUtil.doPost(wechatMessageConfig.getSendTemplateMessageUrl(),
params, data);
return JsonUtil.fromJson(result, TemplateMessageResult.class);
}
五、根據業務調用方法
一般註冊成功、支付成功、支付失敗等等情況下會用到,以下只是個Junit
package com.phil.wechat.message.service.impl;
import com.phil.WechatMainApplication;
import com.phil.wechat.auth.service.WechatAuthService;
import com.phil.wechat.message.model.template.request.WechatTemplateMessage;
import com.phil.wechat.message.service.WechatTemplateMessageService;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.ActiveProfiles;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import java.util.HashMap;
import java.util.Map;
@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest(classes = WechatMainApplication.class)
@ActiveProfiles("dev")
public class WechatTemplateMessageServiceImplTest {
@Autowired
private WechatAuthService wechatAuthService;
@Autowired
private WechatTemplateMessageService wechatTemplateMessageService;
@Test
public void testSendTemplate() {
String accessToken = wechatAuthService.getAccessToken();
Map<String, Map<String, String>> params = new HashMap<>();
WechatTemplateMessage template = new WechatTemplateMessage();
params.put("keyword1", template.item("8.1發現尼泊爾—人文與自然的旅行聖地", null));
params.put("keyword2", template.item("5000元", null));
params.put("keyword3", template.item("2017.1.2", null));
params.put("keyword4", template.item("5", null));
template.setTemplateId("Ub2oYYFPf8ofmA17H31Zqu9Z_HLycZ7MC-Dx_Se1Nkw");
template.setTouser("ovHQ5v6CW3INkWUsCl3olODif0cc");
template.setUrl("http://music.163.com/#/song?id=27867140");
template.setData(params);
System.out.println(wechatTemplateMessageService.sendTemplate(accessToken, template.toJson()));
//ResultState(errcode=0, errmsg=ok)
}
}
具體源碼:https://github.com/philjing/my_wechat/tree/master/src/main/java/com/phil/wechat/message/service