# 订阅消息

# sendSubscriptionMessage

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

发送订阅消息

【注意】

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

# 请求地址

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

# 请求参数

属性 类型 默认值 必填 说明
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没有过期。

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

客服机器人