• sendTemplateMessage
  • 请求参数
  • 返回示例
  • Q&A
  • 错误码

sendTemplateMessage

解释：推送模板消息。

创新互联建站专业提供成都主机托管四川主机托管成都服务器托管四川服务器托管，支持按月付款！我们的承诺：贵族品质、平民价格，机房位于中国电信/网通/移动机房，绵阳机房托管服务有保障！

百度 APP 中扫码体验：

扫码体验

代码示例

请使用百度APP扫码

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

 
 
 

  
  
  
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_token	String	是	access_token ，授权小程序的接口调用凭据。

请求参数：

参数名	类型	是否必须	描述
template_id	String	是	小程序模板 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：直连订单

请求参数

 
 
 

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

返回示例

 
 
 

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

Q&A

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

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

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

1. 怎么判断当前用户是游客状态还是登录状态？

• 通过 swan.isLoginSync API 可以判断当前用户是否为登录状态。

1. 如何获取 open_id ？

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

错误码

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

分享名称：创新互联百度小程序教程：sendTemplateMessage
网址分享：http://cdbrznjsb.com/article/dpcjojp.html