使用 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）或无代码平台未覆盖的数据库时，请使用 webhook。 Webhook 让您拥有完全的控制权：您自己编写接收端点，决定如何处理数据，并且不受任何平台的数据模型或速率限制的约束。
对开发自有产品或内部工具以集成文档自动化的团队来说，webhook 是标准的集成路径。
Parseur 支持的 webhook 事件
Parseur 支持按需触发不同的事件类型：
| 事件 | 触发时机 | 适用场景 |
|---|---|---|
| 文档处理完成 (Document Processed) | 文档被完全提取完毕时 | 通用场景：每份文档一个负载，包含全部字段 |
| 表格扁平化 (Flattened Tables) | 包含表格的文档被处理时 | 类似电子表格格式的输出，其中表格行被扁平化 |
| 表格逐行处理 (Table Item Processed) | 表格字段的每一行分别触发一次 | 将每一个行项目分别作为独立数据库记录插入 |
| 导出失败 (Export Failed) | webhook 传输尝试失败时 | 错误监控及 Slack/邮件告警 |
“表格逐行处理”事件尤其适合发票明细或订单表格，您可以让每一行单独创建一条记录，而不是一次性处理整个数组。
JSON 负载包含哪些内容
当文档被处理完成，Parseur 会向您的端点发送一个 JSON 对象。该负载包含：
- 您提取的字段（键值对形式，字段名与您定义的模板匹配）
- 表格行作为对象数组，每行一个对象
- 文档元数据：文档 ID、邮箱 ID、处理时间戳以及原始文件名
负载的确切结构与您的模板完全对应。如果 Parseur 模板中存在名为 invoice_number 的字段，JSON 数据里也会以 invoice_number 呈现。表格字段将以数组形式到达，每一行包含您所定义的列值。
完整的负载结构规范和字段类型，请查阅 webhook 文档。
步骤详解：如何配置 Parseur webhook
第一步：上传文档并创建提取模板
将文档拖入您的 Parseur 邮箱中，或者将邮件转发到您的 Parseur 邮箱地址。您可以设置自动转发规则，以便大规模自动处理传入的文档。
当您的文档在 Parseur 中出现后，请高亮显示您要提取的字段并为它们命名。Parseur 的 AI 将把该模板应用到未来所有同类的文档上。
第二步：创建 webhook
转到 导出 (Export)，选择 Webhook，再点击 新建 Webhook (New Webhook)。粘贴您的端点 URL 并选择触发事件。
如果您需要先测试集成效果，请使用 webhook.site 获取一个可记录所有入站请求的临时公共 URL。这样您就可以在连接生产端点之前先检查确切的 JSON 负载结构。
将该 URL 粘贴到 Parseur 中的目标 URL 字段中。
第三步：添加身份认证头（推荐）
对于生产端点，请添加带有授权令牌或共享密钥的自定义 HTTP 头。您的接收端点在处理负载之前会验证该请求头。这可以防止未授权的请求到达您的系统。
第五步：测试集成效果
在您的 Parseur 邮箱中重新处理一份文档，以触发 webhook 投递。查看您的端点日志或 webhook.site，确认负载已送达且结构符合您的预期。
一旦测试通过，每当 Parseur 处理文档时，您的端点将自动接收 JSON 负载数据。
如需完整的设置指南，请参阅 webhook 文档。
开发者典型用法
开发团队使用 Parseur webhook 将文档解析能力连接到无代码平台无法触达的系统之中：
- 自建数据库：直接将发票明细行推送到 PostgreSQL 或 MySQL 中。每一个“表格逐行处理”事件对应插入一行数据，无需批量导入即可保持数据结构清晰。
- 内部 ERP：将提取的采购订单数据通过内部 REST API 直接路由至 ERP 系统，省去构建文件导入管道的麻烦。
- 微服务架构：在文档被处理时触发下游服务，比如启动验证步骤，或在新订单到达时通知履约服务。
- 自托管 n8n：在运行于自有基础设施的 n8n 工作流中，将 Parseur 作为文档提取层。完整配置请参阅 n8n 集成指南。
- CRM 和线索路由：将线索邮件数据直接转发至 CRM 的入站 API 端点，完全绕过 Zapier。
相关文档类型的免费工具
如果您在构建集成前需要先检查特定文档类型的 JSON 输出结果，这些免费的转换器可在浏览器中直接向您展示结构：
- PDF 转 JSON 转换器：预览 PDF 在结构化 JSON 中的呈现方式
- 发票转 JSON 转换器：查看发票字段提取的 JSON 输出结果
了解 Parseur API 的完整参考信息及 webhook 负载规范，请参阅数据提取 API 指南。
Parseur是一款强大的文档处理工具，能够从电子邮件、PDF及其他文档中提取数据，并实现工作流程自动化。 查看Parseur全部功能。
什么是Webhook？
Webhook 用于通过 API 在应用程序和服务器之间交换数据。Webhook 是一个通知事件（通过 HTTP POST），每当 Parseur 解析新文档时触发，并以 JSON 形式发送解析后数据。
