腾讯云短信配置

Tigshop 支持阿里云、腾讯云、华为云、火山引擎四选一。本文说明腾讯云（smsProvider = 2）从控制台开通到商城后台配置的完整流程。

一、腾讯云控制台配置

1. 开通短信服务

登录腾讯云短信控制台，完成实名认证后开通「国内短信」。

2. 创建短信应用（获取 SDK AppID）

路径：国内短信 → 应用管理

新建应用并记录 SDK AppID（纯数字，如 1400006666）。
该 ID 对应商城后台 SDK AppID 表单项。

3. 申请短信签名

路径：国内短信 → 签名管理

申请签名（如：佰商科技），等待审核通过。
签名名称须与商城后台 短信签名 完全一致。

4. 申请正文模板（获取模板 ID）

路径：国内短信 → 正文模板管理

按业务场景创建模板（验证码、支付成功、发货、商家通知等），审核通过后记录 模板 ID（纯数字，如 1234567）。
不是阿里云格式的 SMS_xxxx。

占位符说明（重要）
腾讯云模板变量为顺序占位符 {1}、{2}、{3}……，与变量名无关，须与模板正文中变量出现顺序一致。
商城「消息管理」详情里，系统会把 ${code}、${order} 等展示为 {1}{2}，便于你对照控制台建模板；实际下发内容以腾讯云控制台审核通过的模板为准。

场景	商城内参考文案（阿里云风格）	腾讯云控制台模板示例
手机验证码	验证码：${code}（手机绑定，请完成验证）…	验证码：{1}（手机绑定，请完成验证）…
支付成功	您已成功完成订单${order}支付…	您已成功完成订单{1}支付…
发货通知	货物已通过${shipping_name}发出，单号${code}…	货物已通过{1}发出，单号{2}…
商家下单提醒	订单号${order}，订单额${fee}…	订单号{1}，订单额{2}…

5. 获取 SecretId、SecretKey

登录腾讯云访问管理 - API 密钥：

新建或查看密钥，复制 SecretId、SecretKey。
建议为短信单独创建子账号并授权「短信 SMS」相关权限。
密钥勿提交到公开仓库；泄露后请立即在 CAM 禁用并轮换。

二、商城后台配置（对应前端页面）

进入路径

后台 → 设置 → 消息设置 → 通知设置 → 短信通知设置

在页签 「短信通知设置」 中操作（与邮件、钉钉、企业微信通知并列）。

页面示意

服务商 选择 腾讯云（不要选阿里云/华为云/火山引擎，否则保存校验的是其他云字段）。
按下方表格逐项填写后点击保存。

表单项与腾讯云控制台对照

前端表单项	是否必填	接口字段	在腾讯云哪里获取	填写说明
SecretId	是	`smsTencentSecretId`	CAM - API 密钥管理	腾讯云账户 API 密钥 ID，用于标识调用者身份。首次保存后回显为脱敏值，未修改时直接保存即可，勿把 `****` 脱敏串当新密钥提交。
SecretKey	是	`smsTencentSecretKey`	同上，与 SecretId 成对	用于签名与鉴权，请妥善保管。显示为脱敏时点「编辑」输入新值。
SDK AppID	是	`smsTencentSdkAppId`	短信控制台 → 应用管理	短信应用 ID，示例：`1400006666`。
短信签名	是	`smsTencentSignName`	短信控制台 → 签名管理（已审核）	须与控制台签名完全一致，如：`佰商科技`。
商家短信号码	否	`smsTencentShopMobile`	自行填写商家手机号	用于商家接收会员下单等通知短信，可不填。

保存说明

保存接口：POST /adminapi/setting/config/saveNotify
后端只校验当前选中的服务商（腾讯云）必填项；阿里云/华为云/火山引擎字段可留空，但建议一并提交，避免切换服务商时丢失已填配置。
切换服务商后，系统会提示：请确认各消息类型的短信模板 ID 已更新为对应平台的模板。

三、消息管理：配置各场景模板 ID

路径：后台 → 设置 → 消息设置 → 消息管理

对每个需要发短信的消息类型（如：获取验证码、支付成功、发货通知、商家下单提醒等）：

打开消息类型详情/编辑。
页面会只读展示：当前短信服务商：腾讯云（来自 smsProvider）。
在短信通道填写 短信模板 ID = 腾讯云控制台「正文模板」中的 模板 ID（数字）。
通知内容 为只读参考，真实文案以腾讯云控制台模板为准；占位符在详情中会显示为 {1}{2}… 方便对照。

消息场景示例	原阿里云模板 ID 示例	切换腾讯云后
获取验证码	`SMS_129764389`	改为腾讯云模板 ID，如 `1234567`
支付成功	`SMS_xxx`	同上
商家下单提醒	`SMS_129764380`	同上

四、常见问题

现象	可能原因	处理建议
保存提示 SecretId 不能为空	未点编辑就清空脱敏字段	密钥未改则原样保存；要改则点「编辑」填完整密钥
发送失败 TemplateIncorrect	模板 ID 仍是阿里云 `SMS_` 格式	在消息管理中改为腾讯云数字模板 ID
发送失败变量不匹配	控制台模板变量个数/顺序与业务不一致	按 `{1}{2}` 顺序重建模板，并与业务参数顺序对齐
签名不匹配	后台签名与腾讯云审核签名不一致	核对短信签名与控制台完全一致

技术说明（供排查）： 发送时手机号会自动加 +86；API 地域为 ap-guangzhou；模板参数按 JSON 数组顺序映射到 {1}{2}…。