使用 Webhook 将解析文档数据发送到任意应用
Zapier 和 Make 能满足大多数自动化应用场景。但如果您的目标应用是自定义程序、内部数据库，或市场找不到的系统，就需要直接连接，这正是 Parseur webhook 的用武之地。
每次 Parseur 处理完文档，都会将解析到的字段以 JSON 形式通过 HTTP POST 发送到您自有的 URL。您的应用实时接收结构化数据，并按需处理。无需第三方平台，无需数据映射，无额外任务计费。
2025 年 Parseur 与 QuestionPro 联合调研显示，员工每周花费 9 个小时以上将文档数据转录到其他系统，平均每名员工每年成本高达 $28,500。对于开发团队将文档自动化集成到自有产品时，webhook 是文档解析结果直达业务系统的最快路径。
主要要点
- 每当文档被处理，Parseur 通过 webhook 将结构化 JSON 发送到任一 HTTP 端点，无需第三方平台。
- 支持四种事件类型：文档处理完成、表格扁平化、表格逐行处理及导出失败，各自适用于不同场景。
- 可自定义 HTTP 头，添加认证令牌或密钥，保护 webhook 安全。
- webhook 适用于一切目标：自定义应用、内部数据库、ERP、自托管自动化工具如 n8n、微服务等。
- 如果目标为主流应用，建议用 Zapier 或 Make；如不是，优选 webhook。
Webhook、Zapier 与 Make：如何选择？
这三种方式都能将 Parseur 数据发送到其他系统。如何选，取决于目标系统：
目标为主流应用（Google Sheets、HubSpot、Salesforce、Slack、Airtable 等），请选择 Zapier 或 Make。 这两者配套应用齐全，上手更快，无需写代码。
目标为自定义程序、专有系统、自托管工具如 n8n 或 No-Code 平台未覆盖的数据库，建议用 webhook。 webhook 最大优势在于完全自主，您负责接收端逻辑，数据结构和处理流程完全由您掌控，不受平台限制。
对开发自有产品或内部工具的团队来说，webhook 是标准集成方式。
Parseur 支持的 webhook 事件
Parseur 支持按需触发不同的 webhook 事件：
| 事件 | 触发时机 | 适用场景 |
|---|---|---|
| 文档处理完成（Document Processed） | 文档提取完毕时 | 通用场景：每份文档一个负载，全部字段 |
| 表格扁平化（Flattened Tables） | 含表格的文档被处理时 | 以扁平结构输出表格行，便于表格化处理 |
| 表格逐行处理（Table Item Processed） | 表格字段每行各触发一次 | 发票明细等单行入库场景 |
| 导出失败（Export Failed） | webhook 传输失败时 | 错误监控及 Slack/邮件告警 |
“表格逐行处理”尤其适合发票明细、订单表等，便于每行单独创建记录，而不是批量处理整个数组。
JSON 负载包含哪些内容？
每份文档解析完成后，Parseur 会推送一个 JSON 到您的端点。内容包括：
- 您自定义的字段（同比模板字段名）
- 表格字段作为对象数组，每行一个对象
- 文档元数据：文档ID、邮箱ID、处理时间、原始文件名
负载结构完全与模板对应。如模板字段名为 invoice_number，JSON 里即为 invoice_number；表格字段为数组，内含每行的所有列值。
完整 JSON 负载结构和字段类型请见 webhook 文档。
步骤详解：如何配置 Parseur webhook
第一步：上传文档并创建提取模板
将文档拖入您的 Parseur 邮箱，或将邮件转发到 Parseur 邮箱地址。建议设置自动转发规则，实现高效自动化接收文件。
文档上传后，您只需高亮想要提取的字段并命名。Parseur 的 AI 会将该模板应用到所有同类文档。
第二步：创建 webhook
进入 导出 - Webhook - 新建 Webhook，填写您的端点 URL，选择触发事件。
首次测试建议用 webhook.site 获取临时 URL，便于查看所有入站请求，检验 JSON 结构再连接正式系统。
把 URL 粘贴进 Parseur 配置中的目标 URL。
第三步：添加身份认证头（推荐）
生产环境建议加自定义 HTTP 头，携带授权 token 或共享密钥。您的接收端应验证请求头，以防止未授权访问。
第五步：测试集成效果
在 Parseur 邮箱重新处理一份文档以触发 webhook。查看您的端点日志或 webhook.site，确认 JSON 到达且结构符合预期。
测试通过后，每当 Parseur 成功解析文档，您的端点便会自动收到一份 JSON 数据负载。
完整配置指南见 webhook 文档。
开发者典型用法
Parseur webhook 连接一切 No-Code 平台无法触达的业务系统，常见用途有：
- 自建数据库：直接将发票明细行推送入 PostgreSQL/MySQL，每个“表格逐行处理”事件写入一行，无需批量导入，结构明晰。
- 内部 ERP：采购单等数据解析后直接调用 ERP 系统的 REST API，无需开发文件导入逻辑。
- 微服务架构：文档被解析后触发下游服务，如自动验证步骤、订单通知履约系统。
- 自托管 n8n：Parseur 作为文档解析层，嵌入您自建的 n8n 工作流。完整流程详见 n8n 集成指南。
- CRM/线索路由：直接将 线索邮件 数据推送至 CRM 的 API，完全绕过 Zapier。
免费工具，助您预览常见文档类型的 JSON 结构
如需快速查看不同文档类型的解析 JSON，可用这些免费工具直接展示结构：
- PDF 转 JSON：预览 PDF 被解析成的结构化 JSON
- 发票转 JSON：查看发票字段提取与 JSON 输出
更多 API 细节和 webhook 负载规范请见 数据提取 API 指南。
Parseur是一款强大的文档处理工具，能够从电子邮件、PDF及其他文档中提取数据，并实现工作流程自动化。 查看Parseur全部功能。
什么是Webhook？
Webhook 用于通过 API 在应用程序和服务器之间交换数据。Webhook 是一个通知事件（通过 HTTP POST），每当 Parseur 解析新文档时触发，并以 JSON 形式发送解析后数据。
