微信公众号开发（十）模板消息

模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。

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>