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

前面分享了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包的时候参数名称也必须是这样，这样大家明白了吧。