模板消息是指:按照一定的模板样式发送给用户的消息,顾名思义,它的内容必须限制在某一个模板框框内,只能做填空题,做不了主观题。
场景举例:用户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、发送效果
说再多都没用,看下最终的效果哈