9.0 KiB
9.0 KiB
推送渠道配置
Message Nest 支持多种消息推送渠道，您可以根据需求配置不同的渠道，实现多渠道消息推送。
邮件（SMTP）
通过标准 SMTP 协议发送邮件通知。
配置参数
| 参数 | 说明 | 示例 |
|---|---|---|
| 渠道名称 | 自定义渠道名称 | 公司邮箱 |
| SMTP 服务器 | 邮件服务器地址 | smtp.gmail.com |
| SMTP 端口 | 服务器端口 | 587 (TLS) 或 465 (SSL) |
| 发件人邮箱 | 发送邮件的邮箱地址 | noreply@example.com |
| 发件人名称 | 显示的发件人名称 | 系统通知 |
| 邮箱密码 | 邮箱密码或授权码 | your_password |
| 加密方式 | TLS/SSL/无 | TLS |
常见邮箱配置
Gmail
- SMTP 服务器:
smtp.gmail.com - 端口:
587(TLS) - 注意: 需要开启"允许不够安全的应用"或使用应用专用密码
QQ 邮箱
- SMTP 服务器:
smtp.qq.com - 端口:
587(TLS) 或465(SSL) - 注意: 需要在邮箱设置中开启 SMTP 服务并获取授权码
163 邮箱
- SMTP 服务器:
smtp.163.com - 端口:
465(SSL) - 注意: 需要开启 SMTP 服务并使用授权码
企业邮箱
根据企业邮箱服务商提供的 SMTP 配置填写。
使用场景
- ✅ 用户注册/登录通知
- ✅ 订单确认和物流通知
- ✅ 账单和发票发送
- ✅ 密码重置和安全提醒
- ✅ 营销邮件和活动通知
注意事项
::: warning 注意
- 邮件发送可能会被识别为垃圾邮件，建议配置 SPF、DKIM 等记录
- 使用授权码而非邮箱密码，提高安全性
- 注意邮件发送频率限制，避免被封禁
- 建议使用企业邮箱，稳定性更好 :::
钉钉机器人
通过钉钉群机器人发送消息到钉钉群。
配置步骤
-
创建钉钉群
- 在钉钉中创建一个群聊
-
添加自定义机器人
- 进入群设置 → 智能群助手 → 添加机器人 → 自定义
- 设置机器人名称和头像
-
配置安全设置
- 选择"自定义关键词"或"加签"方式
- 记录 Webhook 地址
-
在 Message Nest 中配置
- 渠道名称：自定义名称
- Webhook URL：复制的 Webhook 地址
- 安全设置：根据选择填写关键词或密钥
配置参数
| 参数 | 说明 | 必填 |
|---|---|---|
| 渠道名称 | 自定义渠道名称 | 是 |
| Webhook URL | 机器人 Webhook 地址 | 是 |
| 安全关键词 | 自定义关键词（如选择此方式） | 否 |
| 加签密钥 | 加签密钥（如选择此方式） | 否 |
消息格式
钉钉支持以下格式：
- Text - 纯文本
- Markdown - 支持 Markdown 格式
@提醒功能
支持@群成员：
- @手机号 - 通过手机号@指定成员
- @所有人 - @群内所有成员（需要机器人权限）
使用场景
- ✅ 系统告警和监控通知
- ✅ 任务完成提醒
- ✅ 审批流程通知
- ✅ 团队协作消息
- ✅ 日报/周报推送
注意事项
::: warning 注意
- 每个机器人每分钟最多发送 20 条消息
- @所有人功能需要群主授权
- 建议在消息中包含安全关键词，避免发送失败
- 机器人被移除后 Webhook 将失效 :::
企业微信机器人
通过企业微信群机器人发送消息到企业微信群。
配置步骤
-
创建企业微信群
- 在企业微信中创建群聊
-
添加群机器人
- 进入群设置 → 群机器人 → 添加机器人
- 设置机器人名称
-
获取 Webhook
- 复制 Webhook 地址
-
在 Message Nest 中配置
- 渠道名称：自定义名称
- Webhook URL：复制的 Webhook 地址
配置参数
| 参数 | 说明 | 必填 |
|---|---|---|
| 渠道名称 | 自定义渠道名称 | 是 |
| Webhook URL | 机器人 Webhook 地址 | 是 |
消息格式
企业微信支持以下格式：
- Text - 纯文本
- Markdown - 支持 Markdown 格式
@提醒功能
支持@群成员：
- @用户ID - 通过用户ID@指定成员
- @手机号 - 通过手机号@指定成员
- @所有人 - @群内所有成员
使用场景
- ✅ 企业内部通知
- ✅ 项目进度更新
- ✅ 系统运维告警
- ✅ 工作流审批提醒
- ✅ 会议和日程通知
注意事项
::: warning 注意
- 每个机器人每分钟最多发送 20 条消息
- 消息内容不能包含敏感词
- 机器人被移除后 Webhook 将失效
- 建议使用 Markdown 格式，展示效果更好 :::
微信测试公众号
通过微信测试公众号发送模板消息。
配置步骤
-
申请测试公众号
- 访问 微信公众平台测试号
- 使用微信扫码登录
-
获取配置信息
- appID：测试号信息中的 appID
- appsecret：测试号信息中的 appsecret
-
添加模板消息
- 在"模板消息接口"中添加模板
- 记录模板 ID
-
关注测试公众号
- 使用微信扫描测试号二维码关注
- 记录用户的 OpenID
-
在 Message Nest 中配置
- 填写 appID、appsecret、模板ID、OpenID
配置参数
| 参数 | 说明 | 必填 |
|---|---|---|
| 渠道名称 | 自定义渠道名称 | 是 |
| appID | 测试公众号 appID | 是 |
| appsecret | 测试公众号 appsecret | 是 |
| 模板ID | 模板消息 ID | 是 |
| OpenID | 接收用户的 OpenID | 是 |
使用场景
- ✅ 个人项目测试
- ✅ 小范围通知
- ✅ 开发环境调试
注意事项
::: warning 注意
- 测试公众号仅供开发测试使用，不能用于生产环境
- 测试公众号有关注人数限制（100人）
- 模板消息格式需要符合微信规范
- 正式使用需要申请正式公众号 :::
自定义 Webhook
向自定义的 HTTP 接口发送消息。
配置参数
| 参数 | 说明 | 必填 |
|---|---|---|
| 渠道名称 | 自定义渠道名称 | 是 |
| Webhook URL | 目标 HTTP 接口地址 | 是 |
| 请求方法 | GET/POST/PUT 等 | 是 |
| 请求头 | 自定义 HTTP 请求头 | 否 |
| 请求体模板 | 自定义请求体格式 | 否 |
请求体模板
支持使用变量：
{{title}}- 消息标题{{text}}- 纯文本内容{{html}}- HTML 内容{{markdown}}- Markdown 内容
示例：
{
"message": "{{title}}",
"content": "{{text}}",
"timestamp": "{{timestamp}}"
}
使用场景
- ✅ 集成第三方系统
- ✅ 自建消息服务
- ✅ 对接其他通知平台
- ✅ 自定义消息处理逻辑
注意事项
::: tip 提示
- 确保目标接口可访问
- 注意接口的请求频率限制
- 建议添加认证信息保证安全
- 可以通过请求头传递 Token 等认证信息 :::
自托管消息
将 Message Nest 站点作为消息接收平台，用户登录站点查看消息。
核心定位
与其他渠道的区别：
- 邮件/钉钉/企业微信 - 推送到外部平台
- 自托管消息 - 存储在 Message Nest 站点，用户登录站点查看
配置参数
| 参数 | 说明 | 必填 |
|---|---|---|
| 渠道名称 | 自定义渠道名称 | 是 |
| 渠道描述 | 渠道用途说明 | 否 |
功能特点
- ✅ 站点作为消息接收平台
- ✅ 无需外部依赖
- ✅ 消息集中存储和管理
- ✅ 支持多种格式展示（Text/HTML/Markdown）
- ✅ 支持消息搜索和筛选
- ✅ 支持消息已读/未读状态
使用场景
- ✅ 站内消息中心
- ✅ 系统公告发布
- ✅ 内部工作流通知
- ✅ 系统告警记录
- ✅ 消息归档平台
查看消息
- 登录 Message Nest 站点
- 进入"自托管消息"或"消息中心"页面
- 查看接收到的消息列表
- 点击消息查看详情
注意事项
::: tip 提示
- 消息不会自动清理，需要手动清理
- 建议定期清理不需要的消息，避免占用过多存储空间
- 可以根据需要导出消息记录
- 适合作为消息的集中查看和管理平台 :::
渠道管理
创建渠道
- 登录管理后台
- 进入"推送渠道"页面
- 点击"新建渠道"
- 选择渠道类型
- 填写配置信息
- 保存并测试
测试渠道
创建渠道后，建议先进行测试：
- 在渠道列表中找到新建的渠道
- 点击"测试"按钮
- 发送测试消息
- 确认消息正常接收
编辑和删除
- 编辑：点击渠道的"编辑"按钮，修改配置信息
- 删除：点击"删除"按钮，确认后删除（注意：删除后关联的任务和模板将无法使用该渠道）
最佳实践
- 命名规范 - 使用清晰的渠道名称，便于识别
- 分类管理 - 按用途或环境分类（如：生产环境邮件、测试环境钉钉）
- 定期检查 - 定期检查渠道配置是否有效
- 安全管理 - 妥善保管密钥和密码信息
- 备用渠道 - 配置多个渠道作为备用，提高可靠性