跳到主要内容

如何启用发短信功能

配置入口

通过右上角头像下拉列表的 系统配置 > 短信服务设置

默认支持的短信服务商

腾讯云

  1. 开通 腾讯云短信服务
  2. 创建国内短信模版,模板审核通过后再 短信服务设置 内进行配置

阿里云

  1. 开通 阿里云短信服务
  2. 创建国内短信模版,模板审核通过后再 短信服务设置 内进行配置

目前暂支持验证码类型的短信模板配置,满足通过手机号注册账号、账号绑定手机号、找回密码等功能,以上服务商只需要配置一家即可,如果同时配置了,那么在发送短信验证码时会随机选择一家。

另外在产品内还有一些功能是发送自定义短信内容的,因为无法统一标准化,目前如果需要启用这部分功能(如:工作流短信通知节点、邀请手机号用户注册、公开表单手机号验证等),需自行申请第三方短信服务商账号,然后自主集成或由官方技术团队定制开发,开启此模式后,系统配置中腾讯云、阿里云验证码发送通道将自动失效

自主集成

  1. 创建配置文件

    如:/data/hap/script/volume/sms/appextensions.json

    {
    "WebhookUrl": "接收消息的 API 接口地址", // 必填,如:https://api.domain.com/hooks/NjA0NzdjMDNjMGFjMTE3ZGUwMjRjN2Nl
    "WebhookHeaders": {} // 可选,请求头自定义参数
    }

    短信消息体格式如下:(POST application/json)

    {
    "Type": 1,
    "Data": {
    "Mobiles": ["手机号"], // 接收消息的手机号列表
    "Message": "短信内容",
    "Signature": "签名"
    }
    }

    语音验证码消息体格式如下:(POST application/json)

    {
    "Type": 2,
    "Data": {
    "Mobile": "手机号",
    "Code": "验证码"
    }
    }
  2. 挂载配置文件

    在微服务应用对应的 docker-compose.yaml volumes 中增加:

    - ./volume/sms/appextensions.json:/usr/local/MDPrivateDeployment/sms/appextensions.json
  3. 重启服务