如何启用发短信功能
短信功能说明
- 默认支持的短信服务商目前仅支持验证码类短信模板配置,可满足手机号注册、账号绑定、密码找回等功能。
- 若同时配置多家服务商,系统将随机选择发送通道,基于自主集成启用短信功能后,系统内置的验证码发送通道将自动失效。
- 产品内还有一些功能是发送自定义短信内容的,由于自定义短信内容格式无法统一标准化,目前如果需要启用这部分功能(如:工作流短信通知节点、邀请手机号用户注册、公开表单手机号验证等),需自行申请第三方短信服务商账号,然后自主集成或由官方技术团队定制开发。
标准验证码服务
配置入口
通过右上角头像下拉列表的 系统配置 > 短信服务设置:
默认支持的短信服务商
腾讯云
- 开通 腾讯云短信服务
- 创建国内短信模版,模板审核通过后再 短信服务设置 内进行配置
阿里云
- 开通 阿里云短信服务
- 创建国内短信模版,模板审核通过后再 短信服务设置 内进行配置
自主集成
集成步骤
-
在服务器中创建配置文件
appextensions.json
如:
/data/mingdao/script/volume/sms/appextensions.json
:{
"WebhookUrl": "https://api.yourdomain.com/sms/webhook",
"WebhookHeaders": {}
}配置参数说明:
- WebhookUrl:必填,接收短信消息的API接口地址。
- WebhookHeaders:可选,自定义请求头,用于身份验证等用途。
-
消息体规范
HAP 通过
POST
方式,以application/json
格式向WebhookUrl
发送 JSON 数据,包含两种消息类型。短信消息体格式:
{
"Type": 1,
"Data": {
"Mobiles": ["手机号"], // 接收消息的手机号列表
"Message": "短信内容",
"Signature": "签名"
}
}语音验证码消息体格式:
{
"Type": 2,
"Data": {
"Mobile": "手机号",
"Code": "验证码"
}
} -
将配置文件
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
-
重启服务