飞书
我们目前支持将报告推送至飞书多维表格，有两种接入方式，按需要选一种即可；同一账号可以为不同表格分别配置。
两种方式怎么选
Section titled “两种方式怎么选”| 方式 A：多维表格自动化 Webhook 触发 | 方式 B：企业自建应用 API | |
|---|---|---|
| 是否需要创建应用 | ❌ 不需要 | ✅ 需要在飞书开放平台创建企业自建应用 |
| 配置耗时 | 约 3 分钟 | 约 10 分钟 |
| 标准列 | 手动（或由测试请求映射） | ✅ 自动创建标准列 |
| 权限要求 | 表格成员即可 | 应用需被添加为表格协作者 |
| 数据能力 | 单向写入 | 单向写入，写入过程服务端可控 |
| 适合谁 | 个人用户、小团队、快速试用 | 需要统一列结构与更长周期台账的团队 |
推荐：优先使用方式 A（自动化 Webhook 触发），无需任何审批；只有当你需要自动创建标准列等深度能力时，再使用方式 B。
方式 A：自动化 Webhook 触发（推荐）
Section titled “方式 A：自动化 Webhook 触发（推荐）”飞书多维表格自带的「自动化」功能支持接收 Webhook 请求触发流程。这是与飞书开放平台企业自建应用完全独立的路径：个人用户、小团队在表格里点几下即可配置，无需申请应用、无需管理员审批。
我们推荐您使用这种方式接入。
- 一个飞书账号，且你是目标多维表格的成员（具备编辑权限）
- 无需创建任何飞书应用
第一步：在飞书中创建自动化流程
Section titled “第一步：在飞书中创建自动化流程”- 打开目标多维表格，点击右上角「自动化」→「新建流程」
- 触发条件选择「当接收到 Webhook 请求时」（部分版本显示为「Webhook 触发」）
- 系统会自动生成一个唯一的 Webhook 地址（形如
https://xxx.feishu.cn/...），复制备用- 如果启用了「校验 Token」，记下生成的 Bearer Token（可选，建议开启以防止伪造请求）
- 先不要关闭流程编辑页，进入下一步
第二步：在 BugCapturer 中添加集成
Section titled “第二步：在 BugCapturer 中添加集成”- 登录 app.bugcapturer.com，进入「集成」设置页
- 左侧平台目录选择「飞书多维表格」→ 点击「添加集成」
- 选择「自动化 Webhook 触发」（推荐）
- 填写：
- 名称：便于识别，如「客户端 Bug 台账」
- Webhook 地址：粘贴第一步复制的地址
- Bearer Token（可选）：仅在飞书侧开启 Token 校验时填写
- 点击「验证并保存」
第三步：生成字段映射
Section titled “第三步：生成字段映射”保存时，BugCapturer 会向你的 Webhook 地址发送一条测试请求。此时回到飞书流程编辑页：
- 在流程的「输出设置」中选择「通过发送请求设置」
- 飞书会监听 3 分钟内到达的请求，自动识别刚收到的测试记录并列出所有字段
- 把需要的字段一一映射到表格列，保存并启用流程
完成后再点击 BugCapturer 集成卡片上的「测试」，确认表格中能出现一条新记录。
BugCapturer 发送的 JSON 请求体包含以下字段（均为文本，可直接映射为多行文本列）：
| 字段 | 含义 | 示例 |
|---|---|---|
source | 来源标识，固定为 BugCapturer | BugCapturer |
description | 问题描述（超长自动截断） | 登录页按钮点击无响应 |
page_url | 问题发生页面 URL | https://example.com/login |
page_title | 问题发生页面标题 | 登录 - Example |
browser_info | 浏览器与操作系统 | Chrome 128 / Windows 11 |
screen_resolution | 屏幕分辨率 | 1920x1080 |
console_errors | 控制台错误摘要（条数 + 前 3 条） | 2 条 - TypeError: … |
network_errors | 网络错误摘要（条数 + 前 3 条） | 1 条 - GET /api → 500 |
screenshot_url | 截图链接 | https://…/api/shares/xxx/file |
report_link | 分享报告完整链接 | https://app.bugcapturer.com/share/xxx |
submitted_at | 提交时间（北京时间文本） | 2026-09-09 14:30:00 |
expires_at | 分享到期时间（北京时间文本） | 2026-12-08 14:30:00 |
保存时提示「校验 Webhook 地址」失败？
检查地址是否完整复制（包含协议 https://），不要混入空格或换行。BugCapturer 仅支持公网 https 地址。
保存成功但表格里没有数据？ 确认流程已经保存并启用；输出设置若未配置映射，收到请求也不会写表。可点击集成卡片上的「测试」重新触发一条测试记录。
截图能直接进表格的附件列吗？
不能。自动化 Webhook 只能写入文本字段，截图以 screenshot_url 链接形式提供。需要原生附件请使用方式 B。
一个表格可以配置多个集成吗？ 可以，但每个表格的自动化流程需要单独生成 Webhook 地址。每个 BugCapturer 账号最多创建 3 个集成。
方式 B：企业自建应用 API
Section titled “方式 B：企业自建应用 API”如果你需要 BugCapturer 自动创建标准列、统一表格结构，可以使用飞书开放平台的「企业自建应用」API 接入。该方式需要在开放平台创建应用，适合由管理员统一搭建团队台账的场景；个人快速试用请优先使用方式 A（自动化 Webhook 触发）。
- 一个飞书账号（个人版即可创建企业自建应用）
- 目标多维表格的访问权限
- 约 10 分钟的配置时间
第一步：创建飞书企业自建应用
Section titled “第一步：创建飞书企业自建应用”- 打开飞书开放平台，登录后进入「开发者后台」
- 点击「创建企业自建应用」，填写应用名称（如 BugCapturer）与描述
- 创建完成后，在「凭证与基础信息」页复制 App ID（
cli_开头）与 App Secret
第二步：开通多维表格权限并发布
Section titled “第二步：开通多维表格权限并发布”- 在应用内进入「权限管理」，搜索并开通
bitable:app（查看、评论、编辑和管理多维表格） - 进入「版本管理与发布」，创建版本并发布应用
- 个人版 / 自建应用通常无需管理员审核即可自用；企业版可能需要管理员审批
第三步：把应用添加为表格协作者
Section titled “第三步：把应用添加为表格协作者”- 打开目标多维表格，点击右上角「…」→「更多」→「添加文档应用」
- 搜索你的应用名称并添加，权限选择「可编辑」
第四步：在 BugCapturer 中添加集成
Section titled “第四步：在 BugCapturer 中添加集成”- 登录 app.bugcapturer.com，进入「集成」设置页
- 左侧平台目录选择「飞书多维表格」→ 点击「添加集成」→ 选择「企业自建应用 API」
- 填写 App ID、App Secret，并粘贴浏览器地址栏中的多维表格链接（需包含
table参数，形如https://xxx.feishu.cn/base/bascnXXXX?table=tblYYYY&view=vewZZZ；知识库/wiki/链接同样支持） - 点击「验证并保存」
保存时服务端会依次执行四步校验：验证凭证 → 解析表格 → 自动创建缺失的标准列 → 写入一条测试记录。任何一步失败都会在页面上标明原因。
自动创建的标准列
Section titled “自动创建的标准列”校验通过后，如果你的表格缺少以下列，BugCapturer 会自动创建（已有的同名列保持原样，不会改动类型）：
| 列名 | 类型 | 说明 |
|---|---|---|
| 描述 | 多行文本 | 问题描述 |
| 类型 | 多行文本 | bug / suggestion |
| 页面 URL | 多行文本 | 问题发生页面 |
| 页面标题 | 多行文本 | 问题发生页面标题 |
| 浏览器 | 多行文本 | 浏览器信息 |
| 操作系统 | 多行文本 | 操作系统信息 |
| 分辨率 | 多行文本 | 屏幕分辨率 |
| 控制台错误数 | 数字 | 控制台错误条数 |
| 网络错误数 | 数字 | 网络错误条数 |
| 截图 | 超链接 | 截图链接 |
| 分享链接 | 超链接 | 分享报告完整链接 |
| 提交时间 | 日期 | 报告提交时间 |
| 到期时间 | 日期 | 分享到期时间 |
| 同步时间 | 日期 | 本条记录写入时间 |
与方式 A 的取舍
Section titled “与方式 A 的取舍”| 方式 A：自动化 Webhook 触发 | 方式 B：企业自建应用 API | |
|---|---|---|
| 创建应用 | 不需要 | 需要 |
| 标准列 | 手动映射 | 自动创建 |
| 附件列支持 | 仅链接 | 截图以超链接写入 |
| 管理员审批 | 不需要 | 企业版可能需要 |
| 推荐场景 | 个人 / 小团队快速接入 | 统一结构的团队台账 |
两种方式可以并存：同一个账号可以为不同表格分别配置方式 A 与方式 B 的集成（共 3 个）。
提示「凭证无效」？ 检查 App ID / App Secret 是否复制完整；发布新版本后部分凭证会重置，请以「凭证与基础信息」页的最新值为准。
编辑集成时需要重新填 App Secret 吗？ 不需要。编辑时留空 Secret 表示沿用原值；修改凭证或表格链接会触发重新校验。
常见报错排查
Section titled “常见报错排查”保存失败时，页面会显示具体报错与错误码。按报错对号入座（均为实测高频坑）：
| 报错 / 错误码 | 原因与解决 |
|---|---|
| 「应用尚未开通所需权限」 （code 99991672） | 权限没开通全或未生效：点报错里的链接开通权限（普通表格 bitable:app；知识库表格还需 wiki:wiki:readonly），然后必须创建并发布新版本——只开权限不发布版本，权限不会生效 |
| 「表格链接有误」/「文档不存在」 （code 131005） | 飞书对应用无权访问的知识库节点也返回「不存在」，先当权限问题排查：① 应用已添加「机器人」能力并发布版本；② 在目标表格页面右上角「…」→「更多」→「添加文档应用」添加过该应用；③ 链接是浏览器地址栏复制的完整链接。个人版知识库可能没有「添加文档应用」入口——把表格移到「我的空间」改用 /base/ 链接即可绕开 |
| 「应用未获表格协作权限」 （code 91403） | 应用没加为这张表的协作者：打开表格 → 右上角「…」→「更多」→「添加文档应用」→ 搜索应用名 → 添加并给「可编辑」 |
| 「标准列创建失败」 | 协作者权限给成了「可阅读」：重新以「可编辑」添加后重试。已有同名列会自动跳过，不需要手动删除表头 |