自托管消息
自托管消息功能将 Message Nest 作为消息接收平台,用户登录站点查看消息。
功能概述
核心定位: 将 Message Nest 站点作为消息接收和展示平台,而不是推送到外部渠道。
主要功能:
- ✅ 站点作为消息接收平台
- ✅ 用户登录后台查看消息
- ✅ 搜索消息
- ✅ 查看消息详情
与其他渠道的区别:
- 邮件/钉钉/企业微信 - 推送到外部平台,用户在对应平台查看
- 自托管消息 - 存储在 Message Nest 站点,用户登录站点查看
配置自托管消息渠道
创建渠道
- 登录管理后台
- 进入"推送渠道"页面
- 点击"新建渠道"
- 选择渠道类型:"自托管消息"
- 填写渠道名称和描述
- 保存渠道
配置参数
| 参数 | 说明 | 必填 |
|---|---|---|
| 渠道名称 | 自定义渠道名称 | 是 |
| 渠道描述 | 渠道用途说明 | 否 |
使用自托管消息
方式一:通过任务发送
- 创建发送任务
- 添加自托管消息渠道实例
- 通过 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": "您有一条新消息"
}'方式二:通过模板发送(推荐)
- 创建消息模板
- 为模板添加自托管消息实例
- 通过 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"
}
}'查看消息
消息列表
- 登录管理后台
- 进入"托管消息"页面
- 查看消息列表
列表信息:
| 列 | 说明 |
|---|---|
| ID | 消息 ID |
| 消息标题 | 消息标题(可点击查看完整内容) |
| 消息内容 | 消息内容(可点击查看完整内容) |
| 创建时间 | 消息接收时间 |
| 详情 | 查看按钮 |
搜索消息
在消息列表页面的搜索框中输入关键词,可以搜索消息标题和内容。
查看详情
点击消息行的"查看"按钮,在侧边栏中查看消息完整信息:
- 标题
- 内容
- URL(如果有)
- 创建时间
- 修改时间
使用场景
场景 1:站内消息中心
将 Message Nest 作为网站/应用的消息中心,用户登录站点查看消息。
适用于:
- 系统公告
- 用户通知
- 订单状态更新
场景 2:内部通知平台
团队内部的工作通知集中管理,成员登录站点查看。
适用于:
- 审批通知
- 任务分配
- 会议提醒
场景 3:消息归档
所有发送的消息都存储在站点,便于查询和追溯。
适用于:
- 消息记录
- 审计追溯
- 历史查询
注意事项
重要提示
- 存储空间 - 消息不会自动清理,注意定期手动清理
- 查看方式 - 用户需要登录 Message Nest 站点才能查看消息
- 消息格式 - 支持 Text、HTML、Markdown 格式
- 权限控制 - 确保只有授权用户可以登录查看