sendTemplateMessage

解释：推送模板消息。

百度 APP 中扫码体验：

扫码体验

代码示例

百度智能小程序

请使用百度APP扫码

接口调用请求说明：请提前在开发者平台创建消息模板。用application/x-www-form-urlencoded方式提交数据。

  1. POST https://openapi.baidu.com/rest/2.0/smartapp/template/send?access_token=ACCESS_TOKEN

名词解释：

  • open_id：百度用户登录唯一标识，详见开放接口-登录。
  • formId：页面内 form 组件的report-submit属性为 true 时返回 formId ，详见 form 表单。

公共请求参数：

参数名类型是否必须描述
access_tokenString是access_token ，授权小程序的接口调用凭据。

请求参数：

参数名类型是否必须描述
template_idString是小程序模板 ID
touser_openIdString是接收者 open_id 参数不能为空
dataJSON/String是发送消息内容。示例：{“keyword1”: {“value”: “2018-09-06”},”keyword2”: {“value”: “kfc”}}
pageString否点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数，（示例 index?foo=bar），该字段不填则模板无跳转
scene_idString是场景 id ，例如表单 Id、orderId、payId 。
scene_typeInt是场景 type 。1：表单；2：百度收银台订单；3：直连订单

请求参数

  1. curl -X POST \
  2.   'https://openapi.baidu.com/rest/2.0/smartapp/template/send?access_token=24.aa3e739a42764887a55bba3ec89a11dd.2592000.1617263180.282335-11182003
  3.   &scene_id=13.8b89e828fef3825dd6b87bbda74a6ce4.798979.1614671803.1&scene_type=1
  4.   &template_id=84001b219e1940a8b4df49db911a1fb1&touser_openId=36GetTsw0nWRMVaYnlswLQ9t7y&data=${data}'

返回示例

  1. {
  2.     "errno":0,
  3.     "msg":"success",
  4.     "data":{
  5.         "msg_key":4330862
  6.     }
  7. }

Q&A

  1. 消息发送失败可能的原因？

  • 发送消息时用到的touser_openid 必须和申请 scene_id 时的touser_openid 一一对应， 否则也会导致 scene_id 检验失败；

  • 如果通过上面的查验仍然发送消息失败，请检查 appkey 是否异常。

  1. 怎么判断当前用户是游客状态还是登录状态？
  1. 如何获取 open_id ？
  • 获取 open_id：详见登录文档中获取登录用户 OpenId 相关内容。

错误码

错误码说明
2002参数错误
4001template_id 不正确。
4002消息推送接口调用失败。
4003表单无效。
4004场景 id 无效。
6001无 push 权限。