飞书群机器人

飞书群机器人（自定义机器人）会把每条新反馈以卡片消息发到指定的群里。不需要创建开放平台应用，也不需要管理员审批：在群里添加机器人、复制 Webhook 地址、粘贴到 BugCapturer 即可。

注意

这是通知型目标：报告不在飞书里沉淀。需要可筛选、可指派的台账，请同时配置飞书多维表格——两者可以并存，各司其职。

第一步：创建自定义机器人

1. 打开飞书，进入目标群
2. 群设置 →「群机器人」→「添加机器人」→「自定义机器人」
3. 设置头像与名称，点击「添加」
4. 复制生成的 Webhook 地址（形如 https://open.feishu.cn/open-apis/bot/v2/hook/…）

第二步：在 BugCapturer 中添加集成

1. 登录 app.bugcapturer.com，进入「集成」设置页
2. 左侧平台目录选择「飞书群机器人」→ 点击「添加集成」
3. 粘贴上一步的 Webhook 地址
4. 签名密钥（可选）：只在机器人「安全设置」里勾选了「签名校验」时才需要填写
5. 选择卡片语言，点击「验证并保存」

保存时我们会向该群发送一张测试卡片。群里出现卡片，就说明配置成功了。

第三步：在三种安全设置里选一种

飞书的三种安全设置可以组合使用，但选一种就够了：

安全设置	作用	建议
签名校验	每个请求都带 timestamp + sign，飞书校验不通过就拒收	推荐 —— 密钥存在服务端，我们逐条加签，你不用做任何事
IP 白名单	只接受白名单内 IP 的请求	如果你的安全规范要求就可以用，别忘了把我们的出网 IP 加进去
自定义关键词	消息里必须命中至少一个关键词	不推荐 —— 卡片文案得一直和你的关键词对得上，很脆

警告

若使用 IP 白名单，请把 47.236.11.198（我们的出网 IP）加进去。否则飞书会对每个请求返回 19022 Ip Not Allowed，群里一条消息都不会有。

卡片里有什么

部位	内容
标题	🐞 [bug] <反馈描述首行>
正文	页面、环境（浏览器 · 操作系统 · 屏幕）与诊断条数（Console 3 · Network 2）
按钮	「查看报告」—— 跳转到 BugCapturer 分享页

注意

卡片里不放截图。 飞书卡片的图片必须先上传到飞书拿到 image_key，而自定义机器人没有这个能力。点「查看报告」即可看到标注截图、控制台错误与失败请求。

群消息是公开可见的出口，因此卡片只带诊断条数，不带错误正文。

怎么确认真的收到了

投递成功只代表飞书受理了这个请求（code == 0），不代表有人看到了。确认方式：

1. 打开该集成 →「投递日志」
2. 绿色的行会显示 code 0 以及飞书返回的原始响应
3. 被拒收的投递是红色的，并带上飞书自己的错误码（19021 签名、19022 IP 白名单、19024 关键词）

投递失败会自动重试两次（间隔 5 秒与 15 秒）；连续失败 20 次后集成会被自动停用，并发邮件提醒。详见投递日志与连续失败自动停用。

常见问题

现象	原因	处理
19021 sign match fail	签名密钥对不上，或服务器时间偏差超过 1 小时	到机器人「安全设置」里重新复制密钥填写；或把密钥留空
19022 Ip Not Allowed	机器人开了 IP 白名单，里面没有我们的出网 IP	把 47.236.11.198 加进白名单
19024 Key Words Not Found	机器人开了「自定义关键词」，卡片没命中	改用「签名校验」
群里没消息，但投递日志是绿的	我们这边投递成功，问题在接收侧	打开投递日志核对飞书返回的原始响应；确认机器人还在目标群里
群里没消息，投递日志是红的（地址无效）	机器人被移出群，或地址被重新生成过	到群设置里重新复制地址，保存集成即可

群机器人与多维表格怎么选

	飞书群机器人（本页）	飞书多维表格
类型	通知型（往群里发卡片）	记录型（往表里写一行）
是否沉淀	否	是 —— 可筛选、排序、指派、回看
适合谁	想第一时间知道的团队	需要台账的团队

一个机器人只能绑定一个群；需要通知多个群，就为每个群添加一个集成。