聊聊微信模板消息开发的一些细节

2017年09月23日 07:34 | 528次浏览 | 分类: 微信模板消息 作者原创 版权保护

前面分享了5篇微信模板消息的开发,一直没有仔细说说微信模板消息json格式如何定义,只是做出了模板消息类型实例,今天这篇文章来讲述微信模板消息的json格式如何定义,这样搞明白了大家就可以随便添加任何一种类型的消息模板,自己就能组织出来发送格式。首先咱们看看官方文档怎么介绍的。


为了保证用户不受到骚扰,在开发者出现需要主动提醒、通知用户时,才允许开发者在公众平台网站中模版消息库中选择模版,选择后获得模版ID,再根据模版ID向用户主动推送提醒、通知消息。

模版消息调用时主要需要模版ID和模版中各参数的赋值内容。请注意:

1.模版中参数内容必须以".DATA"结尾,否则视为保留字;

2.模版保留符号"{{ }}"

具体调用方法

第一步:获取模版ID

通过在模版消息功能的模版库中使用需要的模版,可以获得模版ID。

第二步:请求接口

请注意,URL置空,则在发送后,点击模版消息会进入一个空白页面(ios),或无法点击(android)。

POST请求

https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

请求包为一个json:

{
"touser":"OPENID",
"template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
"url":"http://weixin.qq.com/download",
"topcolor":"#FF0000",
"data":{
"User": {
"value":"黄先生",
"color":"#173177"
},
"Date":{
"value":"06月07日 19时24分",
"color":"#173177"
},
"CardNumber":{
"value":"0426",
"color":"#173177"
},
"Type":{
"value":"消费",
"color":"#173177"
},
"Money":{
"value":"人民币260.00元",
"color":"#173177"
},
"DeadTime":{
"value":"06月07日19时24分",
"color":"#173177"
},
"Left":{
"value":"6504.09",
"color":"#173177"
}
}
}

以上就是官方文档的说明。

其实对于开发者来说已经说得很明白了,但是,,最让人头条的就是这个json请求包的组织,在这里咱们看看添加了一个电费账单消息模板。(www.vxzsk.com V型知识库原创! )

如上图所示,开发者看到这里直接就懵逼了,什么情况这是,其实红色圈圈部分就是json包的一部分格式,结合第二步请求接口介绍的json请求包我们就明白了,它的固定格式是:

{
"touser":"OPENID",
"template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
"url":"http://weixin.qq.com/download",
"topcolor":"#FF0000",
"data":{

touser,template_id,url,topcolor都是固定的,参数名称必须这样子叫,改变的是data这个参数值,而这个参数值恰恰就是如上图所示红色圆圈部分的格式。例如上述圆圈部分的格式为:

{{first.DATA}}
用电地址:{{keyword1.DATA}}
电费年月:{{keyword2.DATA}}
总用电量:{{keyword3.DATA}}
应收金额:{{keyword4.DATA}}
实收金额:{{keyword5.DATA}}
{{remark.DATA}}

那么完整发送模板消息的json包就是:

{
"touser":"OPENID",
"template_id":"ngqIpbwh8bUfcSsECxxgfXcV14J0tQlEpBO27izEYtY",
"url":"http://weixin.qq.com/download",
"topcolor":"#FF0000",
"data":{"first":
{"value":"尊敬的用户,您当前用电余额不足,希望您及时续交电费,以免影响您的正常用电!","color":"#173177"},
"keyword1":{"value":"12899983773","color":"#173177"},
"keyword2":{"value":"20.99","color":"#173177"},
"keyword3":{"value":"20.99","color":"#173177"},
"keyword4":{"value":"20.99","color":"#173177"},
"keyword5":{"value":"20.99","color":"#173177"},
"remark":{"value":"欢迎再次使用!【公众号】","color":"#173177"}}}

看仔细了,如上图所示的格式给的是keyword1,....一直到keyword5,最后是remark,那么我们组织json包的时候参数名称也必须是这样,这样大家明白了吧。


此文章本站原创,地址 http://www.vxzsk.com/1447.html   转载请注明出处!谢谢!

感觉本站内容不错,读后有收获?小额赞助,鼓励网站分享出更好的教程