通知模板消息

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 模板需要放大的关键词,不填则默认无放大

返回值

Object

返回的 JSON 数据包

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

errcode 的合法值

说明
40014 token过期
40036 内部错误,参照msg返回信息确认问题
40037 template_id不正确,参照msg返回信息确认问题
41028 form_id不正确,或者过期,参照msg返回信息确认问题
41029 form_id已被使用
41030 对同一用户推送请求太快
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