七、消息中心
菜单入口:系统管理 → 消息中心。
消息中心统一管理系统对外的三种触达渠道:短信(短信渠道/短信模板/短信日志)、邮件(邮箱账号/邮件模版/邮件记录)、站内信(站内信模板管理/站内信消息记录)。配置顺序均为"先配通道,再建模板,发送后查日志"。
7.1 短信渠道
菜单入口:消息中心 → 短信渠道。
配置对接短信服务商(阿里云、腾讯云等)的接入凭证,一个渠道对应一个服务商账号。
页面操作:
- 查询:按短信签名、启用状态、创建时间过滤,搜索执行、重置清空条件;
- 新增:填写短信签名(需服务商侧报备,如"点狮科技")、渠道编码(标识服务商类型,如阿里云/腾讯云)、短信 API 的账号、短信 API 的密钥、短信发送回调 URL、启用状态、备注;
- 编辑(行内):修改渠道凭证或启停;
- 删除(行内)/ 批量删除:删除未被短信模板引用的渠道。
| 列 | 说明 |
|---|---|
| 编号 / 短信签名 | 渠道编号与短信落款签名 |
| 渠道编码 | 服务商类型标识 |
| 短信 API 的账号 / 密钥 | 服务商侧的 AccessKey 凭证 |
| 短信发送回调 URL | 接收服务商发送回执的地址 |
| 启用状态 / 备注 | 启停与说明 |

业务规则:
- 短信签名需先在服务商后台报备通过,此处填写须与服务商侧完全一致;
- API 密钥是敏感凭证,注意权限管控与保密,泄露后应立即在服务商侧禁用并更换;
- 停用渠道后,引用该渠道的短信模板将无法发送。
数据变动:写入短信渠道表。渠道被短信模板的"短信渠道"字段引用;发送回执通过回调 URL 写入短信日志的接收状态。
7.2 短信模板
菜单入口:消息中心 → 短信模板。
维护短信正文模板,业务代码按模板编码调起发送,传参渲染占位符。
页面操作:
- 查询:按短信类型、开启状态、模板编码、短信 API 的模板编号、短信渠道、创建时间过滤,搜索执行、重置清空条件;
- 新增:填写模板编码、模板名称、模板内容(用
{code}之类占位符)、短信类型(验证码/通知)、状态、短信 API 的模板编号、短信渠道、备注; - 修改(行内):调整模板内容或换绑渠道;
- 测试(行内):指定手机号试发一条,用于验证渠道凭证与模板编号是否正确(正式配置完成后必做);
- 删除(行内)/ 批量删除:删除未被业务引用的模板;
- 导出:导出模板清单(Excel)。
| 列 | 说明 |
|---|---|
| 模板编码 / 模板名称 | 系统侧标识(业务代码按此调用) |
| 模板内容 | 短信正文,含 {code} 等占位符 |
| 短信类型 | 验证码 / 通知 |
| 短信 API 的模板编号 | 服务商侧审核通过的模板 ID |
| 短信渠道 / 状态 | 使用的渠道与启停 |

业务规则:
- 模板内容中的占位符(如
{code})由业务代码传参渲染,占位符名必须与代码传参一致,否则发送内容缺值; - "短信 API 的模板编号"必须与服务商侧已审核通过的模板 ID 完全一致,否则服务商拒发;
- 验证码类模板用于登录/找回密码等场景,通知类模板用于业务提醒。
数据变动:写入短信模板表。模板被登录验证码、业务通知等场景的发送逻辑引用;每次按模板发送会在短信日志生成一条记录。
7.3 短信日志
菜单入口:消息中心 → 短信日志。
记录每一次短信发送的完整流水(含发送与接收回执),是排查"收不到短信"的第一入口。
页面操作:
- 查询:按手机号、短信渠道、模板编号、发送状态、发送时间、接收状态、接收时间过滤,搜索执行、重置清空条件;
- 详情(行内):查看单条日志的完整报文;
- 导出:导出日志(Excel)。
| 列 | 说明 |
|---|---|
| 手机号 / 短信内容 | 接收方与渲染后的正文 |
| 发送状态 / 接收状态 | 平台是否发出、用户终端是否收到(回执) |
| 短信渠道 / 模板编号 / 短信类型 | 发送所用的通道与模板 |

业务规则:
- 日志由系统发送时自动落库,页面只读,仅支持查询与导出;
- 发送成功但接收失败,多为运营商拦截或号码异常;发送失败则优先检查渠道密钥与模板编号(见三方登录与三方集成 FAQ)。
数据变动:只读页面,不产生配置变更;数据由短信发送动作自动写入,接收状态由服务商回调更新。
7.4 邮箱账号
菜单入口:消息中心 → 邮箱账号。
配置发件邮箱的 SMTP 参数,是邮件发送的"通道"。
页面操作:
- 查询:按邮箱、用户名过滤,查询执行、重置清空条件;
- 新增:填写邮箱(发件地址)、用户名、密码(邮箱授权码而非登录密码)、SMTP 服务器域名、SMTP 服务器端口、是否开启 SSL、是否开启 STARTTLS;
- 编辑(行内)/ 删除(行内)/ 批量删除;
- 详情(行内):查看账号完整配置。
| 列 | 说明 |
|---|---|
| 邮箱 / 用户名 | 发件地址与账号名 |
| SMTP 服务器域名 / 端口 | 如 smtp.exmail.qq.com / 465 |
| 是否开启 SSL / STARTTLS | 加密传输开关 |

业务规则:
- QQ 企业邮、163 等邮箱的"密码"一般为授权码(在邮箱后台生成),不是邮箱登录密码;
- 端口与加密方式须匹配:465 对应 SSL,587 对应 STARTTLS,25 为不加密(不建议);
- 邮件模板发送时选择账号作为发件人,删除账号前需确认无模板引用。
数据变动:写入邮箱账号表。账号被邮件模版的"邮箱账号"字段引用;每次发信在邮件记录生成流水。
7.5 邮件模版
菜单入口:消息中心 → 邮件模版。
维护邮件的标题与正文模板,绑定发件账号。
页面操作:
- 查询:按模板编码、模板名称、邮箱账号、开启状态、创建时间过滤,查询执行、重置清空条件;
- 新增:填写模板编码、模板名称、模板标题(支持
{var}占位符)、模板内容(支持{var}占位符)、邮箱账号(发件人)、发送人名称、开启状态; - 编辑(行内)/ 删除(行内)/ 批量删除;
- 测试(行内):指定收件邮箱试发一封,验证账号与模板配置。
| 列 | 说明 |
|---|---|
| 模板编码 / 模板名称 | 系统侧标识 |
| 模板标题 / 模板内容 | 邮件标题与正文,含 {var} 占位符 |
| 邮箱账号 / 发送人名称 | 发件账号与显示名 |
| 开启状态 | 停用后该模板不再发送 |

业务规则:
- 标题与正文中的
{var}占位符由业务代码传参渲染,新增变量需与代码约定一致; - 每个模板必须绑定一个邮箱账号作为发件人;
- 配置完成后先用测试按钮试发,能收到再投入使用。
数据变动:写入邮件模板表。模板被审批通知、账单提醒等业务发信场景引用;每次发送在邮件记录生成流水。
7.6 邮件记录
菜单入口:消息中心 → 邮件记录。
记录每封邮件的发送流水,用于排查发送失败。
页面操作:
- 查询:按发送时间、用户编号、用户类型、发送状态、邮箱账号、模板编号过滤,查询执行、重置清空条件。
| 列 | 说明 |
|---|---|
| 接收邮箱 / 邮件标题 | 收件人与标题 |
| 发送状态 | 成功 / 失败 |
| 发送邮箱地址 / 模板编号 | 发件账号与所用模板 |

业务规则:
- 只读日志,页面无编辑/删除入口;
- 发送失败的常见原因:SMTP 参数错误、SSL/端口不匹配、授权码失效(排查见常见问题)。
数据变动:只读页面;数据由邮件发送动作自动写入。
7.7 站内信模板管理
菜单入口:消息中心 → 站内信模板管理。
维护系统内消息(页头铃铛通知)的模板。
页面操作:
- 查询:按模板名称、模板编号、状态、创建时间过滤,搜索执行、重置清空条件;
- 新增:填写模板编码、模板名称、类型(通知/公告)、发送人名称、模板内容(支持占位符)、开启状态、备注;
- 修改(行内)/ 删除(行内)/ 批量删除;
- 测试(行内):指定接收用户试发一条,到该用户的铃铛通知里确认。
| 列 | 说明 |
|---|---|
| 模板编码 / 模板名称 | 系统侧标识 |
| 类型 | 通知 / 公告 |
| 发送人名称 / 模板内容 | 消息显示的来源与正文 |
| 开启状态 / 备注 | 停用后不发送 |

业务规则:
- 站内信是系统内触达,不依赖外部服务商,配置成本最低,适合审批提醒、公告类消息;
- 模板内容支持占位符传参渲染;
- 站内信与短信/邮件可组合使用:同一事件既发站内信又发短信。
数据变动:写入站内信模板表。模板被审批待办、公告推送等场景引用;每次发送在站内信消息记录生成流水。
7.8 站内信消息记录
菜单入口:消息中心 → 站内信消息记录。
记录每条站内信的发送与阅读情况。
页面操作:
- 查询:按用户编号、用户类型、模板编码、模版类型、创建时间过滤,搜索执行、重置清空条件;
- 详情(行内):查看单条消息的完整内容与参数。
| 列 | 说明 |
|---|---|
| 用户类型 / 用户编号 | 接收人 |
| 模板编码 / 模版类型 / 模版内容 / 模版参数 | 所用模板与渲染结果 |
| 是否已读 / 阅读时间 | 用户的阅读状态跟踪 |

业务规则:
- 只读日志,不支持修改或删除;
- "是否已读/阅读时间"用于跟踪触达效果,判断消息是否被用户看到。
数据变动:只读页面;数据由站内信发送动作自动写入,用户点击阅读后回填阅读状态。
📖 相关文档
- 字典与地区(短信类型、通知类型等取值来源于字典)
- 三方登录与三方集成(钉钉/企微应用消息推送的三方发送记录)
- 审计日志与 OAuth2
- 使用手册首页
