草庐IT

微信小程序之订阅消息推送

Suifqwu 2023-04-21 原文

目录

1、开通订阅消息

2、请求用户授权

2.1、wx.requestSubscribeMessage(Object object)

2.2、wx.requestSubscribeDeviceMessage(Object object)

3、发送订阅信息

3.1、调用方式

3.2、云调用接口方法

3.3、请求参数

3.4、返回值

3.5、代码示例

1、开通订阅消息

登录小程序之后点击功能下的订阅消息，点击开通

选择公共模板库的一次性订阅

我选择是注册模板，模板ID就是我所需要的东西

2、请求用户授权

        订阅消息授权时，只能是用户点击或者支付完成后才可以调起来授权弹窗，详情请见微信官方文档-requestSubscribeMessage

2.1、wx.requestSubscribeMessage(Object object)

        调起客户端小程序订阅消息界面，返回用户订阅消息的操作结果。当用户勾选了订阅面板中的“总是保持以上选择，不再询问”时，模板消息会被添加到用户的小程序设置页，通过 wx.getSetting 接口可获取用户对相关模板消息的订阅状态。

参数

属性类型默认值必填说明
tmplIdsArray是需要订阅的消息模板的 id 的集合，一次调用最多可订阅3条消息。每个 tmplId 对应的模板标题需要不相同，否则会被过滤。
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行

object.success 回调函数

属性类型说明
errMsgString接口调用成功时 errMsg 值为'requestSubscribeMessage:ok'
[TEMPLATE_ID: string]String

[TEMPLATE_ID]是动态的键，即模板id，值包括'accept'、'reject'、'ban'、'filter'。

'accept'表示用户同意订阅该条 id 对应的模板消息，

'reject'表示用户拒绝订阅该条 id 对应的模板消息，

'ban'表示已被后台封禁，

'filter'表示该模板因为模板标题同名被后台过滤。

例如 { errMsg: "requestSubscribeMessage:ok", zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE: "accept"} 表示用户同意订阅zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE这条消息

object.fail 回调函数

属性类型说明
errMsgString接口调用失败错误信息
errCodeNumber接口调用失败错误码

错误码

errCodeerrMsg说明
10001TmplIds can't be empty参数传空了
10002Request list fail网络问题，请求消息列表失败
10003Request subscribe fail网络问题，订阅请求发送失败
10004Invalid template id参数类型错误
10005Cannot show subscribe message UI无法展示 UI，一般是小程序这个时候退后台了导致的
20001No template data return, verify the template id exist没有模板数据，一般是模板 ID 不存在 或者和模板类型不对应 导致的
20002Templates type must be same模板消息类型 既有一次性的又有永久的
20003Templates count out of max bounds模板消息数量超过上限
20004The main switch is switched off用户关闭了主开关，无法进行订阅
20005This mini program was banned from subscribing messages小程序被禁封
20013Reject DeviceMsg Template不允许通过该接口订阅设备消息

代码示例

    var TemplateID = 'xxxxxxxx'
    var TemplateStatus = wx.getStorageSync('TemplateID')
    if(TemplateStatus != 'accept'){
      wx.requestSubscribeMessage({
        tmplIds: [TemplateID],
        complete (res) {
          console.log("complete: ",res)
          wx.setStorageSync('TemplateID', res[TemplateID])
        },
      })
    }

使用效果

 可以看到，这里显示的就是我们添加的 ‘注册成功通知’的模板。 

真机上多了一个 ‘总是保持以上选择，不再询问’

2.2、wx.requestSubscribeDeviceMessage(Object object)

        订阅设备消息接口，调用后弹出授权框，用户同意后会允许开发者给用户发送订阅模版消息。当用户点击“允许”按钮时，模板消息会被添加到用户的小程序设置页，通过 wx.getSetting 接口可获取用户对相关模板消息的订阅状态。

        当前未使用

3、发送订阅信息

        回复信息时需要使用用户的openid

        详情请见微信官方文档: 微信官方文档-subscribeMessage.send

3.1、调用方式

当前使用云调用

3.2、云调用接口方法

openapi.subscribeMessage.send

3.3、请求参数

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

3.4、返回值

返回的 JSON 数据包

属性类型说明
errCodenumber错误码
errMsgstring错误信息

errCode 的合法值

值说明
0成功

异常

属性类型说明
errCodenumber错误码
errMsgstring错误信息

errCode 的合法值

值说明
40003touser字段 openid 为空或者不正确
40037订阅模板 id 为空不正确
43101用户拒绝接受消息，如果用户之前曾经订阅过，则表示用户取消了订阅关系
47003模板参数不准确，可能为空或者不满足规则，errmsg会提示具体是哪个字段出错
41030page路径不正确，需要保证在现网版本小程序中存在，与 app.json 保持一致

3.5、代码示例

在云函数中调用，UserOpenid是微信用户的openid，TemplateID是模板id

    try {
      const result = await cloud.openapi.subscribeMessage.send({
          "touser": UserOpenid,
          "templateId": TemplateID,
          "lang": 'zh_CN',
          "data": {
            "date2": {
              "value": '2015年01月05日'
            },
            "thing4": {
              "value": '阿里巴巴'
            },
            "character_string9": {
              "value": '123456789'
            }
          },
        })
      return result
    } catch (err) {
      return err
    }

其中date2、thing4、character_string9是根据小程序中的模板定义的

 效果如图：

微信小程序微信tdxff0ctr

有关微信小程序之订阅消息推送的更多相关文章

  1. ruby-on-rails - 如何在 Rails View 上显示错误消息？ - 2

    我是rails的新手，想在form字段上应用验证。myviewsnew.html.erb.....模拟.rbclassSimulation{:in=>1..25,:message=>'Therowmustbebetween1and25'}end模拟Controller.rbclassSimulationsController我想检查模型类中row字段的整数范围，如果不在范围内则返回错误信息。我可以检查上面代码的范围，但无法返回错误消息提前致谢 最佳答案 关键是您使用的是模型表单，一种显示ActiveRecord模型实例属性的表单。c

  2. ruby - 使用 Ruby 通过 Outlook 发送消息的最简单方法是什么？ - 2

    我的工作要求我为某些测试自动生成电子邮件。我一直在四处寻找，但未能找到可以快速实现的合理解决方案。它需要在outlook而不是其他邮件服务器中，因为我们有一些奇怪的身份验证规则，我们需要保存草稿而不是仅仅发送邮件的选项。显然win32ole可以做到这一点，但我找不到任何相当简单的例子。 最佳答案 假设存储了Outlook凭据并且您设置为自动登录到Outlook，WIN32OLE可以很好地完成此操作:require'win32ole'outlook=WIN32OLE.new('Outlook.Application')message=

  3. Ruby - 如何将消息长度表示为 2 个二进制字节 - 2

    我正在使用Ruby，我正在与一个网络端点通信，该端点在发送消息本身之前需要格式化“header”。header中的第一个字段必须是消息长度，它被定义为网络字节顺序中的2二进制字节消息长度。比如我的消息长度是1024。如何将1024表示为二进制双字节？ 最佳答案 Ruby(以及Perl和Python等)中字节整理的标准工具是pack和unpack。ruby的packisinArray.您的长度应该是两个字节长，并且按网络字节顺序排列，这听起来像是n格式说明符的工作:n|Integer|16-bitunsigned,network(bi

  4. 微信小程序通过字典表匹配对应数据 - 2

    前言一般来说，前端根据后台返回code码展示对应内容只需要在前台判断code值展示对应的内容即可，但要是匹配的code码比较多或者多个页面用到时，为了便于后期维护，后台就会使用字典表让前端匹配，下面我将在微信小程序中通过wxs的方法实现这个操作。为什么要使用wxs？{{method(a,b)}}可以看到，上述代码是一个调用方法传值的操作，在vue中很常见，多用于数据之间的转换，但由于微信小程序诸多限制的原因，你并不能优雅的这样操作，可能有人会说，为什么不用if判断实现呢？但是if判断的局限性在于如果存在数据量过大时，大量重复性操作和if判断会让你的代码显得异常冗余。wxswxs相当于是一个独立

  5. 计算机毕业设计ssm+vue基本微信小程序的小学生兴趣延时班预约小程序 - 2

    项目介绍随着我国经济迅速发展,人们对手机的需求越来越大,各种手机软件也都在被广泛应用,但是对于手机进行数据信息管理,对于手机的各种软件也是备受用户的喜爱小学生兴趣延时班预约小程序的设计与开发被用户普遍使用,为方便用户能够可以随时进行小学生兴趣延时班预约小程序的设计与开发的数据信息管理,特开发了小程序的设计与开发的管理系统。小学生兴趣延时班预约小程序的设计与开发的开发利用现有的成熟技术参考,以源代码为模板,分析功能调整与小学生兴趣延时班预约小程序的设计与开发的实际需求相结合,讨论了小学生兴趣延时班预约小程序的设计与开发的使用。开发环境开发说明：前端使用微信微信小程序开发工具：后端使用ssm：VU

  6. 微信小程序开发入门与实战（Behaviors使用） - 2

    @作者:SYFStrive @博客首页:HomePage📜：微信小程序📌：个人社区（欢迎大佬们加入）👉：社区链接🔗📌：觉得文章不错可以点点关注👉：专栏连接🔗💃：感谢支持,学累了可以先看小段由小胖给大家带来的街舞👉微信小程序（🔥）目录自定义组件-behaviors    1、什么是behaviors    2、behaviors的工作方式    3、创建behavior    4、导入并使用behavior    5、behavior中所有可用的节点    6、同名字段的覆盖和组合规则总结最后自定义组件-behaviors    1、什么是behaviorsbehaviors是小程序中，用于实现

  7. ruby-on-rails - 在 Flash 警报 Rails 3 中显示错误消息 - 2

    如果我在模型中设置验证消息validates:name,:presence=>{:message=>'Thenamecantbeblank.'}我如何让该消息显示在闪光警报中，这是我迄今为止尝试过的方法defcreate@message=Message.new(params[:message])if@message.valid?ContactMailer.send_mail(@message).deliverredirect_to(root_path,:notice=>"Thanksforyourmessage,Iwillbeintouchsoon")elseflash[:error]

  8. ruby-on-rails - 在 RSpec 中，如何以任意顺序期望具有不同参数的多条消息？ - 2

    RSpec似乎按顺序匹配方法接收的消息。我不确定如何使以下代码工作:allow(a).toreceive(:f)expect(a).toreceive(:f).with(2)a.f(1)a.f(2)a.f(3)我问的原因是a.f的一些调用是由我的代码的上层控制的，所以我不能对这些方法调用添加期望。 最佳答案 RSpecspy是测试这种情况的一种方式。要监视一个方法，用allowstub，除了方法名称之外没有任何约束，调用该方法，然后expect确切的方法调用。例如:allow(a).toreceive(:f)a.f(2)a.f(1)

  9. arrays - Ruby 数组 += vs 推送 - 2

    我有一个数组数组，想将元素附加到子数组。+=做我想做的，但我想了解为什么push不做。我期望的行为(并与+=一起工作):b=Array.new(3,[])b[0]+=["apple"]b[1]+=["orange"]b[2]+=["frog"]b=>[["苹果"],["橙子"],["Frog"]]通过推送，我将推送的元素附加到每个子数组(为什么？):a=Array.new(3,[])a[0].push("apple")a[1].push("orange")a[2].push("frog")a=>[[“苹果”、“橙子”、“Frog”]、[“苹果”、“橙子”、“Frog”]、[“苹果”、“

  10. ruby-on-rails - 闪存消息存储在哪里？ - 2

    我以为它们存储在cookie中-但不，检查cookie没有任何结果。session也不存储它们。那么，我在哪里可以找到它们？我需要这个来直接设置它们(而不是通过flashhash)。 最佳答案 它们存储在inyoursessionstore.自rails2.0以来的默认设置是cookie存储，但请检查config/initializers/session_store.rb以检查您是否使用默认设置以外的东西。 关于ruby-on-rails-闪存消息存储在哪里？，我们在StackOverf

随机推荐