跳到主要内容

如何启用发短信功能

短信功能说明
  • 默认支持的短信服务商目前仅支持验证码类短信模板配置,可满足手机号注册、账号绑定、密码找回等功能。
  • 若同时配置多家服务商,系统将随机选择发送通道,基于自主集成启用短信功能后,系统内置的验证码发送通道将自动失效。
  • 产品内还有一些功能是发送自定义短信内容的,由于自定义短信内容格式无法统一标准化,目前如果需要启用这部分功能(如:工作流短信通知节点、邀请手机号用户注册、公开表单手机号验证等),需自行申请第三方短信服务商账号,然后自主集成或由官方技术团队定制开发

标准验证码服务

配置入口

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

默认支持的短信服务商

腾讯云

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

阿里云

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

自主集成

集成步骤

  1. 在服务器中创建配置文件 appextensions.json

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

    {
    "WebhookUrl": "https://api.yourdomain.com/sms/webhook",
    "WebhookHeaders": {}
    }

    配置参数说明

    • WebhookUrl:必填,接收短信消息的API接口地址。
    • WebhookHeaders:可选,自定义请求头,用于身份验证等用途。
  2. 消息体规范

    HAP 通过 POST 方式,以 application/json 格式向 WebhookUrl 发送 JSON 数据,包含两种消息类型。

    短信消息体格式

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

    语音验证码消息体格式

    {
    "Type": 2,
    "Data": {
    "Mobile": "手机号",
    "Code": "验证码"
    }
    }
  3. 将配置文件 appextensions.json 挂载至 mingdaoyun-community 容器内 /usr/local/MDPrivateDeployment/sms/appextensions.json 路径。

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

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