# 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+

