微信小程序订阅消息使用

微信订阅消息使用（自己摸索的：可能有错误）

🍬先来看看订阅消息的介绍叭！

功能介绍

消息能力是小程序能力中的重要组成，我们为开发者提供了订阅消息能力，以便实现服务的闭环和更优的体验。

• 订阅消息推送位置：服务通知
• 订阅消息下发条件：用户自主订阅
• 订阅消息卡片跳转能力：点击查看详情可跳转至该小程序的页面

消息类型

1. 一次性订阅消息

一次性订阅消息用于解决用户使用小程序后，后续服务环节的通知问题。用户自主订阅后，开发者可不限时间地下发一条对应的服务消息；每条消息可单独订阅或退订。

2. 长期订阅消息

一次性订阅消息可满足小程序的大部分服务场景需求，但线下公共服务领域存在一次性订阅无法满足的场景，如航班延误，需根据航班实时动态来多次发送消息提醒。为便于服务，我们提供了长期性订阅消息，用户订阅一次后，开发者可长期下发多条消息。

目前长期性订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，后期将逐步支持到其他线下公共服务业务。

3. 设备订阅消息

设备订阅消息是一种特殊类型的订阅消息，它属于长期订阅消息类型，且需要完成「设备接入」才能使用。

设备订阅消息用于在设备触发某些需要人工介入的事件时（例如设备发生故障、设备耗材不足等），向用户发送消息通知。详见设备订阅消息文档

🍬按照官方给的步骤开始操作

步骤一：获取模板 ID

在微信公众平台手动配置获取模板 ID：
登录 https://mp.weixin.qq.com 获取模板，如果没有合适的模板，可以申请添加新模板，审核通过后可使用。

步骤二：获取下发权限

一次性订阅消息、长期订阅消息，详见接口 wx.requestSubscribeMessage

设备订阅消息，详见接口 wx.requestSubscribeDeviceMessage

步骤三：调用接口下发订阅消息

一次性订阅消息、长期订阅消息，详见服务端接口 subscribeMessage.send

设备订阅消息，详见服务端接口 hardwareDevice.send

注意事项

• 用户勾选 “总是保持以上选择，不再询问” 之后，下次订阅调用 wx.requestSubscribeMessage 不会弹窗，保持之前的选择，修改选择需要打开小程序设置进行修改

🍬来看看我的使用过程叭

1.获取模板ID

​ 就是它了（这里需要自己在微信公众平台配置订阅消息模板并查看模板ID）

2.获取权限

具体的参数以及回调我就不在写了，开发文档里有，具体调用如下：

wx.requestSubscribeMessage({
  tmplIds: [''],
  success (res) { }
})

这里填入自己的tmplIds即可，调用成功后可以在回调函数的参数对象中查看，接口调用成功时 errMsg 值为’requestSubscribeMessage:ok’

3.调用接口发送订阅消息

所调用的接口为：subscribeMessage.send

这里我使用的是HTTPS调用方式

请求地址：POST https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN

请求示例：

{
  "touser": "OPENID",
  "template_id": "TEMPLATE_ID",
  "page": "index",
  "miniprogram_state":"developer",
  "lang":"zh_CN",
  "data": {
      "number01": {
          "value": "339208499"
      },
      "date01": {
          "value": "2015年01月05日"
      },
      "site01": {
          "value": "TIT创意园"
      } ,
      "site02": {
          "value": "广州市新港中路397号"
      }
  }
}

请求参数：

属性	类型	默认值	必填	说明
access_token / cloudbase_access_token	string		是	接口调用凭证
touser	string		是	接收者（用户）的 openid
template_id	string		是	所需下发的订阅模板id
page	string		否	点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
data	Object		是	模板内容，格式形如 { “key1”: { “value”: any }, “key2”: { “value”: any } }
miniprogram_state	string		否	跳转小程序类型：developer为开发版；trial为体验版；formal为正式版；默认为正式版
lang	string		否	进入小程序查看”的语言类型，支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文)，默认为zh_CN

这里有四个必填项：access_token、touser、template_id、data

access_token

调用接口：auth.getAccessToken，获取小程序全局唯一后台接口调用凭据（access_token）

请求地址：GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

请求参数：

属性	类型	默认值	必填	说明
grant_type	string		是	填写 client_credential
appid	string		是	小程序唯一凭证，即 AppID，可在「微信公众平台 - 设置 - 开发设置」页中获得。（需要已经成为开发者，且帐号没有异常状态）
secret	string		是	小程序唯一凭证密钥，即 AppSecret，获取方式同 appid

这两个参数在这呢

{
	"appid":AppID,
	"secret":AppSecret
}

返回数据示例

正常返回将会获得token值

错误时返回

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

touser

接收者（用户）的 openid

调用接口：auth.code2Session

1. 调用 wx.login() 获取 临时登录凭证code ，并回传到开发者服务器。
2. 调用 auth.code2Session 接口，换取 用户唯一标识 OpenID 、 用户在微信开放平台帐号下的唯一标识UnionID（若当前小程序已绑定到微信开放平台帐号） 和 会话密钥 session_key。

请求地址：GET https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code

请求参数：

属性	类型	默认值	必填	说明
appid	string		是	小程序 appId
secret	string		是	小程序 appSecret
js_code	string		是	登录时获取的 code
grant_type	string		是	授权类型，此处只需填写 authorization_code

{
	"appid":AppID,
	"secret":AppSecret,
    "js_code":登录时的code,
    "grant_type":"authorization_code"
}

返回值

Object

返回的 JSON 数据包

属性	类型	说明
openid	string	用户唯一标识
session_key	string	会话密钥
unionid	string	用户在开放平台的唯一标识符，若当前小程序已绑定到微信开放平台帐号下会返回，详见 UnionID 机制说明。
errcode	number	错误码
errmsg	string	错误信息

这样就可以获得openid

template_id

第一步就已经获取过了，就直接下一个参数吧

data

"data": {
      "date1": {
          "value": "2028年06月01日"
      },
      "thing2": {
          "value": "洛阳市涧西区西苑路新友谊大酒店"
      },
      "thing3": {
          "value": "婚礼即将如期举行，请您提前做好出行计划"
      } ,
      "thing4": {
          "value": "张草原"
      } ,
      "thing5": {
          "value": "张凯、唐莹"
      }
  }

经过上述步骤，所有的参数都已经获取了，接下来就可以发送请求进行测试了

🍬使用postMan进行简单测试

1. 获取openid(填入相关参数)

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

2. 发送订阅消息

• 请求接口
  https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=access_token

在此网站获取测试的access_token
https://mp.weixin.qq.com/debug/cgi-bin/apiinfo?t=index&type=%E5%9F%BA%E7%A1%80%E6%94%AF%E6%8C%81&form=%E8%8E%B7%E5%8F%96access_token%E6%8E%A5%E5%8F%A3%20/token

• 请求参数

{
  "touser": "openid",
  "template_id": "template_id",
  "data": {
      "date1": {
          "value": "2028年06月01日"
      },
      "thing2": {
          "value": "洛阳市涧西区西苑路新友谊大酒店"
      },
      "thing3": {
          "value": "婚礼即将如期举行，请您提前做好出行计划"
      } ,
      "thing4": {
          "value": "某某某"
      } ,
      "thing5": {
          "value": "张某、李某"
      }
  }
}

传入正确的参数就可以成功的发送订阅消息了