百度智能小程序 推送模板消息

2020-09-05 14:47 更新

sendTemplateMessage


解釋:推送模板消息


接口調(diào)用請(qǐng)求說明:請(qǐng)?zhí)崆霸陂_發(fā)者平臺(tái)創(chuàng)建消息模板。用application/x-www-form-urlencoded方式提交數(shù)據(jù)。

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

名詞解釋:

  • swan_id:百度生成的與設(shè)備相關(guān)的唯一標(biāo)識(shí),APP 卸載重安裝不會(huì)變,詳見 swanid 機(jī)制說明。
  • open_id:百度用戶登錄唯一標(biāo)識(shí),詳見開放接口-登錄。
  • formId:頁(yè)面內(nèi) form 組件的report-submit屬性為 true 時(shí)返回 formid ,詳見 form 表單。

公共請(qǐng)求參數(shù):

參數(shù)名類型是否必須描述
access_tokenstringaccess_token ,授權(quán)小程序的接口調(diào)用憑據(jù)。

請(qǐng)求參數(shù):

參數(shù)名類型是否必須描述
template_idstring所需下發(fā)的模板消息的 id 。
touserstring接收者 swan_id (touser touser_openId兩個(gè)參數(shù)不能都為空)
touser_openIdstring接收者 open_id (touser touser_openId兩個(gè)參數(shù)不能都為空)
datajson/string{"keyword1": {"value": "2018-09-06"},"keyword2": {"value": "kfc"}}。
pagestring點(diǎn)擊模板卡片后的跳轉(zhuǎn)頁(yè)面,僅限本小程序內(nèi)的頁(yè)面。支持帶參數(shù),(示例 index?foo=bar),該字段不填則模板無跳轉(zhuǎn)。
scene_idstring場(chǎng)景 id ,例如表單 Id 、 orderId 或 payId 。
scene_typeint場(chǎng)景 type ,1:表單;2:百度收銀臺(tái)訂單;3:直連訂單。
extjson/string{"xzh_id":111,"category_id":15}。

Q&A

  1. 消息發(fā)送失敗可能的原因?
  • 發(fā)送消息時(shí)用到的 touser/touser_openid 必須和申請(qǐng) scene_id 時(shí)的 touser/touser_openid 一一對(duì)應(yīng), 否則也會(huì)導(dǎo)致 scene_id 檢驗(yàn)失??;
  • 如果通過上面的查驗(yàn)仍然發(fā)送消息失敗,請(qǐng)檢查 appkey 是否異常。
  1. 怎么判斷當(dāng)前用戶是游客狀態(tài)還是登錄狀態(tài)?
  • 通過 swan.isLoginSync API 可以判斷當(dāng)前用戶是否為登錄狀態(tài)。
  1. 如何獲取 swan_id & open_id ?
  • 獲取 swan_id:詳見 swan.getSwanId ;
  • 獲取 open_id:詳見登錄文檔中獲取登錄用戶 OpenId 相關(guān)內(nèi)容。

錯(cuò)誤碼

錯(cuò)誤碼說明
2002參數(shù)錯(cuò)誤
4001template_id 不正確。
4002消息推送接口調(diào)用失敗。
4003表單無效。
4004場(chǎng)景 id 無效。
6001無 push 權(quán)限。

返回示例

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


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)