微信小程序模板消息定點推送開發流程

  • 管理員登錄查看小程序APPID及祕鑰,調用wx.login() 方法獲取code備用。

 

  • 獲取用戶openid接口地址:

https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code

參數說明如下:

appid

小程序唯一標識

secret

小程序的 app secret

js_code

登錄時獲取的 code

grant_type

填寫爲 authorization_code

 

 

 

 

 

返回及說明:

在不滿足UnionID下發條件的情況下,返回參數:

openid

用戶唯一標識

session_key

會話密鑰

 

 

 

在滿足UnionID下發條件的情況下,返回參數:

openid

用戶唯一標識

session_key

會話密鑰

unionid

用戶在開放平臺的唯一標識符

 

 

 

 

Unionid說明:

https://developers.weixin.qq.com/miniprogram/dev/api/unionID.html

 

  • 獲取access_token接口地址:

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

HTTP請求方式: GET

參數說明 :

參數

必填

說明

grant_type

獲取 access_token 填寫 client_credential

appid

第三方用戶唯一憑證

secret

第三方用戶唯一憑證密鑰,即appsecret

 

 

 

 

 

返回參數說明:

正常情況下,微信會返回下述 JSON 數據包給開發者:

{"access_token": "ACCESS_TOKEN", "expires_in": 7200}

access_token

獲取到的憑證

expires_in

憑證有效時間,單位:秒

 

 

 

錯誤時微信會返回錯誤碼等信息,JSON 數據包示例如下(該示例爲 AppID 無效錯誤):

{"errcode": 40013, "errmsg": "invalid appid"}

 

獲取access_token備用。

 

  • 發送模板消息接口地址:

https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN

HTTP請求方式:post

POST參數說明:

參數

必填

說明

touser

接收者(用戶)的 openid

template_id

所需下發的模板消息的id

page

點擊模板卡片後的跳轉頁面,僅限本小程序內的頁面。支持帶參數,(示例index?foo=bar)。該字段不填則模板無跳轉。

form_id

表單提交場景下,爲 submit 事件帶上的 formId;支付場景下,爲本次支付的 prepay_id

data

模板內容,不填則下發空模板

color

模板內容字體的顏色,不填默認黑色 【廢棄】

emphasis_keyword

模板需要放大的關鍵詞,不填則默認無放大

 

 

 

 

 

 

 

 

 

 

 

返回碼說明:

在調用模板消息接口後,會返回JSON數據包。

正常時的返回JSON數據包示例:

{

  "errcode": 0,

  "errmsg": "ok"

}

錯誤時會返回錯誤碼信息,說明如下:

返回碼

說明

40037

template_id不正確

41028

form_id不正確,或者過期

41029

form_id已被使用

41030

page不正確

45009

接口調用超過限額(目前默認每個帳號日調用限額爲100萬)

 

 

 

 

 

 

 

例:

{

  "touser": "OPENID",

  "template_id": "TEMPLATE_ID",

  "page": "index",

  "form_id": "FORMID",

  "data": {

      "keyword1": {

          "value": "339208499"

      },

      "keyword2": {

          "value": "2015年01月05日 12:30"

      },

      "keyword3": {

          "value": "粵海喜來登酒店"

      } ,

      "keyword4": {

          "value": "廣州市天河區天河路208號"

      }

  },

  "emphasis_keyword": "keyword1.DATA"

}

推送的模板格式須管理員在已有的模板中挑選或申請模板。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章