# wx.requestSubscribeMessage(Object object)

基础库 2.4.4 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

小程序插件：支持，需要小程序基础库版本不低于 3.4.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 小程序订阅消息

# 功能描述

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

# 注意事项

• 一次性模板 id 和永久模板 id 不可同时使用。
• 低版本基础库2.4.4~2.8.3 已支持订阅消息接口调用，仅支持传入一个一次性 tmplId / 永久 tmplId。
• 2.8.2 版本开始，用户发生点击行为或者发起支付回调后，才可以调起订阅消息界面。
• 2.10.0 版本开始，开发版和体验版小程序将禁止使用模板消息 formId。
• 一次授权调用里，每个tmplId对应的模板标题不能存在相同的，若出现相同的，只保留一个。
• 2.10.0 版本开始，支持订阅语音消息提醒，详情

# 参数

# Object object

# object.success 回调函数

# 参数

# Object res

# object.fail 回调函数

# 参数

# Object res

# 错误码

# 示例代码

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