通知机器人配置指南
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.3 钉钉 (DingTalk) 应用集成
配置步骤:
- 启用应用
- 创建或进入钉钉群聊
- 点击
更多 → 酷应用 → 酷应用栏
- 搜索并选择 "FlashDuty" 应用
- 点击"启用"完成安装
3.4 Microsoft Teams 应用集成
配置步骤:
-
获取应用包
-
上传应用
- 进入 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 应用
-
启用 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
- 使用 @ 功能
- 管理员在 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 技术支持团队。