Skip to content

自托管消息

自托管消息功能将 Message Nest 作为消息接收平台,用户登录站点查看消息。

功能概述

核心定位: 将 Message Nest 站点作为消息接收和展示平台,而不是推送到外部渠道。

主要功能:

  • ✅ 站点作为消息接收平台
  • ✅ 用户登录后台查看消息
  • ✅ 搜索消息
  • ✅ 查看消息详情

与其他渠道的区别:

  • 邮件/钉钉/企业微信 - 推送到外部平台,用户在对应平台查看
  • 自托管消息 - 存储在 Message Nest 站点,用户登录站点查看

配置自托管消息渠道

创建渠道

  1. 登录管理后台
  2. 进入"推送渠道"页面
  3. 点击"新建渠道"
  4. 选择渠道类型:"自托管消息"
  5. 填写渠道名称和描述
  6. 保存渠道

配置参数

参数说明必填
渠道名称自定义渠道名称
渠道描述渠道用途说明

使用自托管消息

方式一:通过任务发送

  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": "您有一条新消息"
  }'

方式二:通过模板发送(推荐)

  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"
    }
  }'

查看消息

消息列表

  1. 登录管理后台
  2. 进入"托管消息"页面
  3. 查看消息列表

列表信息:

说明
ID消息 ID
消息标题消息标题(可点击查看完整内容)
消息内容消息内容(可点击查看完整内容)
创建时间消息接收时间
详情查看按钮

搜索消息

在消息列表页面的搜索框中输入关键词,可以搜索消息标题和内容。

查看详情

点击消息行的"查看"按钮,在侧边栏中查看消息完整信息:

  • 标题
  • 内容
  • URL(如果有)
  • 创建时间
  • 修改时间

使用场景

场景 1:站内消息中心

将 Message Nest 作为网站/应用的消息中心,用户登录站点查看消息。

适用于:

  • 系统公告
  • 用户通知
  • 订单状态更新

场景 2:内部通知平台

团队内部的工作通知集中管理,成员登录站点查看。

适用于:

  • 审批通知
  • 任务分配
  • 会议提醒

场景 3:消息归档

所有发送的消息都存储在站点,便于查询和追溯。

适用于:

  • 消息记录
  • 审计追溯
  • 历史查询

注意事项

重要提示

  1. 存储空间 - 消息不会自动清理,注意定期手动清理
  2. 查看方式 - 用户需要登录 Message Nest 站点才能查看消息
  3. 消息格式 - 支持 Text、HTML、Markdown 格式
  4. 权限控制 - 确保只有授权用户可以登录查看

下一步

Released under the MIT License.