功能介绍

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

• 订阅消息推送位置：服务通知
  

• 订阅消息下发条件：用户自主订阅
  

• 订阅消息卡片跳转能力：点击查看详情可跳转至该小程序的页面
  

消息类型

1. 一次性订阅消息

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

2. 长期订阅消息

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

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

发送订阅消息步骤：

1. 添加订阅消息模板，获取模板id

登录微信公众平台添加订阅消息模板，获取模板id.

​

2. 获取下发权限：

wx.requestSubscribeMessage(Object object)

__注意事项：__此部分代码需要按钮触发，不可放在onload()或onshow()中

 wx.requestSubscribeMessage({
      tmplIds: ['xxxxxxxxxxxxxxxxxxxxx'],//这里填写模板id
      success (res) {
        console.log("res--->",res)
       },
       fail:err=>{
         console.log("err---",err)
       }
    })

​

3. 调用接口下发订阅消息：

subscribeMessage.send

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

https调用请求地址：

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

 官网的请求参数如下：

​

必填参数说明

•  __access\_token ------接口调用凭证__
  

__注意事项：__获取接口凭证：auth.getAccessToken（发送消息需要access_token参数，access_token的有效期目前为 2 个小时，需定时刷新，重复获取将导致上次获取的 access_token失效）

 wx.request({
      url: 'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential',
      method: 'GET',
      data: {
        "appid": 'xxxxxx', //小程序appid
        "secret": 'xxxxxxx' //小程序密钥
      },
      success: res => {
        console.log("res--",res)
        this.data.accessToken=res.data.access_token
      },
      fail: (e) =>{
        console.error("err--",e);
      },
      complete: (e) =>{
        console.log("c--",e);
      }
    })

• data ------板内容，格式形如 { “key1”: { “value”: any }, “key2”: { “value”: any } }

  __注意事项：__发送消息的模板内容：key值要与模板中的一致

以下模板的data值： { “date1”: {“value”: “2020-01-01 00:00” },“date2”: {  “value”: “2020-01-01 00:00”}, “thing3”: { “value”: “升级期间暂停服务，感谢你的理解。” },“time4”: { “value”: “2020-01-01 17:38:26” } },

​

发送订阅消息代码

 wx.request({
      url: 'https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=' + this.data.accessToken,
      method: 'POST',
      data: {
        "touser": 'xxxxxxxxxx', //接收者（用户）的 openid
        "template_id": 'xxxxxxxxxx', //所需下发的订阅模板id
        "page": '/pages/index/index' || '', //点击模板卡片后的跳转页面
        "data": {
          "date1": {
            "value": "2020-01-01 00:00"
          },
          "date2": {
            "value": "2020-01-01 00:00"
          },
          "thing3": {
            "value": "升级期间暂停服务，感谢你的理解。"
          },
          "time4": {
            "value": "2020-01-01 17:38:26"
          }
        }, //模板内容，格式形如 { "key1": { "value": any }, "key2": { "value": any } }
        "miniprogram_state": "developer" //跳转小程序类型：developer为开发版；trial为体验版；formal为正式版；默认为正式版
      },
      success: (res) => {
        console.log(res.data);
      },
      fail: (e) => {
        console.errore);
      }
    })

 发送订阅消息成功，手机截图如下

​

以上就是微信订阅消息设置发送的全过程。