模板消息是指:按照一定的模板样式发送给用户的消息,顾名思义,它的内容必须限制在某一个模板框框内,只能做填空题,做不了主观题。
场景举例:用户A下了订单并交易成功,应该给该用户手机端下发一条交易提醒的通知消息,提升用户体验感。
限制:通知标题和字段内容只能从平台给出的模板里面选择,无法自定义,如果平台提供的模板确实都无法符合业务场景的,可以向平台申请新模板和关键字,不过一提到申请,不用说,按尿性肯定是要审核时间的,还可能一次通过不了,要修改了再提交审核,反正就是要花时间。
不过按照官方提示,目前只有今日头条支持,抖音和 lite 还在接入中。最终效果展示在文末
1、配置模板消息
第一步就是要先到小程序管理后台去创建消息模板,配置好关键词,生成消息通知ID,这个ID至关重要,因为它是模板消息接口必传参数之一,如下。
2、代码实现
看一下发送消息的方法,如下:
/**
* 字节跳动发送模板消息通知
* https://developer.toutiao.com/docs/server/template_message/send.html
* @param templateVo
* @return
*/
public static boolean sendMessage(TemplateVo templateVo) {
boolean flag = false;
TouTiaoTemplate t = new TouTiaoTemplate();
t.setAccess_token(templateVo.getAccessToken());
t.setTouser(templateVo.getOpenId());
t.setTemplate_id(templateVo.getTemplateId());
t.setPage(templateVo.getPage());
t.setForm_id(templateVo.getFormId());
Map<String, SubData> m = new HashMap<String, SubData>();
List<String> values = templateVo.getValues();
int nums = values.size();
for (int i = 0;i < nums;i++) {
SubData keyword = new SubData();
keyword.setValue(values.get(i));
m.put("keyword"+i, keyword);
}
t.setData(m);
String requestParam = JSON.toJSONString(t);
JSONObject jsonObject = CommonUtil.httpsRequestJson("https://developer.toutiao.com/api/apps/game/template/send",
"POST", requestParam);
logger.info("头条消息推送模板json======{}",jsonObject);
if (jsonObject != null) {
int errorCode = jsonObject.getInt("errcode");
String errorMessage = jsonObject.getString("errmsg");
if (errorCode == 0) {
logger.info(errorCode + "," + errorMessage);
flag = true;
} else {
logger.info("头条消息发送失败:" + errorCode + "," + errorMessage);
flag = false;
}
}
return flag;
}
针对上面的 TemplateVo 参数所包含的字段解释一下:
String openId:要发送给用户的openid,必传
String accessToken:服务端API调用标识,必传
String formId:可以通过组件获得form_id,必传,这个是前端同学传过来的,不用我们后台关心
String templateId:在开发者平台配置消息模版后获得的模版id,必传
String page:点击消息卡片之后打开的小程序页面地址,空则无跳转,非必传,个人觉得传了比较好,也不差这一个参数,让用户点击模板消息就到相应的页面,体验会更好,比如到首页,格式如:pages/index/index
List values:这是一个数组,就是对应于我们模板消息的各个关键字的值,顺序一定要对,不能乱
同样,针对上面的 TouTiaoTemplate 参数所包含的字段解释一下,和TemplateVo差不多,只不过TouTiaoTemplate封装的是直接传给抖音接口的参数,TemplateVo是为了方便外部调用而封装的参数:
access_token:服务端API调用标识,必传
touser:要发送给用户的openid,必传
template_id:在开发者平台配置消息模版后获得的模版id,必传
page:点击消息卡片之后打开的小程序页面地址,空则无跳转,非必传,个人觉得传了比较好,也不差这一个参数,让用户点击模板消息就到相应的页面,体验会更好,比如到首页,格式如:pages/index/index
form_id:可以通过组件获得form_id,必传,这个是前端传过来的,不用我们后台关心
data:模板中填充着的数据,key必须是keyword为前缀,必传,注意,要求是key必须是keyword为前缀,如下面的for循环那样拼接,取到传入的values数组,然后遍历出来拼接上keyword前缀
for (int i = 0;i < nums;i++) {
SubData keyword = new SubData();
keyword.setValue(values.get(i));
m.put("keyword"+i, keyword);
}
httpsRequestJson 这个http请求方法代码参考实现微信扫描二维码关注公众号,直接注册登录网站这篇文章。
3、发送效果
说再多都没用,看下最终的效果哈