oficcejo
445 lines
10 KiB
Markdown
445 lines
10 KiB
Markdown
# Webhook通知配置指南
|
||
|
||
## 📱 功能概述
|
||
|
||
系统支持通过Webhook将通知推送到钉钉或飞书群，适用于：
|
||
- **实时监测**：股票价格触发提醒
|
||
- **智策定时分析**：板块策略分析报告
|
||
|
||
可与邮件通知同时使用，也可单独使用。
|
||
|
||
---
|
||
|
||
## 🎯 支持的平台
|
||
|
||
### 1. 钉钉群机器人
|
||
- ✅ 支持Markdown格式
|
||
- ✅ 消息样式丰富
|
||
- ✅ 配置简单
|
||
- ✅ 免费使用
|
||
|
||
### 2. 飞书群机器人
|
||
- ✅ 支持交互式卡片
|
||
- ✅ 消息展示美观
|
||
- ✅ 支持文本和富文本
|
||
- ✅ 免费使用
|
||
|
||
---
|
||
|
||
## 📝 配置步骤
|
||
|
||
### 方法一：通过Web界面配置（推荐）
|
||
|
||
1. **进入配置页面**
|
||
- 点击侧边栏"⚙️ 环境配置"
|
||
- 选择"📢 通知配置"标签页
|
||
|
||
2. **配置Webhook**
|
||
- 勾选"启用Webhook通知"
|
||
- 选择Webhook类型（钉钉/飞书）
|
||
- 填写Webhook URL
|
||
- 点击"💾 保存配置"
|
||
|
||
3. **测试配置**
|
||
- 在实时监测的"通知管理"中
|
||
- 点击"测试Webhook"按钮
|
||
- 检查群消息是否收到
|
||
|
||
### 方法二：手动编辑.env文件
|
||
|
||
```env
|
||
# Webhook通知配置
|
||
WEBHOOK_ENABLED=true
|
||
WEBHOOK_TYPE=dingtalk # 或 feishu
|
||
WEBHOOK_URL=https://oapi.dingtalk.com/robot/send?access_token=xxxxx
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 钉钉机器人配置
|
||
|
||
### 步骤1：创建群机器人
|
||
|
||
1. 打开钉钉PC端或移动端
|
||
2. 进入要接收通知的群聊
|
||
3. 点击右上角"⚙️"进入群设置
|
||
4. 选择"智能群助手" → "添加机器人"
|
||
5. 选择"自定义"机器人
|
||
|
||
### 步骤2：配置机器人
|
||
|
||
1. **机器人名称**：AI股票分析系统
|
||
2. **安全设置**（选择一种即可）：
|
||
- ✅ **推荐**：自定义关键词（例如：股票、分析、智策）
|
||
- 加签（需要额外配置）
|
||
- IP地址段（需要固定IP）
|
||
|
||
### 步骤3：获取Webhook地址
|
||
|
||
完成配置后，会显示Webhook地址：
|
||
```
|
||
https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxxxxxx
|
||
```
|
||
|
||
复制整个地址到系统配置中。
|
||
|
||
### 钉钉消息格式示例
|
||
|
||
**实时监测通知**：
|
||
```markdown
|
||
### 股票监测提醒
|
||
|
||
**股票代码**: 600519
|
||
|
||
**股票名称**: 贵州茅台
|
||
|
||
**提醒类型**: 进场提醒
|
||
|
||
**提醒内容**: 股票价格 1650.00 进入进场区间
|
||
|
||
**触发时间**: 2024-01-15 10:30:00
|
||
|
||
---
|
||
|
||
_此消息由AI股票分析系统自动发送_
|
||
```
|
||
|
||
**智策定时分析**：
|
||
```markdown
|
||
### 智策板块分析报告
|
||
**分析时间**: 2024-01-15 09:00
|
||
|
||
#### 📊 板块多空
|
||
**看多**: 人工智能(8分)、新能源汽车(8分)、半导体(7分)
|
||
**看空**: 地产开发(7分)
|
||
|
||
#### 🔄 潜力接力板块
|
||
- 半导体: 关注突破信号
|
||
- 军工: 情绪升温，把握机会
|
||
|
||
#### 🌡️ 热度TOP3
|
||
1. 人工智能 - 95分
|
||
2. 新能源汽车 - 92分
|
||
3. 半导体 - 88分
|
||
|
||
#### 💡 核心机会
|
||
重点关注人工智能、新能源汽车产业链...
|
||
|
||
---
|
||
*由智策AI系统自动生成*
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 飞书机器人配置
|
||
|
||
### 步骤1：创建群机器人
|
||
|
||
1. 打开飞书PC端或移动端
|
||
2. 进入要接收通知的群聊
|
||
3. 点击右上角"⚙️"进入群设置
|
||
4. 选择"群机器人" → "添加机器人"
|
||
5. 选择"自定义机器人"
|
||
|
||
### 步骤2：配置机器人
|
||
|
||
1. **机器人名称**：AI股票分析系统
|
||
2. **机器人描述**：股票监测和板块分析通知
|
||
3. **安全设置**（可选）：
|
||
- 签名验证（需要额外配置）
|
||
|
||
### 步骤3：获取Webhook地址
|
||
|
||
完成配置后，会显示Webhook地址：
|
||
```
|
||
https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxxxxxxxxxx
|
||
```
|
||
|
||
复制整个地址到系统配置中。
|
||
|
||
### 飞书消息格式示例
|
||
|
||
**实时监测通知**：
|
||
```
|
||
📊 股票监测提醒 - 600519
|
||
|
||
股票代码 股票名称
|
||
600519 贵州茅台
|
||
|
||
提醒类型 触发时间
|
||
进场提醒 2024-01-15 10:30:00
|
||
|
||
提醒内容
|
||
股票价格 1650.00 进入进场区间
|
||
|
||
---
|
||
此消息由AI股票分析系统自动发送
|
||
```
|
||
|
||
**智策定时分析**：
|
||
```
|
||
【智策板块分析报告】
|
||
分析时间: 2024-01-15 09:00
|
||
|
||
### 智策板块分析报告
|
||
**分析时间**: 2024-01-15 09:00
|
||
|
||
#### 📊 板块多空
|
||
**看多**: 人工智能(8分)、新能源汽车(8分)
|
||
**看空**: 地产开发(7分)
|
||
|
||
#### 🔄 潜力接力板块
|
||
- 半导体: 关注突破信号
|
||
|
||
#### 🌡️ 热度TOP3
|
||
1. 人工智能 - 95分
|
||
2. 新能源汽车 - 92分
|
||
3. 半导体 - 88分
|
||
|
||
---
|
||
*由智策AI系统自动生成*
|
||
```
|
||
|
||
---
|
||
|
||
## ⚙️ 配置说明
|
||
|
||
### 环境变量
|
||
|
||
| 变量名 | 说明 | 示例值 |
|
||
|-------|------|--------|
|
||
| `WEBHOOK_ENABLED` | 是否启用Webhook | `true` 或 `false` |
|
||
| `WEBHOOK_TYPE` | Webhook类型 | `dingtalk` 或 `feishu` |
|
||
| `WEBHOOK_URL` | Webhook地址 | 完整的机器人Webhook URL |
|
||
|
||
### 配置检查
|
||
|
||
系统会自动检查配置状态：
|
||
- ✅ **配置完整**：显示绿色提示
|
||
- ⚠️ **配置不完整**：显示黄色警告
|
||
- ℹ️ **未启用**：显示蓝色信息
|
||
|
||
---
|
||
|
||
## 🧪 测试Webhook
|
||
|
||
### 在实时监测模块测试
|
||
|
||
1. 进入"📊 实时监测"页面
|
||
2. 滚动到"🔔 通知管理"区域
|
||
3. 点击"📱 发送测试Webhook"按钮
|
||
4. 检查钉钉/飞书群是否收到消息
|
||
|
||
### 测试消息内容
|
||
|
||
```
|
||
股票代码: 测试
|
||
股票名称: Webhook测试
|
||
提醒类型: 测试消息
|
||
提醒内容: 如果您收到此消息，说明Webhook配置正确！
|
||
触发时间: 刚刚
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 同时使用邮件和Webhook
|
||
|
||
系统支持同时启用邮件和Webhook通知：
|
||
|
||
```env
|
||
# 邮件通知
|
||
EMAIL_ENABLED=true
|
||
SMTP_SERVER=smtp.qq.com
|
||
EMAIL_FROM=your-email@qq.com
|
||
EMAIL_PASSWORD=authorization-code
|
||
EMAIL_TO=recipient@qq.com
|
||
|
||
# Webhook通知
|
||
WEBHOOK_ENABLED=true
|
||
WEBHOOK_TYPE=dingtalk
|
||
WEBHOOK_URL=https://oapi.dingtalk.com/robot/send?access_token=xxxxx
|
||
```
|
||
|
||
**优势**：
|
||
- 📧 邮件：详细完整，适合深度阅读
|
||
- 📱 Webhook：即时推送，适合快速查看
|
||
- 🔔 双重保障：确保不错过重要通知
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
### 1. 钉钉安全设置
|
||
|
||
如果选择"自定义关键词"，确保消息中包含关键词：
|
||
- **推荐关键词**：股票、分析、智策、监测、提醒
|
||
- 系统消息已包含这些关键词，无需额外配置
|
||
|
||
### 2. 消息频率限制
|
||
|
||
- **钉钉**：每个机器人每分钟最多20条消息
|
||
- **飞书**：每个机器人每分钟最多50条消息
|
||
- 系统会自动控制发送频率，避免超限
|
||
|
||
### 3. Webhook地址安全
|
||
|
||
- ❌ 不要在公开场合分享Webhook URL
|
||
- ❌ 不要提交到版本控制系统
|
||
- ✅ 使用环境变量或配置文件管理
|
||
- ✅ 定期更换Webhook地址
|
||
|
||
### 4. 消息格式
|
||
|
||
- **钉钉**：支持Markdown格式
|
||
- **飞书**：支持文本和交互式卡片
|
||
- 系统会自动根据平台类型格式化消息
|
||
|
||
---
|
||
|
||
## 🛠️ 故障排查
|
||
|
||
### 问题1：未收到Webhook消息
|
||
|
||
**检查项**：
|
||
1. ✅ Webhook是否已启用（`WEBHOOK_ENABLED=true`）
|
||
2. ✅ Webhook URL是否正确
|
||
3. ✅ 网络连接是否正常
|
||
4. ✅ 机器人是否被移出群聊
|
||
5. ✅ 钉钉关键词安全设置是否正确
|
||
|
||
**解决方案**：
|
||
- 使用"测试Webhook"功能验证配置
|
||
- 检查系统日志查看错误信息
|
||
- 重新创建机器人并更新URL
|
||
|
||
### 问题2：Webhook发送失败
|
||
|
||
**常见错误**：
|
||
|
||
| 错误信息 | 原因 | 解决方案 |
|
||
|---------|------|---------|
|
||
| `errcode: 310000` | 关键词不匹配 | 添加"股票"或"分析"到关键词 |
|
||
| `Connection timeout` | 网络超时 | 检查网络连接 |
|
||
| `Invalid URL` | URL格式错误 | 检查URL完整性 |
|
||
|
||
**日志查看**：
|
||
系统会在终端输出详细日志：
|
||
```
|
||
📱 正在发送钉钉Webhook...
|
||
- URL: https://oapi.dingtalk.com...
|
||
✅ 钉钉Webhook发送成功
|
||
```
|
||
|
||
### 问题3：消息格式异常
|
||
|
||
**现象**：消息显示不正确或乱码
|
||
|
||
**解决方案**：
|
||
- 确认选择了正确的Webhook类型（钉钉/飞书）
|
||
- 检查系统编码设置为UTF-8
|
||
- 尝试重新保存配置
|
||
|
||
---
|
||
|
||
## 📊 使用场景
|
||
|
||
### 场景1：日内交易监控
|
||
|
||
**配置**：
|
||
- 启用实时监测 ✅
|
||
- 启用Webhook通知 ✅
|
||
- 设置进场区间、止盈止损 ✅
|
||
|
||
**效果**：
|
||
- 股票价格变动 → 钉钉/飞书实时提醒
|
||
- 手机随时查看 → 及时做出决策
|
||
- 双重保障 → 不错过交易机会
|
||
|
||
### 场景2：每日策略推送
|
||
|
||
**配置**：
|
||
- 启用智策定时分析 ✅
|
||
- 设置每天9:00运行 ✅
|
||
- 启用Webhook通知 ✅
|
||
|
||
**效果**：
|
||
- 每天9:00自动分析 → 板块策略报告
|
||
- 推送到钉钉/飞书群 → 团队成员查看
|
||
- 邮件同步发送 → 详细报告留存
|
||
|
||
### 场景3：团队协作
|
||
|
||
**配置**：
|
||
- 将机器人添加到团队群 ✅
|
||
- 配置Webhook URL ✅
|
||
- 多人共享通知 ✅
|
||
|
||
**效果**：
|
||
- 团队成员实时接收 → 投资信息同步
|
||
- 群内讨论决策 → 提高协作效率
|
||
- 历史消息可查 → 便于复盘总结
|
||
|
||
---
|
||
|
||
## 🎓 最佳实践
|
||
|
||
### 1. 消息分级
|
||
|
||
**重要通知** → Webhook + 邮件：
|
||
- 进场/止盈/止损提醒
|
||
- 智策定时分析报告
|
||
|
||
**一般通知** → 仅Webhook：
|
||
- 价格波动提醒
|
||
- 系统状态更新
|
||
|
||
### 2. 多群分发
|
||
|
||
创建多个机器人，分别推送：
|
||
- **交易群**：实时监测提醒
|
||
- **研究群**：智策分析报告
|
||
- **个人**：所有通知
|
||
|
||
### 3. 消息过滤
|
||
|
||
利用钉钉/飞书的消息筛选功能：
|
||
- 设置关键词提醒
|
||
- 静音非关键时段
|
||
- 重要消息置顶
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
- [环境配置功能说明.md](环境配置功能说明.md) - 完整配置指南
|
||
- [实时监测优化说明.md](实时监测优化说明.md) - 实时监测功能
|
||
- [智策定时分析使用指南.md](智策定时分析使用指南.md) - 智策定时功能
|
||
- [邮件配置指南.md](邮件配置指南.md) - 邮件通知配置
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
**Q: 可以同时配置多个Webhook吗？**
|
||
A: 当前版本只支持一个Webhook URL。如需多群推送，建议使用钉钉/飞书的消息转发功能。
|
||
|
||
**Q: Webhook和邮件应该选哪个？**
|
||
A: 建议同时使用。Webhook适合实时查看，邮件适合详细阅读和存档。
|
||
|
||
**Q: 消息发送失败会影响系统吗？**
|
||
A: 不会。Webhook发送失败不影响核心功能，系统会记录日志并继续运行。
|
||
|
||
**Q: 如何更换Webhook URL？**
|
||
A: 在环境配置中修改`WEBHOOK_URL`，保存后重启应用即可。
|
||
|
||
**Q: 钉钉和飞书哪个更好？**
|
||
A: 各有优势。钉钉Markdown渲染好，飞书卡片更美观。选择团队常用的即可。
|
||
|
||
---
|
||
|
||
**Webhook通知配置指南** - 让通知更及时 📱🔔
|
||
|
||
版本：v1.0
|
||
更新时间：2025-01-15
|
||
|