# 通知模板消息-后端API

# sendTemplateMessage

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

发送模板消息

【注意】 原模板消息接口已全部停用,开发者管理端入口已下线,模板消息相关接口调用失败,请改为使用一次性订阅消息进行消息通知。

# 请求地址

POST https://api.q.qq.com/api/json/template/send?access_token=ACCESS_TOKEN
1

# 请求参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
appid string 小程序 appId
touser string 接收者(用户)的 openid
template_id string 所需下发的模板消息的id
page string 点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例page/index/index?foo=bar)。该字段不填则模板无跳转。
form_id string 表单提交场景下,为 submit 事件带上的 formId;支付场景下,为本次支付的 prepay_id; 小游戏场景下可以通过后台统一服务消息接收formid。
data Object 模板内容,要求字段数量和模板本身的字段数量一致。具体格式请参考示例。
emphasis_keyword string 模板需要放大的关键词,不填则默认无放大
oac_appid string 若希望通过小程序绑定的公众号下发,则在该字段填入公众号的 appid

# 返回值

# Object

返回的 JSON 数据包

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

errcode 的合法值

说明
40014 token过期
40015 oac_appid不正确
40035 参数错误,请确认申请模块的参数和下发消息时传的参数是否一致
40036 内部错误,参照msg返回信息确认问题
40037 template_id不正确,参照msg返回信息确认问题
41028 form_id不正确,或者过期,参照msg返回信息确认问题
41029 form_id已被使用
41030 对同一用户推送请求太快
46003 用户拒收
46004 用户未关注公众号
46005 公众号未绑定小程序/小游戏
47001 小程序/小游戏被禁止发送消息
other 联系对接同学

# POST 数据格式:JSON

# 请求数据示例

{
  "touser": "OPENID",
  "template_id": "TEMPLATE_ID",
  "page": "index",
  "form_id": "FORMID",
  "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
21

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok"
}
1
2
3
4

# FAQ

# 公众号如何绑定小程序

私域流量运营

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

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