sendTemplateMessage

解释:推送模板消息

百度 APP 中扫码体验

扫码体验
重新加载
请使用百度APP扫码

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

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

名词解释

  • swan_id:百度生成的与设备相关的唯一标识,APP 卸载重安装不会变,详见 swanid 机制说明
  • open_id:百度用户登录唯一标识,详见 开放接口-登录
  • formId:页面内 form 组件的report-submit属性为 true 时返回 formid,详见 form 表单

公共请求参数

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

请求参数

参数名 类型 是否必须 描述
template_id string 所需下发的模板消息的 id
touser string 接收者 swan_id
touser_openId string 接收者 open_id
data json/string {"keyword1": {"value": "2018-09-06"},"keyword2": {"value": "kfc"}}
page string 点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例 index?foo=bar),该字段不填则模板无跳转。
scene_id string 场景 id,例如表单 Id、 orderId 或 payId
scene_type int 场景 type,1:表单;2:百度收银台订单;3:直连订单
ext json/string {"xzh_id":111,"category_id":15}

# Q&A

  1. 消息发送失败可能的原因?
  • 发送消息时用到的 touser/touser_openid 必须和申请 scene_id 时的 touser/touser_openid 一一对应, 否则也会导致 scene_id 检验失败

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

  1. 怎么判断当前用户是游客状态还是 登录状态?
  1. 如何获取 swan_id & open_id?
  • 获取 swan_id:详见 swan.getSwanId

  • 获取 open_id:详见 登录 文档中获取登录用户 OpenId 相关内容

# 错误码

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

# 返回示例

    {
        "errno":0,
        "msg":"success",
        "data":{
            "msg_key":4330862
        }
    }