消息通知
消息通知模块是 Chameleon 平台中负责构建与管理各类消息通知的核心组件。它为开发人员和系统管理员提供了一个直观且灵活的界面，用于自定义系统消息、系统待办、邮件、短信等多种渠道的消息主题和内容。通过该模块，用户可以轻松实现消息通知的个性化配置，确保不同场景下消息的准确传达。
概述
消息通知是业务系统中重要的沟通工具。通过消息通知，可以及时将重要信息推送给用户，提高业务处理效率。Chameleon 平台提供了完整的消息通知解决方案，支持：
- 站内消息：平台内部的消息推送
- 系统待办：审批等待办事项提醒
- 邮件通知：通过邮件发送通知
- 短信通知：通过短信发送通知
消息通知的核心价值
- 及时触达：重要信息第一时间通知用户
- 多渠道推送：支持站内信、邮件、短信等多种渠道
- 业务联动：与审批流、业务流程深度集成
- 可追溯：完整的消息发送和阅读记录
独立开关控制
每种消息类型支持独立的开关，可以根据业务需要开启或关闭：
| 消息渠道 | 说明 | 开关控制 |
|---|---|---|
| 站内消息 | 平台内部消息推送 | 可独立开启/关闭 |
| 系统待办 | 待办事项提醒 | 可独立开启/关闭 |
| 邮件通知 | 邮件发送 | 可独立开启/关闭 |
| 短信通知 | 短信发送 | 可独立开启/关闭 |
消息类型
| 类型 | 说明 | 典型场景 |
|---|---|---|
| 系统通知 | 系统自动发送的通知 | 系统维护、版本更新 |
| 审批通知 | 审批流程相关通知 | 待审批、审批结果 |
| 业务通知 | 业务事件触发的通知 | 订单状态变更、任务分配 |
| 公告通知 | 全员公告消息 | 公司公告、政策通知 |
消息状态
消息模板
消息模板用于统一消息格式，支持占位符动态填充内容。
模板配置
创建消息模板，统一消息格式：
| 配置项 | 说明 |
|---|---|
| 模板编码 | 模板的唯一标识 |
| 模板名称 | 模板的显示名称 |
| 消息类型 | 消息的业务类型 |
| 消息标题 | 消息的标题模板 |
| 消息内容 | 消息的内容模板 |
支持的占位符类型
消息模板支持占位符，根据上下文参数动态填充内容。
通用字段占位符
由 {xxx} 构成，参数可从上下文中获取自动填充。
示例：
标题：审批待处理通知
内容：您有一条{type}待审批，申请人：{applicant}，请及时处理。
对象字段占位符
由 {Model.field_code} 构成，发送待办时，会自动通过 BizDataId 和 MetaObjectId 上下文参数获取业务数据，并从数据中提取对应字段进行填充。
示例：
标题：订单审批通知
内容：订单编号：{Model.order_no}，金额：{Model.amount}，请审批。
上下文参数
上下文参数可以通过上游组件自动赋值或通过脚本组件手动赋值：
{
"BizDataId": "ffb830be-7a75-4fa1-9aa4-4acf716a27ce",
"MetaObjectId": "60ce31a5-2a0d-4946-b699-24da06bdf2db",
"MetaObjectCode": "User.Information",
"WorkFlowLaunchUserId": "d7c7bdb0-9c1c-43a0-bb9b-8e556da49c23"
}
| 参数 | 说明 |
|---|---|
| BizDataId | 业务数据ID |
| MetaObjectId | 实体对象ID |
| MetaObjectCode | 实体对象编码 |
| WorkFlowLaunchUserId | 流程发起人ID |
消息属性
| 属性 | 说明 | 必填 |
|---|---|---|
| 标题 | 消息标题 | 是 |
| 内容 | 消息正文 | 是 |
| 类型 | 消息类型 | 是 |
| 接收人 | 消息接收者 | 是 |
| 发送人 | 消息发送者 | 否 |
| 发送时间 | 消息发送时间 | 自动 |
| 状态 | 已读/未读 | 自动 |
| 关联数据 | 关联的业务数据 | 否 |
| 跳转链接 | 点击跳转的地址 | 否 |
消息中心
用户可在消息中心查看所有消息：
消息列表
- 全部消息：显示所有消息
- 未读消息：仅显示未读消息
- 已读消息：仅显示已读消息
- 按类型筛选：按消息类型过滤
消息操作
| 操作 | 说明 |
|---|---|
| 标记已读 | 将消息标记为已读 |
| 全部已读 | 将所有未读消息标记为已读 |
| 删除消息 | 删除指定消息 |
| 查看详情 | 查看消息详细内容 |
消息设置
用户可以配置消息接收偏好：
| 设置项 | 说明 |
|---|---|
| 接收站内消息 | 是否接收站内消息 |
| 接收邮件通知 | 是否接收邮件通知 |
| 消息提醒方式 | 浏览器通知、声音提醒等 |
消息发送
通过平台接口发送
使用"消息通知"组件发送消息：
- 在平台接口中添加"消息通知"组件
- 配置消息接收人
- 设置消息标题和内容
- 选择通知方式
- 保存并执行接口
通过数据事件发送
配置数据变更事件自动发送消息：
| 事件 | 触发条件 |
|---|---|
| 新增后 | 数据新增后发送通知 |
| 更新后 | 数据更新后发送通知 |
| 审批状态变更 | 审批状态变更时发送通知 |
通知配置
发送规则
配置消息发送规则：
| 规则 | 说明 |
|---|---|
| 立即发送 | 消息创建后立即发送 |
| 定时发送 | 指定时间发送消息 |
| 条件发送 | 满足条件时发送消息 |
通知方式
| 方式 | 说明 | 配置要求 |
|---|---|---|
| 站内信 | 平台内部消息 | 无需额外配置 |
| 邮件 | 发送邮件通知 | 配置邮件服务器 |
| 短信 | 发送短信通知 | 配置短信网关 |
| 企业微信 | 推送到企业微信 | 配置企业微信应用 |
| 钉钉 | 推送到钉钉 | 配置钉钉机器人 |
最佳实践
消息设计
- 标题简洁明了，突出重点
- 内容包含关键信息和操作指引
- 提供跳转链接，方便用户处理
发送策略
- 避免频繁发送，控制消息数量
- 重要消息使用多渠道通知
- 合理使用消息模板和占位符
用户体验
- 提供消息分类和筛选功能
- 支持消息免打扰设置
- 及时清理过期消息