一次性订阅消息


上一篇 : 模板消息接口 下一篇: 模板消息运营规范



开发者可以通过一次性订阅消息授权让微信用户授权第三方移动应用(接入说明)或公众号,获得发送一次订阅消息给到授权微信用户的机会。授权微信用户可以不需要关注公众号。微信用户每授权一次,开发者可获得一次下发消息的权限。(注意:同一用户在同一scene场景值下的多次授权不累积下发权限,只能下发一条。若要订阅多条,需要不同scene场景值)

消息下发位置说明:对于已关注公众号的,消息将下发到公众号会话里;未关注公众号的,将下发到服务通知。

公众号或网页使用一次性订阅消息流程如下:

第一步:需要用户同意授权,获取一次给用户推送一条订阅模板消息的机会

在确保微信公众帐号拥有订阅消息授权的权限的前提下(已认证的公众号即有权限,可登陆公众平台在接口权限列表处查看),引导用户在微信客户端打开如下链接:

https://mp.weixin.qq.com/mp/subscribemsg?action=get_confirm&appid=wxaba38c7f163da69b&scene=1000&template_id=1uDxHNXwYQfBmXOfPJcjAS3FynHArD8aWMEFNRGSbCc&redirect_url=http%3a%2f%2fsupport.qq.com&reserved=test#wechat_redirect

参数说明

参数 是否必须 说明
action 直接填get_confirm即可
appid 公众号的唯一标识
scene 重定向后会带上scene参数,开发者可以填0-10000的整形值,用来标识订阅场景值
template_id 订阅消息模板ID,登录公众平台后台,在接口权限列表处可查看订阅模板ID
redirect_url 授权后重定向的回调地址,请使用UrlEncode对链接进行处理。 注:要求redirect_url的域名要跟登记的业务域名一致,且业务域名不能带路径。 业务域名需登录公众号,在设置-公众号设置-功能设置里面对业务域名设置。
reserved 用于保持请求和回调的状态,授权请后原样带回给第三方。该参数可用于防止csrf攻击(跨站请求伪造攻击),建议第三方带上该参数,可设置为简单的随机数加session进行校验,开发者可以填写a-zA-Z0-9的参数值,最多128字节,要求做urlencode
#wechat_redirect 无论直接打开还是做页面302重定向时,必须带此参数

用户同意或取消授权后会返回相关信息

如果用户点击同意或取消授权,页面将跳转至:

redirect_url/?openid=OPENID&template_id=TEMPLATE_ID&action=ACTION&scene=SCENE

参数说明

参数 说明
openid 用户唯一标识,只在用户确认授权时才会带上
template_id 订阅消息模板ID
action 用户点击动作,”confirm”代表用户确认授权,”cancel”代表用户取消授权
scene 订阅场景值
reserved 请求带入原样返回

第二步:通过API推送订阅模板消息给到授权微信用户

接口请求说明

http请求方式: post

https://api.weixin.qq.com/cgi-bin/message/template/subscribe?access_token=ACCESS_TOKEN

post数据示例

{
“touser”:”OPENID”,
“template_id”:”TEMPLATE_ID”,
“url”:”URL”,
“miniprogram”:{
“appid”:“xiaochengxuappid12345”,
“pagepath”:“index?foo=bar”    
},
“scene”:”SCENE”,
“title”:”TITLE”,
“data”:{
“content”:{
“value”:”VALUE”,
“color”:”COLOR”
}
}
}

参数说明

参数 是否必须 说明
touser 填接收消息的用户openid
template_id 订阅消息模板ID
url 点击消息跳转的链接,需要有ICP备案
miniprogram 跳小程序所需数据,不需跳小程序可不用传该数据
appid 所需跳转到的小程序appid(该小程序appid必须与发模板消息的公众号是绑定关联关系,并且小程序要求是已发布的)
pagepath 所需跳转到小程序的具体页面路径,支持带参数,(示例index?foo=bar)
scene 订阅场景值
title 消息标题,15字以内
data 消息正文,value为消息内容文本(200字以内),没有固定格式,可用\n换行,color为整段消息内容的字体颜色(目前仅支持整段消息为一种颜色)

注:url和miniprogram都是非必填字段,若都不传则模板无跳转;若都传,会优先跳转至小程序。开发者可根据实际需要选择其中一种跳转方式即可。当用户的微信客户端版本不支持跳小程序时,将会跳转至url。

返回说明

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

{
“errcode”:0,
“errmsg”:”ok”
}


上一篇 : 模板消息接口 下一篇: 模板消息运营规范