短信验证码

通过腾讯云短信向用户手机发送注册、登录等场景的验证码。

通过腾讯云短信向用户手机发送注册、登录等场景的验证码；API 密钥与文件存储共用腾讯云 COS 凭证。

系统设置 → 系统配置 → 腾讯云短信 Tab短信验证码

• 腾讯云短信控制台已创建应用、签名与验证码类模板且审核通过
• 已在系统配置 → 文件存储 Tab 填写腾讯云 COS 的 SecretId / SecretKey（短信 API 复用该凭证）
• 站点服务器可访问腾讯云 API
• 账号具备系统配置读写权限

管理后台配置

路径：系统设置 → 系统配置 → 腾讯云短信 Tab。

SecretId / SecretKey 不在本 Tab 填写，请在「文件存储 Tab → 腾讯云 COS」区块维护（与 COS 共用同一对 API 密钥）。

SdkAppId必填短信控制台 → 应用管理

短信签名必填已审核通过的短信签名

模板 ID必填验证码模板（变量通常为 {1} 验证码、{2} 有效期）

API 密钥（与文件存储共用）

若仅配置了短信 Tab 而未填 COS 密钥，发送会失败。密钥只需在文件存储 Tab 保存一次。

系统设置 → 系统配置 → 文件存储 Tab选择「腾讯云 COS」后填写 SecretId、SecretKey

后台自测

短信验证测试在本 Tab 输入测试手机号，点击「发送测试」；无需先保存，密钥留空则用已保存的 COS 凭证

区域配置

即使全站短信参数已填，若区域未开启上述开关，对应环节不会发送短信。

1. 1
   进入用户配置区域管理 → 用户配置，选择目标区域进入编辑
2. 2
   开启验证码按需打开「注册强制验证码」「登录强制验证码」并保存

验证是否生效

• 文件存储 Tab 已保存有效的腾讯云 SecretId / SecretKey
• 短信 Tab「发送测试」能收到验证码短信
• 目标区域用户配置已开启注册或登录强制验证码
• 客户端发起注册/登录能收到短信并完成验证

常见问题

保存成功但收不到短信签名、模板 ID 是否与控制台一致；文件存储 Tab 的 COS 密钥是否有效；运营商限流或手机号在黑名单。

发送测试报密钥错误到文件存储 Tab 检查 COS SecretId/SecretKey；须与短信同属一个腾讯云账号。

仅部分区域需要验证码在区域管理 → 用户配置中分别编辑各区域开关。

模板变量对不上验证码模板须含 {1}（验证码）等占位符，与控制台审核通过的模板一致。

相关文档

用户规则系统配置总览