华为云短信配置

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

---

一、华为云控制台配置

1. 开通短信服务

登录 华为云消息&短信 MSGSMS 控制台，完成企业实名后开通「国内短信」。

2. 创建应用（获取 APP Key、APP Secret）

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

• 创建短信应用，记录 APP Key、APP Secret。
• 分别对应商城后台 APP Key、APP Secret 表单项（用于 WSSE 接口鉴权）。

3. 申请短信签名

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

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

4. 获取短信通道号

路径：国内短信 → 应用管理 → 通道管理（或应用详情中的发送通道）

• 查看 通道号 / 发送方号码（形如 csms12345678）。
• 对应商城后台 短信通道号（接口参数 sender）。

5. 申请模板（获取模板 ID）

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

• 按场景创建模板，审核通过后记录 模板 ID。
• 华为云变量格式与阿里云相近，常用 ${变量名}；商城库内统一存 ${order}、${code} 等，消息详情展示时保持 ${变量} 形式。

常见场景模板内容参考：

场景	模板内容参考
手机验证码	验证码：${code}（手机绑定，请完成验证），如非本人操作，请忽略本短信
支付成功	购物提醒，您已成功完成订单${order}支付，请留意我们的发货通知
发货通知	亲爱的客户，您购买的货物已通过${shipping_name}发出，单号${code}…
退款成功	亲爱的客户，您购买的货物（订单号：${order}）已完成退款…
商家下单提醒	有新的会员购物提醒，订单号${order}，订单额${fee}，请及时关注

6. 确认接入地址（Endpoint）

华为云按区域提供 API 接入地址，须与应用所在区域一致。华北-北京四示例：

https://smsapi.cn-north-4.myhuaweicloud.com:443

以控制台「应用管理」或 API 文档 显示的地址为准；填错区域会导致鉴权或发送失败。

---

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

进入路径

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

在页签 「短信通知设置」 中操作。

页面示意

1. 服务商 选择 华为云。
2. 按下方表格逐项填写（带 * 为必填），保存。

表单项与华为云控制台对照

前端表单项	是否必填	接口字段	在华为云哪里获取	填写说明
APP Key	是	smsHuaweiAppKey	短信控制台 → 应用管理	华为云短信应用 APP Key，用于接口鉴权。回显脱敏后未修改可原样保存；修改时点 「编辑」。
APP Secret	是	smsHuaweiAppSecret	同上，与 APP Key 成对	用于接口鉴权，请妥善保管，勿泄露。
短信通道号	是	smsHuaweiChannel	应用 → 通道管理	发送方通道号，示例：csms12345678。
短信签名	是	smsHuaweiSignName	签名管理（已审核）	须在华为云申请并审核通过，与后台填写一致，如：佰商科技。
接入地址	是	smsHuaweiEndpoint	控制台或 API 文档中的区域 Endpoint	完整 URL，含协议与端口。示例：https://smsapi.cn-north-4.myhuaweicloud.com:443
商家短信号码	否	smsHuaweiShopMobile	自行填写	用于商家接收会员订单等信息，可不填。

保存说明

• 保存接口：POST /adminapi/setting/config/saveNotify
• 仅校验华为云当前必填项；其他云配置建议一并提交以便切换时保留。
• 从阿里云/腾讯云切到华为云后，务必更新 消息管理 中各场景的 短信模板 ID 为华为云模板 ID。

---

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

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

1. 编辑对应消息类型。
2. 只读展示：当前短信服务商：华为云。
3. 短信模板 ID 填写华为云「模板管理」中的模板 ID（非阿里云 SMS_ 格式）。
4. 通知内容 为只读参考；占位符展示为 ${code}、${order} 等，与华为云控制台建模板时保持一致即可。

---

四、常见问题

现象	可能原因	处理建议
保存提示接入地址不能为空	未填写 Endpoint	按区域填写完整 URL，参考上文示例
鉴权失败	APP Key/Secret 错误或脱敏被覆盖	点「编辑」重新填入完整密钥
发送失败 通道相关错误	通道号与签名、应用不匹配	核对 短信通道号 是否为该应用下已审核通道
模板发送失败	模板 ID 仍为其他云平台的 ID	在消息管理中改为华为云模板 ID

技术说明（供排查）： 请求地址为 {接入地址}/sms/batchSendSms/v1；手机号无 + 时会自动补 +86；模板参数由服务端转为 JSON 数组传递。