飞书多维表格：自动化 Webhook 触发
飞书多维表格自带的「自动化」功能支持接收 Webhook 请求触发流程。这是与飞书开放平台企业自建应用完全独立的路径：个人用户、小团队在表格里点几下即可配置，无需申请应用、无需管理员审批。
BugCapturer 推荐使用这种方式接入。
- 一个飞书账号，且你是目标多维表格的成员（具备编辑权限）
- 无需创建任何飞书应用
第一步：在飞书中创建自动化流程
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 | 问题描述（超长自动截断） | 登录页按钮点击无响应 |
feedback_type | 报告类型 | bug / suggestion |
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 个集成。