微信小程序模板消息定点推送开发流程

  • 管理员登录查看小程序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"

}

推送的模板格式须管理员在已有的模板中挑选或申请模板。

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