微信公众号开发 模板消息接口

由 如此轻盈 创建，Carrie 最后一次修改 2016-09-26 模板消息接口模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。关于使用规则，请注意：1、所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口，但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限；2、需要选择公众账号服务所处的2个行业，每月可更改1次所选行业；3、在所选择行业的模板库中选用已有的模板进行调用；4、每个账号可以同时使用25个模板。5、当前每个账号的模板消息的日调用上限为10万次，单个模板没有特殊限制。【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次，可在MP登录后的开发者中心查看】。当账号粉丝数超过10W/100W/1000W时，模板消息的日调用上限会相应提升，以公众号MP后台开发者中心页面中标明的数字为准。关于接口文档，请注意：1、模板消息调用时主要需要模板ID和模板中各参数的赋值内容；2、模板中参数内容必须以".DATA"结尾，否则视为保留字；3、模板保留符号"{{ }}"。设置所属行业设置行业可在MP中完成，每月可修改行业1次，账号仅可使用所属行业中相关的模板，为方便第三方开发者，提供通过接口调用的方式来修改账号所属行业，具体如下：接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下：      {          "industry_id1":"1",          "industry_id2":"4"       }参数说明参数是否必须说明access_token是接口调用凭证industry_id1是公众号模板消息所属行业编号industry_id2是公众号模板消息所属行业编号行业代码查询主行业副行业代码IT科技互联网/电子商务1IT科技IT软件与服务2IT科技IT硬件与设备3IT科技电子技术4IT科技通信与运营商5IT科技网络游戏6金融业银行7金融业基金|理财|信托8金融业保险9餐饮餐饮10酒店旅游酒店11酒店旅游旅游12运输与仓储快递13运输与仓储物流14运输与仓储仓储15教育培训16教育院校17政府与公共事业学术科研18政府与公共事业交警19政府与公共事业博物馆20政府与公共事业公共事业|非盈利机构21医药护理医药医疗22医药护理护理美容23医药护理保健与卫生24交通工具汽车相关25交通工具摩托车相关26交通工具火车相关27交通工具飞机相关28房地产建筑29房地产物业30消费品消费品31商业服务法律32商业服务会展33商业服务中介服务34商业服务认证35商业服务审计36文体娱乐传媒37文体娱乐体育38文体娱乐娱乐休闲39印刷印刷40其它其它41获取设置的行业信息获取帐号设置的行业信息。可在MP官网中查看行业信息，为方便第三方开发者，提供通过接口调用的方式来获取帐号所设置的行业信息，具体如下:接口调用请求说明http请求方式：GEThttps://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN参数说明参数是否必须说明access_token是接口调用凭证返回说明正确调用后的返回示例：{"primary_industry":{"first_class":"运输与仓储","second_class":"快递"},"secondary_industry":{"first_class":"IT科技","second_class":"互联网|电子商务"}}返回参数说明参数是否必填说明access_token是接口调用凭证primary_industry是帐号设置的主营行业secondary_industry是帐号设置的副营行业获得模板ID从行业模板库选择模板到帐号后台，获得模板ID的过程可在MP中完成。为方便第三方开发者，提供通过接口调用的方式来获取模板ID，具体如下：接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下：      {           "template_id_short":"TM00015"       }参数说明参数是否必须说明access_token是接口调用凭证template_id_short是模板库中模板的编号，有“TM**”和“OPENTMTM**”等形式返回码说明在调用模板消息接口后，会返回JSON数据包。正常时的返回JSON数据包示例：    {           "errcode":0,           "errmsg":"ok",           "template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"       }获取模板列表获取已添加至帐号下所有模板列表，可在MP中查看模板列表信息，为方便第三方开发者，提供通过接口调用的方式来获取帐号下所有模板信息，具体如下:接口调用请求说明http请求方式：GEThttps://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN参数说明参数是否必须说明access_token是接口调用凭证返回说明正确调用后的返回示例：{ "template_list": [{      "template_id": "iPk5sOIt5X_flOVKn5GrTFpncEYTojx6ddbt8WYoV5s",      "title": "领取奖金提醒",      "primary_industry": "IT科技",      "deputy_industry": "互联网|电子商务",      "content": "{ {result.DATA} }\n\n领奖金额:{ {withdrawMoney.DATA} }\n领奖  时间:{ {withdrawTime.DATA} }\n银行信息:{ {cardInfo.DATA} }\n到账时间:  { {arrivedTime.DATA} }\n{ {remark.DATA} }",      "example": "您已提交领奖申请\n\n领奖金额：xxxx元\n领奖时间：2013-10-10 12:22:22\n银行信息：xx银行(尾号xxxx)\n到账时间：预计xxxxxxx\n\n预计将于xxxx到达您的银行卡"   }]}返回参数说明参数是否必填说明access_token是接口调用凭证template_id是模板IDtitle是模板标题primary_industry是模板所属行业的一级行业deputy_industry是模板所属行业的二级行业content是模板内容example是模板示例删除模板删除模板可在MP中完成，为方便第三方开发者，提供通过接口调用的方式来删除某帐号下的模板，具体如下：接口调用请求说明http请求方式：POSThttps://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKENPOST数据说明如下： {     "template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE" }参数说明参数是否必须说明access_token是接口调用凭证template_id是公众帐号下模板消息ID返回说明在调用接口后，会返回JSON数据包。正常时的返回JSON数据包示例：{   "errcode" : 0,   "errmsg" : "ok"}发送模板消息接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/tem