oficcejo
157 lines
4.2 KiB
Markdown
157 lines
4.2 KiB
Markdown
# Webhook钉钉关键词快速配置指南
|
||
|
||
## 🚀 5分钟快速配置
|
||
|
||
### 第一步：创建钉钉机器人
|
||
|
||
1. 打开钉钉群聊
|
||
2. 点击右上角 **群设置** → **智能群助手**
|
||
3. 点击 **添加机器人** → 选择 **自定义**
|
||
4. 给机器人命名（如：AI股票分析助手）
|
||
5. **重要！** 在安全设置中选择 **自定义关键词**
|
||
6. 输入关键词（建议使用：`aiagents通知`）
|
||
7. 点击完成，**复制Webhook地址**
|
||
|
||
### 第二步：在系统中配置
|
||
|
||
1. 启动AI股票分析系统
|
||
2. 点击左侧导航栏的 **⚙️ 环境配置**
|
||
3. 切换到 **📢 通知配置** 标签页
|
||
4. 在右侧 **Webhook通知** 区域：
|
||
- ✅ 勾选 **启用Webhook通知**
|
||
- 📲 选择Webhook类型：**dingtalk（钉钉）**
|
||
- 🔗 粘贴刚才复制的 **Webhook地址**
|
||
- 🔑 填写 **自定义关键词**：`aiagents通知`（必须与钉钉机器人设置一致）
|
||
|
||
### 第三步：测试连接
|
||
|
||
1. 点击 **🧪 测试Webhook连通** 按钮
|
||
2. 等待几秒钟
|
||
3. ✅ 如果看到"测试成功"提示，检查钉钉群是否收到测试消息
|
||
4. ❌ 如果失败，请检查：
|
||
- URL是否完整正确
|
||
- 关键词是否与钉钉机器人设置一致
|
||
- 网络连接是否正常
|
||
|
||
### 第四步：保存配置
|
||
|
||
1. 测试成功后，点击 **💾 保存配置** 按钮
|
||
2. 等待保存成功提示
|
||
3. 🎉 配置完成！
|
||
|
||
## 📋 配置示例
|
||
|
||
### .env 文件配置示例
|
||
|
||
```bash
|
||
# Webhook通知配置
|
||
WEBHOOK_ENABLED="true"
|
||
WEBHOOK_TYPE="dingtalk"
|
||
WEBHOOK_URL="https://oapi.dingtalk.com/robot/send?access_token=你的access_token"
|
||
WEBHOOK_KEYWORD="aiagents通知"
|
||
```
|
||
|
||
### 钉钉机器人安全设置示例
|
||
|
||
**选项1：自定义关键词（推荐）**
|
||
- 关键词：`aiagents通知`
|
||
- 说明：简单易用，配置方便
|
||
|
||
**选项2：加签验证**
|
||
- 需要额外开发
|
||
- 安全性更高
|
||
|
||
**选项3：IP白名单**
|
||
- 适合固定IP服务器
|
||
- 需要知道服务器出口IP
|
||
|
||
## 🎯 测试效果
|
||
|
||
配置成功后，钉钉群会收到如下格式的测试消息：
|
||
|
||
```markdown
|
||
### aiagents通知 - 股票监测提醒
|
||
|
||
**股票代码**: 测试
|
||
**股票名称**: Webhook配置测试
|
||
**提醒类型**: 系统测试
|
||
**提醒内容**: 如果您收到此消息，说明Webhook配置正确！
|
||
**触发时间**: 刚刚
|
||
|
||
---
|
||
_此消息由AI股票分析系统自动发送_
|
||
```
|
||
|
||
## ⚠️ 常见问题
|
||
|
||
### Q1: 测试提示"关键词不匹配"
|
||
**A:** 确保系统中填写的关键词与钉钉机器人设置完全一致（区分大小写）
|
||
|
||
### Q2: 测试成功但实际使用时收不到消息
|
||
**A:**
|
||
- 确认已点击"保存配置"
|
||
- 重启应用使配置生效
|
||
- 检查钉钉群是否开启免打扰
|
||
|
||
### Q3: 找不到Webhook地址
|
||
**A:** 钉钉群设置 → 智能群助手 → 找到已创建的机器人 → 查看Webhook地址
|
||
|
||
### Q4: 关键词填什么？
|
||
**A:**
|
||
- 建议使用：`aiagents通知` 或 `股票提醒`
|
||
- 必须与钉钉机器人设置保持一致
|
||
- 避免使用过于常见的词语
|
||
|
||
### Q5: 飞书机器人需要配置关键词吗？
|
||
**A:** 不需要！飞书机器人只需要填写Webhook URL即可
|
||
|
||
## 💡 使用场景
|
||
|
||
配置完成后，以下情况会自动发送钉钉通知：
|
||
|
||
### 1️⃣ 实时监测
|
||
- 📊 股票价格突破设定的目标价
|
||
- 📈 涨幅超过设定的阈值
|
||
- 📉 跌幅超过设定的阈值
|
||
- 🔊 成交量异常放大
|
||
|
||
### 2️⃣ 智策定时分析
|
||
- ⏰ 定时分析任务完成
|
||
- 🔥 发现热门板块机会
|
||
- 💡 生成投资策略建议
|
||
|
||
### 3️⃣ 龙虎榜监测
|
||
- 🎯 重要龙虎榜数据
|
||
- 💰 游资席位动向
|
||
- 📊 异常交易提醒
|
||
|
||
## 🔧 高级配置
|
||
|
||
### 同时启用邮件和Webhook
|
||
|
||
您可以同时配置邮件和Webhook通知：
|
||
- 邮件：适合详细报告
|
||
- Webhook：适合即时提醒
|
||
|
||
配置方法：在"通知配置"页面分别启用两者即可。
|
||
|
||
### 多个钉钉群通知
|
||
|
||
如需发送到多个钉钉群：
|
||
1. 创建多个机器人
|
||
2. 使用逗号分隔多个Webhook URL（功能待开发）
|
||
3. 或者使用群聊转发功能
|
||
|
||
## 📞 获取帮助
|
||
|
||
如遇到问题：
|
||
1. 查看 [Webhook通知配置指南.md](./Webhook通知配置指南.md)
|
||
2. 查看 [Webhook钉钉关键词配置更新说明.md](./Webhook钉钉关键词配置更新说明.md)
|
||
3. 检查应用日志输出
|
||
|
||
---
|
||
|
||
**更新时间**: 2025-10-18
|
||
**适用版本**: v1.1.0+
|
||
|