飞书 (Feishu / Lark) 群机器人配置指南

飞书凭借其卓越的协同文档和群沟通体验，广泛应用于现代化科技企业。通过在飞书群中添加自定义机器人并与 DuRT 绑定，会议结束时生成的纪要、智能摘要和待办清单即可秒级同步至飞书群。

核心特性

结构化富文本卡片：自动组织为层级分明的格式（标题、元信息、要点、高亮待办）。
签名校验加签安全防护：支持飞书官方推荐的 HMAC-SHA256 签名机制，防止 Webhook 地址被滥用。
免企业应用审核：群管理员或普通成员均可在群内一键添加，无需向飞书开放平台申请应用审核。

第一步：在飞书群中添加自定义机器人并获取 Webhook

在电脑端打开飞书，进入目标接收群聊。
点击群界面右上角的 「群设置」（设置齿轮图标）。
选择 「群机器人」 -> 点击 「添加机器人」。
在机器人列表中选择 「自定义机器人」 并点击添加。
配置机器人基础信息：
- 机器人名称：例如 DuRT 会议纪要助手。
- 机器人描述：可选填写。
安全设置（强烈推荐）：
- 勾选 「签名校验」。
- 勾选后，系统会展示一串密钥（Secret），点击复制并妥善保存。
点击 「添加」，生成专属的 Webhook 地址（格式如 https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）。
点击 「复制」 保存该 Webhook 地址。

第二步：在 DuRT 中完成配置

打开 DuRT 客户端，进入 「设置」->「第三方集成与推送」。
点击左下角的 「+ 添加账号」，在弹出菜单中选择 「飞书 (Feishu)」。
在右侧表单中填入刚才获取的信息：
- 账号名称：如 产研核心飞书群。
- Webhook 地址：粘贴第一步获取的完整 Webhook URL。
- 加签密钥 (Sign Secret)：粘贴在安全设置中生成的签名密钥（若群内未勾选“签名校验”可留空）。
- 内容推送偏好：
  - ✅ 包含 AI 核心摘要 (Summary)
  - ✅ 包含行动项与待办 (Action Items)
  - 包含逐句对话记录 (可选)
点击右下角 「保存」。

第三步：使用与效果验证

手动投送：在工作台会话详情页面右上角点击「分发推送」，勾选飞书账号并点击「立即投送」。
工作流自动化：在 AI 工作流的 ExportArtifact 步骤中勾选该飞书账号，会议录音完成后全自动后台推送。

常见问题与排错 (FAQ)

Q1: 提示 `{"code":19001,"msg":"sign match fail"}`？

原因：飞书后台开启了“签名校验”，但在 DuRT 中未填入加签密钥，或密钥复制有误（包含首尾空格）。
解决：在 DuRT 的飞书配置项中核对并重新粘贴密钥。

Q2: 提示 `{"code":19002,"msg":"ip not in white list"}`？

原因：在飞书群机器人安全设置中勾选了“自定义关键词”或“IP 白名单”，导致普通外网请求被拦截。
解决：建议安全设置中只保留「签名校验」，关闭 IP 白名单限制，以保证移动办公或不同网络环境下的稳定投送。