模板消息仅用于公众号向用户发送重要的服务通知,只能用于符合其要求的服务场景中,如信用卡刷卡通知,商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。
1、设置所属行业
设置行业可在微信公众平台后台完成,每月可修改行业1次,帐号仅可使用所属行业中相关的模板。
接口:https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN
tem_set_industry.php
<?php
@header('Content-type: text/plain;charset=UTF-8');
require_once("../Utils.php");
$data = '{
"industry_id1":"1",
"industry_id2":"4"
}';
$url = "https://api.weixin.qq.com/cgi-bin/template/api_set_industry?"
."access_token=".Utils::get_access_token();
$result = Utils::https_request($url, $data);
echo $result;
返回:
{"errcode":0,"errmsg":"ok"}
2、获取设置的行业信息
接口:https://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN
tem_get_industry.php
<?php
@header('Content-type: text/plain;charset=UTF-8');
require_once("../Utils.php");
$url = "https://api.weixin.qq.com/cgi-bin/template/get_industry?"
."access_token=".Utils::get_access_token();
$result = Utils::https_request($url);
echo $result;
返回:
primary_industry:账号设置的主营行业
secondary_industry:账号设置的副营行业
{
"primary_industry": {
"first_class": "IT科技",
"second_class": "互联网|电子商务"
},
"secondary_industry": {
"first_class": "IT科技",
"second_class": "电子技术"
}
}
3、获得模板ID
从行业模板库选择模板到帐号后台,获得模板ID的过程可在微信公众平台后台完成。
接口:https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN
tem_add_template.php
template_id_short:模板库中模板的编号,有“TM**”和“OPENTMTM**”等形式
<?php
@header('Content-type: text/plain;charset=UTF-8');
require_once("../Utils.php");
$data = '{
"template_id_short":"TM00015"
}';
$url = "https://api.weixin.qq.com/cgi-bin/template/api_add_template?"
."access_token=".Utils::get_access_token();
$result = Utils::https_request($url, $data);
echo $result;
返回:
{
"errcode": 0,
"errmsg": "ok",
"template_id": "V4Gx8O_WixAGUIkYwjm2EuWBbq-L-wz8KUJzhMoUJXk"
}
4、获得模板列表
获取已添加至帐号下所有模板列表,可在微信公众平台后台中查看模板列表信息。
接口:https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN
tem_private_template.php
@header('Content-type: text/plain;charset=UTF-8');
require_once("../Utils.php");
$url = "https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?"
."access_token=".Utils::get_access_token();
$result = Utils::https_request($url);
echo $result;
返回:
{
"template_list": [
{
"template_id": "V4Gx8O_WixAGUIkYwjm2EuWBbq-L-wz8KUJzhMoUJXk",
"title": "订单支付成功",
"primary_industry": "IT科技",
"deputy_industry": "互联网|电子商务",
"content": "{{first.DATA}}\n\n支付金额:{{orderMoneySum.DATA}}\n商品信息:{{orderProductName.DATA}}\n{{Remark.DATA}}",
"example": "我们已收到您的货款,开始为您打包商品,请耐心等待: )\n支付金额:30.00元\n商品信息:我是商品名字\n\n如有问题请致电400-828-1878或直接在微信留言,小易将第一时间为您服务!"
}
]
}
5、删除模板
接口:https://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKEN
tem_del_template.php
<?php
@header('Content-type: text/plain;charset=UTF-8');
require_once("../Utils.php");
$data = '{
"template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE"
}';
$url = "https://api.weixin.qq.com/cgi-bin/template/del_private_template?"
."access_token=".Utils::get_access_token();
$result = Utils::https_request($url, $data);
echo $result;
返回:
{
"errcode" : 0,
"errmsg" : "ok"
}
6、发送模板消息
接口:https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN
tem_send.php
<?php
@header('Content-type: text/plain;charset=UTF-8');
require_once("../Utils.php");
$data = '{
"touser": "o4WmZ0h-4huBUVQUczx2ezaxIL9c",
"template_id": "V4Gx8O_WixAGUIkYwjm2EuWBbq-L-wz8KUJzhMoUJXk",
"url": "http://www.baidu.com",
"data": {
"first": {
"value": "我们已收到您的货款,开始为您打包商品,请耐心等待:",
"color": "#173177"
},
"orderMoneySum": {
"value": "30.00元",
"color": "#173177"
},
"orderProductName": {
"value": "洗发水",
"color": "#173177"
},
"Remark": {
"value": "如有问题请致电400-828-1878或直接在微信留言,小易将第一时间为您服务!",
"color": "#173177"
}
}
}';
$url = "https://api.weixin.qq.com/cgi-bin/message/template/send?"
."access_token=".Utils::get_access_token();
$result = Utils::https_request($url, $data);
echo $result;
返回:
{"errcode":0,"errmsg":"ok","msgid":414862553}
7、事件推送
在模版消息发送任务完成后,微信服务器会将是否送达成功作为通知,发送到开发者中心中填写的服务器配置地址中。
成功送达推送:
<xml>
<ToUserName>
<![CDATA[gh_6b9aa8a6f1e2]]>
</ToUserName>
<FromUserName>
<![CDATA[o4WmZ0h-4huBUVQUczx2ezaxIL9c]]>
</FromUserName>
<CreateTime>1505407812</CreateTime>
<MsgType>
<![CDATA[event]]>
</MsgType>
<Event>
<![CDATA[TEMPLATESENDJOBFINISH]]>
</Event>
<MsgID>414862553</MsgID>
<Status>
<![CDATA[success]]>
</Status>
</xml>
送达由于用户拒收(用户设置拒绝接收公众号消息)而失败时,推送的XML如下:
<xml>
<ToUserName>
<![CDATA[gh_7f083739789a]]>
</ToUserName>
<FromUserName>
<![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]>
</FromUserName>
<CreateTime>1395658984</CreateTime>
<MsgType>
<![CDATA[event]]>
</MsgType>
<Event>
<![CDATA[TEMPLATESENDJOBFINISH]]>
</Event>
<MsgID>200163840</MsgID>
<Status>
<![CDATA[failed:user block]]>
</Status>
</xml>
送达由于其他原因失败时,推送的XML如下:
<xml>
<ToUserName>
<![CDATA[gh_7f083739789a]]>
</ToUserName>
<FromUserName>
<![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]>
</FromUserName>
<CreateTime>1395658984</CreateTime>
<MsgType>
<![CDATA[event]]>
</MsgType>
<Event>
<![CDATA[TEMPLATESENDJOBFINISH]]>
</Event>
<MsgID>200163840</MsgID>
<Status>
<![CDATA[failed: system failed]]>
</Status>
</xml>
相关博客