MSMC UNIM 消息对接
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ce5fa345/unim-send。
技能介绍
要解决什么问题
企业侧若要把业务通知、验证码或运营触达接到融合消息平台(MSMC UNIM),通常要单独实现 Token 换取、参数签名和 5G 消息接口调用。本技能把 UNIM 对接里重复且易错的认证与发送流程收敛成可复用的说明与 SDK 参考,便于在 Agent 或脚本里按同一套规则调用。
技能如何工作
认证分两层:访问 Token 与 请求签名。
- Token:密码先做 SHA256 得 Hex;再与
timestamp拼接后 SHA256 得 Hex;最后用账号#与第二步结果拼接并 Base64,得到 auth 相关凭据(详见 SKILL 中的 auth 生成规则)。 - 签名:接口参数按 key 字典序排序,拼成
key1=value1&key2=value2,再 SHA256 → Hex → Base64。
业务发送侧,快速路径是「先取 Token,再带必传参数发 5G 消息」。完整实现集中在 scripts/msmc_client.py:get_token() 负责令牌,send_5g_message() 负责 5G 消息下发。字段与路径细节以 references/api_reference.md 为准。
适用边界与注意点
- 技能描述的是 UNIM / 5G 消息 对接范式,不包含平台账号开通、模板审核等平台运营配置。
- 生产环境务必校验时钟与
timestamp、密钥存储方式,避免把明文密码写进日志或版本库。 - 若接口版本或字段与参考文档不一致,应以你方环境提供的官方 API 文档为准,并对照
msmc_client.py做最小改动。
使用场景
- 登录或风控流程需经 MSMC UNIM 下发 5G 验证码,后端要按规范取 Token、签参数并调用 send 接口
- 监控或工单系统在故障触发时,向值班号码发送 5G 告警,需复用统一的 auth 与请求签名逻辑
- Agent 或定时任务在审批通过后自动发运营触达,调用 `get_token()` 与 `send_5g_message()` 完成下发
- 新环境联调 UNIM 时,对照 SKILL 中的 SHA256/Base64 规则核对与平台文档是否一致
适合人员
- 负责企业通知网关、要把业务系统接到 MSMC UNIM 5G 发送接口的后端开发
- 维护 UNIM 账号、密码与 timestamp 配置,并排查签名失败或 Token 过期的 IT 运维
- 需要阅读或改造 `scripts/msmc_client.py`、按 api_reference 对齐字段的集成工程师
- 在自动化流程里编排「取 Token → 发 5G 消息」、减少重复实现认证算法的平台工程师