消息中台接入华为云短信

8 阅读2分钟

第 1 页:封面 主标题:消息中台接入华为云短信服务

副标题:技术方案与详细设计

汇报人/日期:[您的名字/日期]


第 2 页:整体接入流程概览 核心目标:在现有消息发送架构下,垂直扩展“华为云短信”作为新增发送渠道。

云端准备:获取鉴权密钥与通道资源。

工程配置:集成 SDK 与环境配置。

发送实现:参数适配与 API 调用。


第 3 页:步骤一、华为云前置准备

  1. 创建短信应用,获取 API 鉴权参数

APP_Key:应用接入密钥

APP_Secret:应用接入安全凭证

APP_Endpoint:example.cn-north-4.myhuaweicloud.com:443


  1. 申请核心短信资源

需要在华为云管理控制台中配置并获取以下信息

短信签名 (Signature):身份标识(【se告警系统】),签名管理处配置

短信通道号 (Sender):从签名管理处获取,发送时需要携带ID

短信模板 (Template):含变量的短信正文,需要配置对应的模板,发送时需要携带ID

【se告警系统】${1}系统发生新告警!时间:${2} ${3},设备号:${4},等级:${5},详情:${6}。请及时登录系统查看并处理。

${1}-发生告警的系统

${2}-告警日期

${3}-告警时间

${4}-告警设备

${5}-告警等级

${6}-告警详情,默认赋值为(请登录系统查看)


第 4 页:步骤二、工程依赖与配置


  1. 引入官方 SDK

采用 huaweicloud-sdk-sms 官方库。

优势:避免手动拼接复杂的 WSSE Header 签名,降低出错率。

  1. 配置文件 (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类型,代表短信类型的接口回调