通知机器人配置指南

FlashDuty 支持多种通知渠道，包括手机短信、邮件、语音通话以及各类即时通信平台。本文档将详细介绍各类通知渠道的配置方法和使用说明。

1. 通知渠道概览

1.1 传统通信渠道

手机短信、语音、邮件

通知类型	阿里云支持	腾讯云支持	说明
短信	✅	✅	支持告警和故障通知
语音	✅	✅	支持交互式认领功能
邮件	✅	❌	仅阿里云渠道支持

注意事项：

使用语音/短信/邮件通知前，请确保成员信息中已绑定手机号和邮箱

需要在通知渠道中配置相应的服务提供商

语音通知支持交互式认领：播报完成后按 1 键即可认领故障

1.2 即时通信平台

支持的 IM 平台和机器人类型

平台名称	应用集成	群机器人	特殊说明
飞书 (Lark)	✅	✅	完整支持所有功能
钉钉 (DingTalk)	✅	✅	完整支持所有功能
企业微信 (WeCom)	✅	✅	完整支持所有功能
Slack	✅ (Beta)	✅	Beta 版本
Microsoft Teams	✅	❌	仅支持应用集成
Telegram	❌	✅	仅支持机器人
Zoom	❌	✅	仅支持机器人

集成方式说明：

应用集成的详细步骤请参考：控制台 → 集成中心 → 即时消息

本文档重点介绍群机器人的配置方法

2. 应用集成 vs 机器人集成

2.1 功能对比

对比维度	应用集成	机器人集成
接入复杂度	需要管理员权限创建应用	群内直接创建，操作简单
交互体验	支持卡片内直接操作	需跳转浏览器处理
认证方式	支持免密操作	需要手动登录
功能完整性	支持认领、屏蔽、关闭等	基础通知功能
维护成本	一次配置，长期使用	相对简单

2.2 选择建议

推荐使用应用集成：如果您的组织对用户体验要求较高，且有相应的管理员权限
适合使用机器人：如果需要快速部署，或无法获取应用创建权限

3. 应用集成配置指南

3.1 飞书 (Lark) 应用集成

配置步骤：

安装应用
- 在飞书工作台搜索 "FlashDuty" 应用
- 点击安装并完成登录验证
- 系统将自动完成账户关联
配置通知渠道
- 进入 FlashDuty 控制台的 账户中心
- 在通知渠道中添加飞书选项
- 测试连接确保配置正确
群聊配置
- 在目标群聊中添加 FlashDuty 应用
- 路径：群设置 → 群机器人 → 添加机器人 → FlashDuty

3.2 企业微信 (WeCom) 应用集成

详细配置说明： 请参考企业微信集成指引

3.3 钉钉 (DingTalk) 应用集成

配置步骤：

启用应用
- 创建或进入钉钉群聊
- 点击 更多 → 酷应用 → 酷应用栏
- 搜索并选择 "FlashDuty" 应用
- 点击"启用"完成安装

3.4 Microsoft Teams 应用集成

配置步骤：

获取应用包
- 访问 FlashDuty 集成中心 → 即时消息 → Microsoft Teams
- 下载应用包：flashduty.zip
上传应用
- 进入 Microsoft Teams
- 导航至 Apps → Manage your apps → Upload an app → Upload an app to your org's app catalog
- 上传下载的 flashduty.zip 文件

设置应用权限
- 进入 Microsoft Teams 管理中心
- 找到 FlashDuty 应用
- 将应用可见范围设置为"所有人"或自定义范围

完成应用安装
- 等待几分钟后，组织成员可在 Apps → Built for your org 中找到应用

关联团队
- 将 FlashDuty 应用添加到目标团队
- 在团队聊天中 @FlashDuty 并发送关联指令：linkTeam xxx

关联用户
- 在个人聊天中发送关联指令：linkUser xxx

配置通知策略
- 在协作空间的分派策略中选择 Microsoft Teams 应用
- 配置群聊或单聊通知偏好

3.5 Slack 应用集成 (Beta)

配置步骤：

授权集成
- 访问 FlashDuty 集成中心 → 即时消息 → Slack → 添加
- 页面跳转至 Slack 授权界面
- 选择工作区并点击"允许"
完成配置
- 输入数据源名称并保存
- 在分派策略中选择 Slack 应用和目标群聊
私有频道处理
- 登录 Slack，在私有频道中选择 集成 → 添加应用
- 添加 FlashDuty 应用后刷新群聊列表

4. 机器人集成配置指南

4.1 飞书群机器人

配置步骤：

创建自定义机器人
- 进入飞书群聊
- 打开 群设置 → 群机器人 → 添加机器人
- 选择"自定义机器人"
配置机器人参数
- 设置机器人名称和描述
- 配置自定义关键词：#
- 点击"添加"生成 webhook 地址
集成到 FlashDuty
- 复制生成的 webhook 地址
- 在 FlashDuty 通知渠道中添加飞书机器人
- 粘贴 webhook 地址并测试连接

4.2 企业微信群机器人

配置步骤：

创建群机器人
- 进入企业微信群聊
- 点击 右上角设置 → 添加群机器人 → 新创建一个机器人
配置并获取 Webhook
- 设置机器人名称
- 点击"添加机器人"
- 复制生成的 webhook 地址
配置 FlashDuty
- 在通知渠道中选择企微机器人
- 粘贴 webhook 地址

4.3 钉钉群机器人

配置步骤：

创建自定义机器人
- 进入钉钉群聊
- 打开 群设置 → 群管理 → 智能群助手
- 点击"添加机器人" → 选择"自定义"类型
配置安全设置
- 设置机器人名称
- 添加关键词：#
- 同意相关协议
完成集成
- 复制生成的 webhook 地址
- 在 FlashDuty 中配置钉钉机器人

4.4 Telegram 机器人

配置步骤：

创建 Telegram 机器人
- 打开 BotFather，发送 /newbot 命令
- 输入机器人名称
- 记录返回的 Token（格式：64533289xx:AAFxCAdxx_xssbnSxE6Y8mTcOBT5rxxxxx）
创建 Channel
- 点击左上角设置 → New Channel
- 创建新的 Channel
- 将机器人添加为 Channel 成员
获取 Chat ID
- 在浏览器中访问：https://api.telegram.org/bot{Token}/getUpdates
- 替换 {Token} 为第一步获取的 Token
- 从返回结果中获取 Chat ID（以 - 开头）

4.5 Slack 机器人

配置步骤：

创建 Slack 应用
- 访问 https://api.slack.com/apps?new_app=1
- 选择应用名称和关联工作区
- 点击 "Create App"
启用 Incoming Webhook
- 在应用设置页面选择 "Incoming Webhook"
- 开启 "Activate Incoming Webhooks" 开关
获取 Webhook URL
- 点击 "Add New Webhook to Workspace"
- 选择目标频道并确认
- 复制生成的 Webhook URL

4.6 Zoom 机器人

配置步骤：

创建机器人
- 打开 Zoom 应用，进入 Apps - Add Apps，搜索并添加 Incoming Webhook 应用
- 返回聊天界面，确认 Incoming Webhook 应用已成功添加
- 在任意频道或 Incoming Webhook 应用中输入命令：/inc connect flashduty 系统将返回应用连接信息
配置 Flashduty
- 复制返回信息中的 Endpoint 地址（如：https://integrations.zoom.us/chat/webhooks/incomingwebhook/V9S5as-zTXOSUdgMITNExxxx），将其填写到Flashduty通知渠道的 Zoom 机器人 Webhook 地址或 Token 字段
- 复制返回信息中的 Verification Token，填写到Flashduty通知渠道的 Zoom 机器人 Verify Token 字段
使用 @ 功能
- 管理员在 Zoom 控制台获取用户 user_id
- 在 Flashduty 集成中心的映射数据中创建映射表，源标签填写：email，值部分填写Flashduty 成员邮箱，结果标签填写：zoom_jid，之部分填写Zoom user_id
- 在协作空间的分派策略中关联对应 Zoom 机器人和映射表

5. 常见问题解答

Q: 使用应用卡片消息时，是否每次都需要登录？

A: 不需要。成员账户与应用账户关联后可以实现免密登录。

关联方法：

在对应平台搜索 FlashDuty 应用
点击应用并完成登录
系统将自动建立账户关联关系

Q: 在钉钉/飞书/企微工作台找不到 FlashDuty 应用怎么办？

A: 请按照以下方式解决：

检查应用状态： 确认 FlashDuty 应用已在您的组织中启用
权限检查： 联系管理员确认您有权限查看和使用该应用
搜索方式： 尝试使用不同的关键词搜索，如 "FlashDuty"、"Flashcat" 等
联系支持： 如仍无法找到，请联系技术支持获取帮助

Q: 机器人消息发送失败，如何排查？

A: 请按以下步骤排查：

验证 Webhook 地址： 确认复制的 Webhook 地址完整且正确
检查关键词设置： 对于需要关键词的平台，确保消息模板包含对应关键词
网络连接： 确认 FlashDuty 服务器能够访问目标平台
权限检查： 确认机器人在目标群组中有发送消息的权限
日志查看： 在 FlashDuty 控制台查看详细的错误日志

Q: 如何自定义通知消息模板？

A: 您可以在 FlashDuty 控制台的通知模板设置中：

进入 配置管理 → 通知模板
选择对应的通知渠道类型
编辑消息模板，支持使用变量和 Markdown 格式
测试模板效果并保存

注意： 如果使用了自定义模板，请确保包含机器人平台要求的关键词

技术支持： 如遇到配置问题或需要进一步帮助，请联系 FlashDuty 技术支持团队。