已集成懒猫 oidc 登录，或默认账号admin/123456 Message Nest 是一个消息推送聚合平台。它把邮件、钉钉、企业微信、飞书、Telegram、Bark、PushMe 等通知渠道集中管理起来，并对外提供统一的 HTTP API。你只需要在后台配置好渠道和任务，后续脚本、系统、监控程序就可以通过一个接口把消息发送到多个渠道。 ## 基本使用流程 更多配置可参考官方文档：https://engigu.github.io/Message-Push-Nest/guide/features.html 推荐按下面顺序配置： 1. 进入“发信渠道”，新增至少一个渠道。 2. 进入“发信任务”，创建一个任务。 3. 在任务中绑定刚创建的渠道，并配置消息格式、收件人或动态接收者。 4. 在任务列表点击“接口”，复制生成的 API Token。 5. 用 API Token 调用 `/api/v1/message/send` 发送消息。 6. 在“发信日志”和“数据统计”里查看发送结果。 ## 配置发信渠道 “发信渠道”用于保存具体的推送通道配置。常见渠道包括： - 邮件 SMTP：适合系统通知、验证码、告警邮件。建议使用邮箱授权码，不要直接使用邮箱登录密码。 - 钉钉机器人：适合钉钉群告警、任务通知、日报推送。 - 企业微信机器人：适合企业微信群通知、运维告警。 - 飞书机器人：适合飞书群通知。 - Telegram、Bark、PushMe 等：适合个人设备或移动端提醒。 新增渠道后，可以先使用页面里的测试功能确认渠道配置可用，再绑定到任务或模板。 ## 创建发信任务 “发信任务”是 V1 API 的发送入口。一个任务可以绑定一个或多个渠道实例。 操作步骤： 1. 打开“发信任务”。 2. 点击“新增任务”，填写任务名称。 3. 在任务列表点击“编辑”。 4. 搜索并选择已创建的发信渠道。 5. 根据渠道填写实例配置。 6. 选择消息格式：Text、HTML 或 Markdown。 7. 保存后点击“接口”，复制 Token 和调用示例。 如果使用邮件群发，可以在实例配置里启用“动态接收者模式”。启用后，API 请求里必须传 `recipients` 数组。 ## 通过 API 发送消息 当前懒猫清单已放行 `/api/v1/message/send`，外部脚本可以不登录懒猫账号，直接使用任务 Token 调用该接口。 示例： ```bash curl -X POST --location 'https://message-nest.lazydog.heiyu.space/api/v1/message/send' \ --header 'Content-Type: application/json' \ --data '{ "token": "替换为任务页面生成的 Token", "title": "message title", "text": "Hello World!" }' ``` 邮件动态接收者示例： ```bash curl -X POST --location 'https://message-nest.lazydog.heiyu.space/api/v1/message/send' \ --header 'Content-Type: application/json' \ --data '{ "token": "替换为任务页面生成的 Token", "title": "系统维护通知", "text": "系统将于今晚 22:00 维护，预计持续 2 小时。", "recipients": [ "user1@example.com", "user2@example.com" ] }' ``` 支持的正文格式： - `text`：纯文本，兼容性最好。 - `html`：适合邮件富文本。 - `markdown`：适合钉钉、企业微信、飞书等机器人渠道。 可以同时传多种格式，系统会根据任务实例配置选择合适内容。