# 推送渠道配置

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 等记录
- 使用授权码而非邮箱密码，提高安全性
- 注意邮件发送频率限制，避免被封禁
- 建议使用企业邮箱，稳定性更好
:::

## 钉钉机器人

通过钉钉群机器人发送消息到钉钉群。

### 配置步骤

1. **创建钉钉群**
   - 在钉钉中创建一个群聊

2. **添加自定义机器人**
   - 进入群设置 → 智能群助手 → 添加机器人 → 自定义
   - 设置机器人名称和头像

3. **配置安全设置**
   - 选择"自定义关键词"或"加签"方式
   - 记录 Webhook 地址

4. **在 Message Nest 中配置**
   - 渠道名称：自定义名称
   - Webhook URL：复制的 Webhook 地址
   - 安全设置：根据选择填写关键词或密钥

### 配置参数

| 参数 | 说明 | 必填 |
|------|------|------|
| 渠道名称 | 自定义渠道名称 | 是 |
| Webhook URL | 机器人 Webhook 地址 | 是 |
| 安全关键词 | 自定义关键词（如选择此方式） | 否 |
| 加签密钥 | 加签密钥（如选择此方式） | 否 |

### 消息格式

钉钉支持以下格式：
- **Text** - 纯文本
- **Markdown** - 支持 Markdown 格式

### @提醒功能

支持@群成员：
- **@手机号** - 通过手机号@指定成员
- **@所有人** - @群内所有成员（需要机器人权限）

### 使用场景

- ✅ 系统告警和监控通知
- ✅ 任务完成提醒
- ✅ 审批流程通知
- ✅ 团队协作消息
- ✅ 日报/周报推送

### 注意事项

::: warning 注意
- 每个机器人每分钟最多发送 20 条消息
- @所有人功能需要群主授权
- 建议在消息中包含安全关键词，避免发送失败
- 机器人被移除后 Webhook 将失效
:::

## 企业微信机器人

通过企业微信群机器人发送消息到企业微信群。

### 配置步骤

1. **创建企业微信群**
   - 在企业微信中创建群聊

2. **添加群机器人**
   - 进入群设置 → 群机器人 → 添加机器人
   - 设置机器人名称

3. **获取 Webhook**
   - 复制 Webhook 地址

4. **在 Message Nest 中配置**
   - 渠道名称：自定义名称
   - Webhook URL：复制的 Webhook 地址

### 配置参数

| 参数 | 说明 | 必填 |
|------|------|------|
| 渠道名称 | 自定义渠道名称 | 是 |
| Webhook URL | 机器人 Webhook 地址 | 是 |

### 消息格式

企业微信支持以下格式：
- **Text** - 纯文本
- **Markdown** - 支持 Markdown 格式

### @提醒功能

支持@群成员：
- **@用户ID** - 通过用户ID@指定成员
- **@手机号** - 通过手机号@指定成员
- **@所有人** - @群内所有成员

### 使用场景

- ✅ 企业内部通知
- ✅ 项目进度更新
- ✅ 系统运维告警
- ✅ 工作流审批提醒
- ✅ 会议和日程通知

### 注意事项

::: warning 注意
- 每个机器人每分钟最多发送 20 条消息
- 消息内容不能包含敏感词
- 机器人被移除后 Webhook 将失效
- 建议使用 Markdown 格式，展示效果更好
:::

## 微信测试公众号

通过微信测试公众号发送模板消息。

### 配置步骤

1. **申请测试公众号**
   - 访问 [微信公众平台测试号](https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login)
   - 使用微信扫码登录

2. **获取配置信息**
   - appID：测试号信息中的 appID
   - appsecret：测试号信息中的 appsecret

3. **添加模板消息**
   - 在"模板消息接口"中添加模板
   - 记录模板 ID

4. **关注测试公众号**
   - 使用微信扫描测试号二维码关注
   - 记录用户的 OpenID

5. **在 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 内容

**示例：**

```json
{
  "message": "{{title}}",
  "content": "{{text}}",
  "timestamp": "{{timestamp}}"
}
```

### 使用场景

- ✅ 集成第三方系统
- ✅ 自建消息服务
- ✅ 对接其他通知平台
- ✅ 自定义消息处理逻辑

### 注意事项

::: tip 提示
- 确保目标接口可访问
- 注意接口的请求频率限制
- 建议添加认证信息保证安全
- 可以通过请求头传递 Token 等认证信息
:::

## 自托管消息

将 Message Nest 站点作为消息接收平台，用户登录站点查看消息。

### 核心定位

**与其他渠道的区别：**
- **邮件/钉钉/企业微信** - 推送到外部平台
- **自托管消息** - 存储在 Message Nest 站点，用户登录站点查看

### 配置参数

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

### 功能特点

- ✅ 站点作为消息接收平台
- ✅ 无需外部依赖
- ✅ 消息集中存储和管理
- ✅ 支持多种格式展示（Text/HTML/Markdown）
- ✅ 支持消息搜索和筛选
- ✅ 支持消息已读/未读状态

### 使用场景

- ✅ 站内消息中心
- ✅ 系统公告发布
- ✅ 内部工作流通知
- ✅ 系统告警记录
- ✅ 消息归档平台

### 查看消息

1. 登录 Message Nest 站点
2. 进入"自托管消息"或"消息中心"页面
3. 查看接收到的消息列表
4. 点击消息查看详情

### 注意事项

::: tip 提示
- 消息不会自动清理，需要手动清理
- 建议定期清理不需要的消息，避免占用过多存储空间
- 可以根据需要导出消息记录
- 适合作为消息的集中查看和管理平台
:::

## 渠道管理

### 创建渠道

1. 登录管理后台
2. 进入"推送渠道"页面
3. 点击"新建渠道"
4. 选择渠道类型
5. 填写配置信息
6. 保存并测试

### 测试渠道

创建渠道后，建议先进行测试：

1. 在渠道列表中找到新建的渠道
2. 点击"测试"按钮
3. 发送测试消息
4. 确认消息正常接收

### 编辑和删除

- **编辑**：点击渠道的"编辑"按钮，修改配置信息
- **删除**：点击"删除"按钮，确认后删除（注意：删除后关联的任务和模板将无法使用该渠道）

### 最佳实践

1. **命名规范** - 使用清晰的渠道名称，便于识别
2. **分类管理** - 按用途或环境分类（如：生产环境邮件、测试环境钉钉）
3. **定期检查** - 定期检查渠道配置是否有效
4. **安全管理** - 妥善保管密钥和密码信息
5. **备用渠道** - 配置多个渠道作为备用，提高可靠性

## 下一步

- 查看 [发送任务](/guide/tasks) 了解如何使用渠道发送消息
- 查看 [消息模板](/guide/template) 了解如何创建模板
- 查看 [API 文档](/api/v1) 了解如何通过 API 发送消息