# 自托管消息
自托管消息功能将 Message Nest 作为消息接收平台，用户登录站点查看消息。
## 功能概述
**核心定位：** 将 Message Nest 站点作为消息接收和展示平台，而不是推送到外部渠道。
**主要功能：**
- ✅ 站点作为消息接收平台
- ✅ 用户登录后台查看消息
- ✅ 搜索消息
- ✅ 查看消息详情
**与其他渠道的区别：**
- **邮件/钉钉/企业微信** - 推送到外部平台，用户在对应平台查看
- **自托管消息** - 存储在 Message Nest 站点，用户登录站点查看
## 配置自托管消息渠道
### 创建渠道
1. 登录管理后台
2. 进入"推送渠道"页面
3. 点击"新建渠道"
4. 选择渠道类型："自托管消息"
5. 填写配置信息
### 配置参数
| 参数 | 说明 | 必填 | 默认值 |
|------|------|------|--------|
| 渠道名称 | 自定义渠道名称 | 是 | - |
| 渠道描述 | 渠道用途说明 | 否 | - |
### 配置示例
```
渠道名称：站内通知
渠道描述：用户站内消息通知
```
## 使用自托管消息
### 方式一：通过任务发送
1. 创建发送任务
2. 添加自托管消息渠道实例
3. 通过 V1 API 发送消息
**API 示例：**
```bash
curl -X POST http://your-domain/api/v1/message/send \
-H "Content-Type: application/json" \
-d '{
"token": "your_task_token",
"title": "系统通知",
"text": "您有一条新消息",
"html": "系统通知
您有一条新消息
",
"markdown": "## 系统通知\n\n您有一条新消息"
}'
```
### 方式二：通过模板发送（推荐）
1. 创建消息模板
2. 为模板添加自托管消息实例
3. 通过 V2 API 发送消息
**API 示例：**
```bash
curl -X POST http://your-domain/api/v2/message/send \
-H "Content-Type: application/json" \
-d '{
"token": "your_template_token",
"title": "订单通知",
"placeholders": {
"order_id": "20241206001",
"status": "已发货"
}
}'
```
## 查看消息
### 消息列表
1. 登录管理后台
2. 进入"自托管消息"或"消息中心"页面
3. 查看消息列表
**列表信息：**
| 列 | 说明 |
|----|------|
| 状态 | 已读/未读标识 |
| 标题 | 消息标题 |
| 来源 | 发送任务或模板名称 |
| 接收时间 | 消息接收时间 |
| 操作 | 查看详情、标记已读、删除 |
### 消息筛选
支持多种筛选条件：
- **状态筛选** - 全部/未读/已读
- **时间筛选** - 今天/最近7天/最近30天/自定义
- **来源筛选** - 按任务或模板筛选
- **关键词搜索** - 搜索标题或内容
**筛选示例：**
```
状态：未读
时间：最近7天
来源：订单通知模板
关键词：发货
```
### 查看详情
点击消息标题或"查看"按钮查看消息详情：
**详情页面包含：**
- 消息标题
- 发送时间
- 来源信息
- 消息内容（根据格式展示）
- 操作按钮（标记已读、删除）
**内容展示：**
- **Text** - 纯文本展示
- **HTML** - 富文本渲染
- **Markdown** - Markdown 渲染
### 消息操作
#### 标记已读/未读
- **单个标记** - 点击消息的"标记已读"按钮
- **批量标记** - 选择多条消息，点击"批量标记已读"
- **全部已读** - 点击"全部标记为已读"
#### 删除消息
- **单个删除** - 点击消息的"删除"按钮
- **批量删除** - 选择多条消息，点击"批量删除"
- **清空消息** - 点击"清空全部消息"（谨慎操作）
::: warning 注意
删除操作不可恢复，请谨慎操作！
:::
## 消息格式
### Text 格式
纯文本格式，适用于简单通知。
**示例：**
```text
您的订单 20241206001 已发货。
快递公司：顺丰速运
快递单号：SF1234567890
预计送达：2024-12-08
如有问题请联系客服。
```
**展示效果：** 保持原始换行和格式
### HTML 格式
HTML 格式，支持富文本样式。
**示例：**
```html
订单发货通知
您的订单 20241206001 已发货。
| 快递公司： |
顺丰速运 |
| 快递单号： |
SF1234567890 |
如有问题请联系客服。
```
**展示效果：** 完整的 HTML 渲染，支持样式和布局
### Markdown 格式
Markdown 格式，支持格式化文本。
**示例：**
```markdown
## 订单发货通知
您的订单 **20241206001** 已发货。
| 项目 | 信息 |
|------|------|
| 快递公司 | 顺丰速运 |
| 快递单号 | SF1234567890 |
| 预计送达 | 2024-12-08 |
> 如有问题请联系客服。
```
**展示效果：** Markdown 渲染，支持标题、表格、引用等
## 使用场景
### 场景 1：站内消息中心
**需求：** 将 Message Nest 作为网站/应用的消息中心
**实现方案：**
1. 创建"用户通知"模板
2. 添加自托管消息渠道实例
3. 在用户操作时调用 API 发送消息到自托管渠道
4. 用户登录 Message Nest 站点查看消息
**典型应用：**
- 系统公告发布
- 账号安全提醒
- 订单状态更新
- 活动通知推送
**优势：**
- 无需开发消息中心功能
- 直接使用 Message Nest 作为消息平台
- 用户登录即可查看所有消息
### 场景 2：内部工作流通知
**需求：** 团队内部的工作流通知和待办事项集中管理
**实现方案：**
1. 创建不同类型的通知模板（审批、任务、提醒）
2. 配置自托管消息渠道
3. 工作流触发时发送消息到自托管渠道
4. 团队成员登录 Message Nest 站点查看待办
**典型应用：**
- 审批请求通知
- 任务分配提醒
- 会议提醒
- 进度更新通知
**优势：**
- 所有工作通知集中在一个平台
- 团队成员统一登录查看
- 避免消息分散在多个渠道
### 场景 3：系统告警记录平台
**需求：** 将 Message Nest 作为系统告警的集中查看平台
**实现方案：**
1. 创建"系统告警"模板
2. 配置自托管消息渠道（同时可配置钉钉/邮件用于即时通知）
3. 系统监控触发告警时发送到自托管渠道
4. 管理员登录 Message Nest 站点查看和管理告警
**典型应用：**
- 服务异常告警
- 资源使用告警
- 安全事件告警
- 性能告警
**优势：**
- 所有告警集中存储在平台
- 便于历史告警查询和分析
- 支持搜索和筛选功能
- 可导出告警数据
### 场景 4：消息归档平台
**需求：** 将 Message Nest 作为所有消息的归档和查询平台
**实现方案：**
1. 为所有任务/模板添加自托管消息渠道实例
2. 所有消息都会存储在 Message Nest 站点
3. 用户登录站点查看历史消息
4. 定期导出归档数据
**典型应用：**
- 所有发送消息的完整记录
- 消息审计和追溯
- 历史消息查询
- 数据分析和统计
**优势：**
- Message Nest 成为消息归档中心
- 所有消息集中存储和管理
- 支持强大的搜索和筛选
- 便于导出和分析
## 消息管理
### 手动清理
可以手动清理消息以释放存储空间。
**清理选项：**
- **清理已读消息** - 删除所有已读消息
- **清理过期消息** - 删除指定天数前的消息
- **清空全部消息** - 删除所有消息（谨慎操作）
**步骤：**
1. 进入"自托管消息"页面
2. 点击"清理"按钮
3. 选择清理选项
4. 确认操作
5. 等待清理完成
### 消息导出
导出消息数据用于备份或分析。
**导出格式：**
- CSV - 适合 Excel 分析
- JSON - 适合程序处理
- PDF - 适合打印存档
**导出步骤：**
1. 进入"自托管消息"页面
2. 设置筛选条件（可选）
3. 点击"导出"按钮
4. 选择导出格式
5. 下载导出文件
## 消息统计
查看消息的统计数据和趋势。
### 统计指标
| 指标 | 说明 |
|------|------|
| 总消息数 | 累计接收的消息总数 |
| 未读消息 | 当前未读消息数量 |
| 今日新增 | 今天接收的消息数 |
| 平均响应时间 | 从接收到已读的平均时间 |
| 消息来源分布 | 各任务/模板的消息占比 |
### 趋势图表
- **消息趋势** - 最近 30 天的消息接收趋势
- **来源分布** - 各来源的消息数量饼图
- **已读率** - 消息已读率变化趋势
### 查看统计
1. 进入"自托管消息"页面
2. 点击"统计"按钮
3. 查看各项统计数据
4. 可导出统计报表
## 最佳实践
### 1. 消息分类
- **按重要性分类** - 重要/一般/提示
- **按类型分类** - 通知/告警/提醒
- **使用不同模板** - 便于筛选和管理
### 2. 内容设计
- **标题简洁明了** - 让用户快速了解消息内容
- **内容结构清晰** - 使用标题、列表、表格等
- **提供操作入口** - 添加相关链接或按钮
- **适配多种格式** - 提供 Text/HTML/Markdown
### 3. 存储管理
- **定期手动清理** - 定期清理已读或过期消息，释放存储空间
- **重要消息导出备份** - 避免数据丢失
- **监控存储使用情况** - 及时清理不需要的消息
### 4. 用户体验
- **及时标记已读** - 保持消息列表整洁
- **使用筛选功能** - 快速找到需要的消息
- **定期查看消息** - 避免遗漏重要通知
- **合理设置通知** - 避免消息过载
### 5. 安全性
- **权限控制** - 确保只有授权用户可以查看
- **敏感信息加密** - 对敏感内容进行加密
- **定期审计** - 检查消息访问日志
- **数据备份** - 定期备份重要消息
## 与其他渠道对比
| 特性 | 自托管消息 | 邮件 | 钉钉/企业微信 |
|------|-----------|------|--------------|
| 实时性 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
| 到达率 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 格式支持 | Text/HTML/Markdown | Text/HTML | Text/Markdown |
| 历史查询 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 成本 | 免费 | 免费/付费 | 免费 |
| 依赖 | 无 | SMTP 服务器 | 钉钉/企业微信 |
| 适用场景 | 站内通知、归档 | 正式通知、账单 | 即时通知、协作 |
## 常见问题
### Q: 自托管消息和其他渠道有什么区别？
**A:**
- **自托管消息** - 存储在系统内，需要登录后台查看
- **其他渠道** - 推送到外部平台（邮件、钉钉等），用户在对应平台查看
### Q: 可以同时使用自托管消息和其他渠道吗？
**A:** 可以。为任务或模板同时配置多个渠道实例，消息会发送到所有渠道。
### Q: 消息会永久保存吗？
**A:** 消息会一直保存，不会自动清理。建议定期手动清理不需要的消息，并导出重要消息备份。
### Q: 如何提高消息的查看率？
**A:**
1. 配合其他渠道（如邮件、钉钉）提醒用户
2. 在应用中显示未读消息数量
3. 提供消息通知功能
4. 定期提醒用户查看
### Q: 消息被误删了怎么办？
**A:**
- 如果有备份，可以从备份恢复
- 如果配置了其他渠道，可以从其他渠道查看
- 建议定期导出重要消息
### Q: 如何在应用中集成消息中心？
**A:**
1. 调用 API 发送消息到自托管渠道
2. 提供登录入口到 Message Nest 后台
3. 或者通过 API 查询消息列表（需要开发）
4. 在应用中展示消息
## 注意事项
::: warning 重要提示
1. **存储空间** - 消息不会自动清理，注意定期手动清理，避免占用过多存储空间
2. **性能影响** - 大量消息可能影响查询性能，建议定期清理已读或过期消息
3. **权限控制** - 确保消息只能被授权用户查看
4. **数据备份** - 重要消息建议定期导出备份
5. **手动清理** - 删除操作不可恢复，请谨慎操作
:::
## 下一步
- 查看 [渠道配置](/guide/channels) 了解如何配置自托管消息渠道
- 查看 [消息模板](/guide/template) 了解如何创建模板
- 查看 [V2 API 文档](/api/v2) 了解如何发送消息