# 订阅消息-后端API

# sendSubscriptionMessage

本接口应在后端服务器调用，详细说明参见后端API。

发送订阅消息

【注意】

长期订阅消息，调整为累计dau大于20w的产品自动开放。达到要求后，即可在开发者管理端看到开通入口【消息- 模板-订阅消息-长期订阅】。
对于已经停用的长期订阅模板，管理端已经进行了标红提示，请从模板库中重新选择合适的模板使用。
长期订阅消息的登录有效期为一周，如果用户连续一周未登陆小程序则授权自动关闭，开发者在下发订阅消息时，会收到错误码46006；为保证消息可正常下发，建议开发者在小程序内对连续7天未活跃的用户或者接收到错误码的用户进行引导，让用户在设置内重新打开授权开关。

# 请求地址

POST https://api.q.qq.com/api/json/subscribe/SendSubscriptionMessage?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
touser	string	是	接收者（用户）的 openid
template_id	string	是	所需下发的订阅消息的模板id
page	string	否	点击订阅消息卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
data	Object	否	模板内容，要求字段数量和模板本身的字段数量一致。具体格式请参考示例。
emphasis_keyword	string	否	模板需要放大的关键词，不填则默认无放大。
oac_appid	string	否	若希望通过小程序绑定的公众号下发，则在该字段填入公众号的 appid
use_robot	number	否	若希望通过客服机器人下发，则在该字段填1

# 返回值

# Object

返回的 JSON 数据包

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息

errcode 的合法值

值	说明
40037	template_id不正确
40014	token过期
40015	oac_appid不正确
40035	参数错误，请确认申请模块的参数和下发消息时传的参数是否一致
40036	内部错误，参照msg返回信息确认问题
40037	template_id不正确，参照msg返回信息确认问题
41030	对同一用户推送请求太快
46001	用户未订阅
46002	当日超过推送限额
46003	用户拒收
46004	用户未关注公众号
46005	公众号未绑定小程序/小游戏
46006	用户已订阅，但是一周未打开小程序，导致订阅状态失效，需重新引导用户订阅
47001	小程序/小游戏被禁止发送消息
47002	机器人否用户好友
47003	该小程序未绑定机器人
other	联系对接同学

# POST 数据格式：JSON

# 请求数据示例

{
  "touser": "OPENID",
  "template_id": "TEMPLATE_ID",
  "page": "index",
  "data": {
    "keyword1": {
      "value": "339208499"
    },
    "keyword2": {
      "value": "2019年5月05日 12:30"
    },
    "keyword3": {
      "value": "腾讯大厦"
    },
    "keyword4": {
      "value": "深圳市南山区高新科技园中区一路"
    }
  },
  "emphasis_keyword": "keyword1.DATA"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 返回数据示例

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

1
2
3
4

# FAQ

# 公众号如何绑定小程序

见私域流量运营

# 为什么我填了 access_token 仍然报错

请检查是否填入url的query中，并确保token没有过期。

# 小程序如何绑定客服机器人

见客服机器人

← 获取小程序码接入 QQ 频道 →