短信配置

短信配置指南

TDuckX 支持接入腾讯云短信、阿里云短信等主流短信服务商，用于短信验证码、消息通知等场景。

一、短信模板要求

短信平台中的模板内容需要与系统传递参数保持一致。

例如：

您的验证码为：{code}，5分钟内有效。

或者：

您的验证码为：${code}，请勿泄露给他人。

不同短信平台支持的变量格式可能不同，请以实际平台要求为准。

⚠️ 重要：

模板中的动态参数名称必须与系统配置一致，否则可能导致短信发送失败。

二、腾讯云短信配置

1. 获取 SecretId 与 SecretKey

登录腾讯云控制台，进入：

短信服务 → API 密钥管理

创建并获取：

  • SecretId
  • SecretKey

参考下图：

2. 创建短信模板

进入腾讯云短信控制台创建短信模板，并完成审核。

模板审核通过后，记录：

  • 模板 ID
  • 短信签名

参考：

image.png

3. 创建应用并获取 AppID

进入：短信服务 → 应用管理 新建应用并记录：AppID

4. 配置到 TDuckX

进入：

系统配置 → 短信配置

选择：腾讯云短信

图片

填写以下参数：

配置项 说明
AppID 腾讯云应用 ID
SecretId API 密钥 ID
SecretKey API 密钥 Key
短信签名 审核通过的短信签名
模板 ID 审核通过的模板 ID

填写完成后点击保存，即可完成腾讯云短信接入。

三、阿里云短信配置

登录阿里云短信服务控制台。

创建并审核：

  • 短信签名
  • 短信模板

获取：

  • AccessKey ID
  • AccessKey Secret

参考下图：

image.png

完成后进入：系统配置 → 短信配置选择：阿里云短信；填写对应参数并保存即可。

图片

四、配置短信通知模板

完成短信平台配置后，还需要配置系统内的短信通知模板。

进入：系统配置 → 通知配置

找到：短信验证码，模板并点击修改。

图片

需要重点确认以下内容：

配置项 说明
模板 Code 系统内置编码，禁止修改
第三方模板 ID 必须与短信平台审核通过的模板 ID 一致
模板内容 仅作展示参考，以短信平台实际模板为准

⚠️ 注意：

如果第三方模板 ID 填写错误，将导致短信发送失败。

五、配置短信平台参数

进入：系统配置 → 短信配置，选择对应短信服务商并填写参数。填写完成后点击保存。

参考如下：

图片

六、发送测试短信

所有配置完成后，建议先进行短信测试，确认配置是否正确。

进入短信测试页面：

  1. 输入手机号
  2. 点击发送测试短信
  3. 查看是否收到短信

参考如下：

图片

常见问题

发送失败怎么办？

请依次检查：

  • 短信签名是否已审核通过
  • 短信模板是否已审核通过
  • SecretId、SecretKey 是否填写正确
  • AppID 是否填写正确
  • 第三方模板 ID 是否与平台一致
  • 手机号格式是否正确

配置保存成功但收不到短信？

常见原因：

  • 模板参数名称不匹配
  • 模板 ID 配置错误
  • 短信签名未审核通过
  • 短信服务商账户余额不足
  • 短信服务商风控拦截

建议先使用系统自带的短信测试功能进行排查。