模板消息

模板消息

sendTemplateMessage

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

发送模板消息

请求地址

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

请求参数

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

返回值

Object

返回的 JSON 数据包

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

errcode 的合法值

值	说明
40037	template_id不正确
41028	form_id不正确，或者过期
41029	form_id已被使用
41030	page不正确
45009	接口调用超过限额（目前默认每个帐号日调用限额为100万）

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"
}

返回数据示例

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