微信小程序订阅消息推送

小咪咪 2023-02-28 05:30 26阅读 0赞

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

**那么这两个功能有什么区别呢？**  
![在这里插入图片描述][20200720151033226.png_pic_center]

**模板消息推送**

简单地说，用户每进行一次提交表单或是支付行为，都会产生一个 formId，开发者可以通过这个 formId 向用户推送消息。由于下发权限是在开发者这边，为了防止消息频繁推送对用户造成的骚扰，小程序做出了一个限制：一个 formId 只有 7 天有效期，每推送一次消息会消耗一个 formId，也就是说，正常情况下，开发者 7 天内可以推送的消息数量是有限的。

这样当然对用户是友好的，但是对开发者来说，有些业务场景又确实推送多条消息：比如说 A 用户发布一个二手商品，B 用户点击了“感兴趣”，需要推送消息告知 A 用户，同理，C 用户也点击了“感兴趣”，同样需要推送消息告知 A 用户，这种情况下一个 formId 肯定是不够用的。于是在订阅消息出现以前，开发者就使用了一些黑科技来收集 formId：包括基于事件冒泡的多层嵌套表单，以及在小程序里埋藏大量的点击事件等，只要用户点击了就会触发表单提交，生成新的 formId，然后记录下有效期存放到数据库中，方便后续的使用。

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

**订阅消息推送**

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

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

**使用**

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

**小程序端代码：**

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 代码块。

[20200720151033226.png_pic_center]: /images/20230209/f156d54d398f4e45b3ca28e3c4155dc7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3p4Y2xjbGNpb3A_size_16_color_FFFFFF_t_70_pic_center]: /images/20230209/b42eb562560a4d4080a4a5b59a398e83.png