aiagents-stock/docs/Webhook钉钉关键词快速配置指南.md

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 文件配置示例

# 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

🎯 测试效果

配置成功后，钉钉群会收到如下格式的测试消息：

### 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
2. 查看 Webhook钉钉关键词配置更新说明.md
3. 检查应用日志输出

---

更新时间: 2025-10-18
适用版本: v1.1.0+