微信小程序統(tǒng)一服務(wù)消息下發(fā)接口

日期：2018-09-12　作者：管理員　來源：本站

微信小程序統(tǒng)一服務(wù)消息下發(fā)接口是為了便于開發(fā)者對用戶進(jìn)行服務(wù)消息觸達(dá)【小程序接口定制電話】簡化小程序和公眾號模板消息下發(fā)流程，小程序提供統(tǒng)一的服務(wù)消息下發(fā)接口，簡化了微信小程序模板消息下發(fā)流程，小程序模板消息相關(guān)的信息，可以參考小程序模板消息接口；有此節(jié)點則優(yōu)先發(fā)送小程序模板消息。

微信小程序統(tǒng)一服務(wù)消息下發(fā)接口

統(tǒng)一服務(wù)消息下發(fā)接口

為便于開發(fā)者對用戶進(jìn)行服務(wù)消息觸達(dá)，簡化小程序和公眾號模板消息下發(fā)流程，小程序提供統(tǒng)一的服務(wù)消息下發(fā)接口。

接口地址

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":"北京市朝陽區(qū)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" }
        }
    }
}

參數(shù)說明

參數(shù)	說明
access_token	小程序的access_token
touser	用戶openid，可以是小程序的openid，也可以是mp_template_msg.appid對應(yīng)的公眾號的openid
weapp_template_msg	小程序模板消息相關(guān)的信息，可以參考小程序模板消息接口;有此節(jié)點則優(yōu)先發(fā)送小程序模板消息
weapp_template_msg.template_id	小程序模板ID
weapp_template_msg.page	小程序頁面路徑
weapp_template_msg.form_id	小程序模板消息formid
weapp_template_msg.data	小程序模板數(shù)據(jù)
weapp_template_msg.emphasis_keyword	小程序模板放大關(guān)鍵詞
mp_template_msg	公眾號模板消息相關(guān)的信息，可以參考公眾號模板消息接口；有此節(jié)點并且沒有weapp_template_msg節(jié)點時，發(fā)送公眾號模板消息
mp_template_msg.appid	公眾號appid，要求與小程序有綁定且同主體
mp_template_msg.template_id	公眾號模板id
mp_template_msg.url	公眾號模板消息所要跳轉(zhuǎn)的url
mp_template_msg.miniprogram	公眾號模板消息所要跳轉(zhuǎn)的小程序，小程序的必須與公眾號具有綁定關(guān)系
mp_template_msg.data	公眾號模板消息的數(shù)據(jù)

在調(diào)用接口后，會返回JSON數(shù)據(jù)包正常時的返回JSON數(shù)據(jù)包示例：

{ "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	接口調(diào)用超過限額
40003	touser 不是正確的openid
40013	appid不正確，或者不符合綁定關(guān)系要求