Logo

云开发发送短信

开发者可以在小程序中向指定用户发送短信和创建发送短信的任务。

# 功能特性

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

# 快速上手

# 第 1 步:安装云模板

在云模板市场中 安装 短信模板,等待安装完成。

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

初次使用需在入口文件app.js中初始化云调用实例,传入安装云模版时对应的云开发环境ID。

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

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

例如,给指定用户发送带url link的短信。

在发送短信之前需要先生成url link,获取url link的接口尚在开发中,用户可通过云函数获取。

wx.cloud.callFunction({
  name: 'cloudbase_module',
  data: {
    name: 'wx_sms_new_send_cloudbase_sms',
    data: {
      env: '{%TCB_ENV_ID%}', // 环境 ID
      url_link: 'https://wxaurl.cn/difT1VdVOLa', // URL Link
      template_id: '2053122', //短信模版 ID 默认值:2053122(销类短信模版 ID)
      template_param_list: ['xxx'], //短信模版变量数组
      phone_number_list: ['+8611111111111'], //手机号列表,单次请求最多支持 1000 个境内手机号,手机号必须以+86开头
      use_short_name: false, //是否使用小程序简称
      resource_appid: 'appid', //资源方appid,第三方代开发时可填第三方appid或小程序appid,应为所填环境所属的账号APPID
    },
  },
  success: (res) => {
    console.log('综合结果', res.result.result);
    console.log('错误码', res.result.errcode);
    console.log('错误信息', res.result.errmsg);
  },
});

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

# 接口说明

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

  • wx_sms_new_send_cloudbase_sms: 发送短信。
  • wx_sms_create_send_sms_task: 创建发送短信任务。