第 1 页:封面 主标题:消息中台接入华为云短信服务
副标题:技术方案与详细设计
汇报人/日期:[您的名字/日期]
第 2 页:整体接入流程概览 核心目标:在现有消息发送架构下,垂直扩展“华为云短信”作为新增发送渠道。
云端准备:获取鉴权密钥与通道资源。
工程配置:集成 SDK 与环境配置。
发送实现:参数适配与 API 调用。
第 3 页:步骤一、华为云前置准备
- 创建短信应用,获取 API 鉴权参数
APP_Key:应用接入密钥
APP_Secret:应用接入安全凭证
APP_Endpoint:example.cn-north-4.myhuaweicloud.com:443
- 申请核心短信资源
需要在华为云管理控制台中配置并获取以下信息
短信签名 (Signature):身份标识(【se告警系统】),签名管理处配置
短信通道号 (Sender):从签名管理处获取,发送时需要携带ID
短信模板 (Template):含变量的短信正文,需要配置对应的模板,发送时需要携带ID
【se告警系统】${1}系统发生新告警!时间:${2} ${3},设备号:${4},等级:${5},详情:${6}。请及时登录系统查看并处理。
${1}-发生告警的系统
${2}-告警日期
${3}-告警时间
${4}-告警设备
${5}-告警等级
${6}-告警详情,默认赋值为(请登录系统查看)
第 4 页:步骤二、工程依赖与配置
- 引入官方 SDK
采用 huaweicloud-sdk-sms 官方库。
优势:避免手动拼接复杂的 WSSE Header 签名,降低出错率。
- 配置文件 (YAML)
配置密钥、地址、签名等敏感信息。
sms:
huawei:
app-key: "你的APP_Key"
app-secret: "你的APP_Secret"
endpoint: "https://smsapi.cn-north-4.myhuaweicloud.com:443"
sender: "通道号"
signature: "【产品签名】"
第 5 页:步骤三、核心发送逻辑实现
参照华为云官网示例代码进行网络的发送
第一步:客户端初始化 -> 单例模式构建 SmsClient,复用连接。
第二步:参数适配 -> 通用消息 转换为 华为云 SendSmsRequest。
注:华为云要求模板变量必须转为 JSON 数组字符串(如 ["123456"])。
第三步:发起调用 -> 同步请求网关,捕获网络与业务异常。
第四步:结果解析 -> 提取返回的 smsMsgId,落库绑定至消息流水号,供后续回调使用。
第 6 页:se对接messagecenter
tt调用messagecenter send接口
type:
新添加一个SMS类型,用来标识消息发送类型
subject:
用来存放所有的模板变量参数,将所有模板参数按照顺序放入json数组中,并转换为字符串发送,避免对象序列化导致顺序错误
["SYSTEM","DATE","TIME","DEVICE_ID","LEVEL","INFOMATION"]
messagecenter接收解析字符串,并按照顺序填入短信模板当中发送
messagecenter调用ty add接口 添加类型为SMS类型,代表短信类型的告警
messagecenter待用tt alert接口 添加类型谁SMS类型,代表短信类型的接口回调