在线客服

全球共有40多个国家和地区5000多个平台,200万+商户使用

我要试用
文档中心 > 开放平台

模板消息接口

更新时间:2016/11/10

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

1. 设置所属行业

微信限制,每月可修改行业1次。

接口调用请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数是否必须说明
access_token调用接口凭证
ConnectKey开放平台KEY
apipath本接口固定为:template.api_set_industry
Data微信请求参数,为urlencode之后的JSON格式

Data参数JSON示例

{
  "industry_id1":"1",
  "industry_id2":"4"
}
参数是否必填说明
industry_id1公众号模板消息所属行业编号,参考本文附件
industry_id2公众号模板消息所属行业编号,参考本文附件

2. 获取设置的行业信息

接口调用请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数是否必须说明
access_token调用接口凭证
ConnectKey开放平台KEY
apipath本接口固定为:template.get_industry

返回说明

正确调用后的返回示例:

{
"primary_industry":{"first_class":"运输与仓储","second_class":"快递"},
"secondary_industry":{"first_class":"IT科技","second_class":"互联网|电子商务"}
}
参数说明
primary_industry帐号设置的主营行业
secondary_industry帐号设置的副营行业

3. 获得模板ID

接口调用请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数是否必须说明
access_token调用接口凭证
ConnectKey开放平台KEY
apipath本接口固定为:template.api_add_template

Data参数JSON示例

{
   "template_id_short":"TM00015"
}
参数是否必须说明
template_id_short模板库中模板的编号,有“TM”和“OPENTMTM”等形式

返回码说明

在调用模板消息接口后,会返回JSON数据包。正常时的返回JSON数据包示例:

{
   "errcode":0,
   "errmsg":"ok",
   "template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"
}

4. 获取模板列表

接口调用请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数是否必须说明
access_token调用接口凭证
ConnectKey开放平台KEY
apipath本接口固定为:template.get_all_private_template

返回说明

正确调用后的返回示例

{   
 "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到达您的银行卡"
   }]
}

5. 删除模板

接口调用请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数是否必须说明
access_token调用接口凭证
ConnectKey开放平台KEY
apipath本接口固定为:template.del_private_template

Data参数JSON示例

{
     "template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE"
}
参数是否必须说明
template_id公众帐号下模板消息ID

返回说明

在调用接口后,会返回JSON数据包。正常时的返回JSON数据包示例:

{
   "errcode" : 0,
   "errmsg" : "ok"
}

6. 发送模板消息

接口调用请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy
参数是否必须说明
access_token调用接口凭证
ConnectKey开放平台KEY
apipath本接口固定为:message.template.send
Data微信请求参数,为urlencode之后的JSON格式

Data参数JSON示例

{
   "touser":"OPENID",
   "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
   "url":"http://weixin.qq.com/download",            
   "data":{
           "first": {
               "value":"恭喜你购买成功!",
               "color":"#173177"
           },
           "keynote1":{
               "value":"巧克力",
               "color":"#173177"
           },
           "keynote2": {
               "value":"39.8元",
               "color":"#173177"
           },
           "keynote3": {
               "value":"2014年9月22日",
               "color":"#173177"
           },
           "remark":{
               "value":"欢迎再次购买!",
               "color":"#173177"
           }
   }
}
参数是否必填说明
touser接收者openid
template_id模板ID
url模板跳转链接
data模板数据

返回说明

在调用模板消息接口后,会返回JSON数据包。正常时的返回JSON数据包示例:

{
   "errcode":0,
   "errmsg":"ok",
   "msgid":200228332
}

Note1:行业编号查询

主行业副行业代码
IT科技互联网/电子商务1
IT科技IT软件与服务2
IT科技IT硬件与设备3
IT科技电子技术4
IT科技通信与运营商5
IT科技网络游戏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
合肥彼岸互联信息技术有限公司  合肥市高新区亚夏汽车大厦17楼
工信部备案号: 皖B2-20150071-4  增值电信业务经营许可证:皖B2-20150071-4 安全联盟认证
友情链接: o2o生活通系统 微分销系统 兄弟连教育 火车采集器 加速乐 站长团购 后盾IT教育 php A5创业网 微信H5游戏营销