Logo

小程序消息

开发者在小程序中通过几行代码即可发送订阅消息

# 功能特性

  • 自动鉴权:微信服务器搞定鉴权,无需手动处理access_token,简化开发流程。
  • 安全无忧:鉴权交给微信服务器,保障云调用安全,降低access_token泄露风险。
  • 专注业务:提供更简洁的接口,专注业务逻辑,无需操心底层通信和鉴权细节。
  • 性能卓越:底层自动扩展收缩,支持高并发和大数据处理,解决云函数冷启动问题。

# 快速上手

# 第 1 步:安装云模板

在云模板市场中 安装 小程序消息模板,等待安装完成即可使用。

# 第 2 步:在小程序中配置云开发环境 ID

修改app.js,在 ApponLaunch 生命周期方法中添加云能力初始化代码,参数传入当前小程序的云开发环境ID。

App({
  onLaunch: function () {
    wx.cloud.init({
      // env 参数决定接下来小程序发起的云开发调用(wx.cloud.xxx)会默认请求到哪个云环境的资源
      env: '{%TCB_ENV_ID%}',
      // 是否在将用户访问记录到用户管理中,在控制台中可见,默认为false
      traceUser: false,
    });
  },
});

# 第 3 步:在小程序中调用接口

例如,在微信中向订阅用户发送消息。 模板ID:在小程序管理平台获取。

wx.cloud.callFunction({
  name: 'cloudbase_module',
  data: {
    name: 'wx_message_send_message',
    data: {
      template_id: 'XeULkxnxxxxxxxxxxxxxx9vRO0olhrQi34', // 所需下发的订阅模板id
      page: 'pages/index/index', //点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转
      touser: 'ouSoxxxxxxxxxxxxxJp3zM', //接收者(用户)的 openid
      data: {
        thing1: { value: 123 },
        thing4: { value: 123 },
        thing6: { value: 123 },
        thing7: { value: 123 },
        time6: { value: '2022-11-32' },
      }, //模板内容,格式形如 { "key1": { "value": any }, "key2": { "value": any } }的object
      miniprogram_state: 'trial', //跳转小程序类型:developer为开发版;trial为体验版;formal为正式版;默认为正式版
      lang: 'zh_CN', //进入小程序查看”的语言类型,支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文),默认为zh_CN
    },
  },
  success: (res) => {
    console.log('综合结果', res.result.result);
    console.log('错误码', res.result.errcode);
    console.log('错误信息', res.result.errmsg);
  },
});

其他接口的调用方式具体可以参考云模板接口展示说明。

# 接口说明

本模板提供了 2 个 接口方法:

  • wx_message_send_message: 发送订阅消息。
  • wx_message_create_activity_id: 创建activity_id。

具体调用方式在云模板接口详情中查看对应使用方式。