Focus on FE learning

这几天在使用小程序的模板消息推送接口的时候，出现了个报错信息 “the formId is no longer available in develop or trial version”，去文档查看了一下才发现，模板消息功能在今年1月份已经下架了，现在统一都是使用订阅消息：

那么这两个功能有什么区别呢？

模板消息推送

简单地说，用户每进行一次提交表单或是支付行为，都会产生一个 formId，开发者可以通过这个 formId 向用户推送消息。由于下发权限是在开发者这边，为了防止消息频繁推送对用户造成的骚扰，小程序做出了一个限制：一个 formId 只有 7 天有效期，每推送一次消息会消耗一个 formId，也就是说，正常情况下，开发者 7 天内可以推送的消息数量是有限的。这样当然对用户是友好的，但是对开发者来说，有些业务场景又确实推送多条消息：比如说 A 用户发布一个二手商品，B 用户点击了“感兴趣”，需要推送消息告知 A 用户，同理，C 用户也点击了“感兴趣”，同样需要推送消息告知 A 用户，这种情况下一个 formId 肯定是不够用的。于是在订阅消息出现以前，开发者就使用了一些黑科技来收集 formId：包括基于事件冒泡的多层嵌套表单，以及在小程序里埋藏大量的点击事件等，只要用户点击了就会触发表单提交，生成新的 formId，然后记录下有效期存放到数据库中，方便后续的使用。

不过有不少的黑科技已经被微信官方修复了，而且我们会发现，最终还是回到了起点，仍然没有解决用户受到消息骚扰的问题。微信大概也意识到了这一点，所以推出了订阅消息功能。

订阅消息推送

举个订阅消息的例子：当我们参与某个公众号的抽奖活动之后，会有弹窗提示我们是否接受抽奖结果的信息推送，这个弹窗就属于订阅消息功能的授权环节。

从使用体验来看，订阅消息推送最大的特征就在于，它对于用户和开发者都是友好的。首先，消息下发的权限交还给了用户，由用户自己来决定要不要接受消息推送，不再像之前那样被动接受了；其次，对于我们开发者来说，只需要调用接口询问用户是否接受消息推送即可，只要用户同意，那么我们就可以多次发送消息，不再需要像以前那样费力去收集 formId 了。

使用

首先登录微信公众平台，选择订阅消息 —— 我的模板 —— 添加，然后根据自己的需求选择一个模板，配置关键字，提交之后即可获得模板对应的模板 Id，这个 Id 稍后调用 api 的时候会用到，当然，同样需要用到的还有关键字对应的参数：

小程序端代码：

let templateId = 'Ite6-mnfTlONu6rd35AJ-SGQYKQgj1WMvjVj0O5h9kE'
wx.requestSubscribeMessage({
    tmplIds: [templateId],
    success: (res)=> {
        // 如果用户点击允许
        if(res[templateId] == 'accept'){
            console.log('点击了允许')
            wx.cloud.callFunction({
                name:'sendMessage',
                data:{
                    templateId,
                    content: this.data.textContent,
                    blogId: this.properties.blogid,
                }
            }).then(res => {                      
                this.setData({
                    textContent:''
                })
            })
        } else {
            console.log('点击了取消')
        }
    }
    fail:(res) => {}
})

wx.requestSubscribeMessage 这个 api 主要用来调起弹窗询问用户是否接受消息推送，tmplIds 数组存放各类模板 Id，因为开发者可能不止使用了一个模板。

这里要注意两个地方，第一个是这个 api 只能在点击事件或者触发支付回调后使用，bindsubmit 表单提交事件是用不了的；第二个是，不管用户点击允许还是拒绝，都会来到 success 回调，fail 回调是在 api 本身调用失败后执行的。那么怎么判断用户是点击了允许还是拒绝（取消）呢？如果用户点击了允许，那么 res 中模板 Id 键对应的键值会是 “accept”（反之则是 “reject”），然后调用相应的云函数并传参，进行消息推送。

在云函数中调用相关 api 之前，要先去云函数文件夹下的 config.JSON 文件设置调用权限：

{
  "permissions": {
    "openapi": [
      "subscribeMessage.send"
    ]
  }
}

相关的云函数：

const cloud = require('wx-server-sdk')
cloud.init()

exports.main = async (event, context) => {
  const {OPENID} = cloud.getWXContext()

  return await cloud.openapi.subscribeMessage.send({
    touser: OPENID,
    page: `/pages/blog-comments/blog-comments?blogId=${event.blogId}`,
    data:{
      thing4:{
        value:'评价完成'
      },
      thing1:{
        value: event.content
      }
    },
    templateId: event.templateId
  })
}

主要是用到了 cloud.openapi.subscribeMessage.send() 这个 api，相关的参数就根据自己的实际情况来：这里的 OPENID 是消息发送目标的 openid，page 则是用户点击消息后进入的页面（这里是评论详情页），data 就对应我们之前在微信公众平台设置的模板关键字，当然，这里要注意使用此前模板提供的键名（thing4 和 thing1），最后还有一个参数就是我们的模板 Id 啦。其实和之前模板消息的用法是差不多的，只不过我们不再需要传参 fromId 了。

最后，对用户来说，他也可以在弹窗的时候点击允许和记住选择，这样就是默认每次都接受消息推送了，对应的就是默认执行 wx.requestSubscribeMessage 中的 if 代码块。

其实，不谈技术，单从用户的角度来看，这个功能的调整其实是很人性化的，选择权确实本就应该掌握在用户手中，如果用户没有权限拒收不需要的消息，这样的产品还谈什么用户体验呢？在查阅相关资料的时候，也看到了一篇从产品角度分析的文章，感觉写得不错，感兴趣的可以看一看。

参考：

小程序官方文档

微信小程序订阅消息推送