微信小程序統一服務消息下發接口
日期:2018-09-12 作者:管理員 來源:本站
微信小程序統一服務消息下發接口是為了便于開發者對用戶進行服務消息觸達【小程序接口定制電話】簡化小程序和公眾號模板消息下發流程,小程序提供統一的服務消息下發接口,簡化了微信小程序模板消息下發流程,小程序模板消息相關的信息,可以參考小程序模板消息接口;有此節點則優先發送小程序模板消息。
微信小程序統一服務消息下發接口
統一服務消息下發接口
為便于開發者對用戶進行服務消息觸達,簡化小程序和公眾號模板消息下發流程,小程序提供統一的服務消息下發接口。
接口地址
https://api.weixin.qq.com/cgi-bin/message/wxopen/template/uniform_send?access_token=ACCESS_TOKEN
HTTP請求方式
POST
示例
{ "touser":"OPENID", "weapp_template_msg":{ "template_id":"TEMPLATE_ID", "page":"page/page/index", "form_id":"FORMID", "data":{ "keyword1":{ "value":"339208499" }, "keyword2":{ "value":"2018年09月12日 10:56" }, "keyword3":{ "value":"壹加壹連鎖酒店" }, "keyword4":{ "value":"北京市朝陽區151號" } }, "emphasis_keyword":"keyword1.DATA" }, "mp_template_msg":{ "appid":"APPID ", "template_id":"TEMPLATE_ID", "url":"http://weixin.qq.com/download", "miniprogram":{ "appid":"xiaochengxuappid12345", "pagepath":"index?foo=bar" }, "data":{ "first":{ "value":"恭喜你購買成功!", "color":"#173177" }, "keyword1":{ "value":"巧克力", "color":"#173177" }, "keyword2":{ "value":"360元", "color":"#173177" }, "keyword3":{ "value":"2018年9月12日", "color":"#173177" }, "remark":{ "value":"歡迎再次購買!", "color":"#173177" } } } }
參數說明
參數 | 說明 |
---|---|
access_token | 小程序的access_token |
touser | 用戶openid,可以是小程序的openid,也可以是mp_template_msg.appid對應的公眾號的openid |
weapp_template_msg | 小程序模板消息相關的信息,可以參考小程序模板消息接口;有此節點則優先發送小程序模板消息 |
weapp_template_msg.template_id | 小程序模板ID |
weapp_template_msg.page | 小程序頁面路徑 |
weapp_template_msg.form_id | 小程序模板消息formid |
weapp_template_msg.data | 小程序模板數據 |
weapp_template_msg.emphasis_keyword | 小程序模板放大關鍵詞 |
mp_template_msg | 公眾號模板消息相關的信息,可以參考公眾號模板消息接口;有此節點并且沒有weapp_template_msg節點時,發送公眾號模板消息 |
mp_template_msg.appid | 公眾號appid,要求與小程序有綁定且同主體 |
mp_template_msg.template_id | 公眾號模板id |
mp_template_msg.url | 公眾號模板消息所要跳轉的url |
mp_template_msg.miniprogram | 公眾號模板消息所要跳轉的小程序,小程序的必須與公眾號具有綁定關系 |
mp_template_msg.data | 公眾號模板消息的數據 |
在調用接口后,會返回JSON數據包 正常時的返回JSON數據包示例:
{ "errcode": 0, "errmsg": "ok" }
返回碼說明
返回碼 | 說明 |
---|---|
40037 | 模板id不正確,weapp_template_msg.template_id 或者 mp_template_msg.template_id |
41028 | weapp_template_msg.form_id 過期或者不正確 |
41029 | weapp_template_msg.form_id已被使用 |
41030 | weapp_template_msg.page 不正確 |
45009 | 接口調用超過限額 |
40003 | touser 不是正確的openid |
40013 | appid不正確,或者不符合綁定關系要求 |
掃二維碼手機查看該文章