本接口应在后端服务器调用,详细说明参见后端API。
发送模板消息
【注意】 原模板消息接口已全部停用,开发者管理端入口已下线,模板消息相关接口调用失败,请改为使用一次性订阅消息进行消息通知。
POST https://api.q.qq.com/api/json/template/send?access_token=ACCESS_TOKEN
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
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 |
返回的 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 | 联系对接同学 |
{
"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"
}
请检查是否填入url的query中,并确保token没有过期。