Webhook を使って解析済みドキュメントデータを任意のアプリへ送信する

Parseur logo Webhook logo

Zapier や Make は多くの自動化ユースケースに対応しています。しかし、宛先が独自アプリケーションや社内データベース、市販アプリ連携できないシステムの場合は、ダイレクトな接続が必要です。それが Parseur Webhook の役割です。

Parseur がドキュメントを処理するたびに、指定した URL へ HTTP POST リクエストを送り、抽出したフィールドを JSON ペイロードとして構造化してリアルタイムに送信します。手元のアプリケーションやシステムは、中間プラットフォームを経由せず、第三者連携の課金やマッピング設定も不要で、ダイレクトにクリーンなデータを受け取れます。

2025 年に実施された Parseur と QuestionPro の調査 では、企業の従業員は平均して、週 9 時間以上をドキュメントから他のツールへのデータ転記に費やしており、これは 1 人あたり年間 $28,500 のコスト に相当します。自社プロダクトへのドキュメント自動化を組み込む開発チームにとって、Webhook は最もレイテンシが低い「解析データ → 本番システム」への連携手段となります。

ポイントまとめ

  • Parseur は、ドキュメント処理ごとに構造化した JSON を任意の HTTP エンドポイントに Webhook で直接送信します。仲介プラットフォーム不要。
  • サポートしているイベント種別は 4 つ：「Document Processed」「Flattened Tables」「Table Item Processed」「Export Failed」。用途に応じて最適なものを選択できます。
  • カスタム HTTP ヘッダーにより、認証トークンや共有シークレットで Webhook のセキュリティ対策が可能。
  • Webhook はカスタムアプリ、社内データベース、ERP、n8n などセルフホスト型ツール、各種マイクロサービスとの連携を実現。
  • Zapier や Make 連携が用意されていない宛先に使うべきなのが Webhook です。

Webhook・Zapier・Make 使い分け

Parseur のデータを他システムに送る方法は主にこの 3 つ。用途で最適手段が異なります。

Zapier や Make を使うべき場合
Google Sheets・HubSpot・Salesforce・Slack・Airtable ほか、Zapier/Make のアプリライブラリに用意されているアプリにデータを渡す時はこれらを使うのが早く、ノーコードで構築できます。

Webhook を使うべき場合
カスタム開発システム、自社 DB、セルフホスト型ツール（n8n など）やノーコードツール非対応のデータベース・サービスが宛先の場合は Webhook を選択しましょう。Webhook は受信側エンドポイントの実装や後続処理を自由にでき、データ構造・レートリミットに制限がありません。

自社プロダクトや業務ツールにドキュメント自動化を組み込む場合も、Webhook が標準的な統合経路です。

Parseur の Webhook サポートイベント

Parseur は下記の Webhook イベントタイプをサポートしています：

イベント 発火タイミング 主な用途
Document Processed ドキュメント抽出処理が完了した時 汎用用途：全フィールドを含む1件ごとのペイロード
Flattened Tables テーブルを含むドキュメント処理時 スプレッドシート形式でテーブル行を平坦化
Table Item Processed テーブルフィールド内の各行ごと 各明細行を個別データベースレコードとして挿入
Export Failed Webhook 配信が失敗した時 エラー監視や Slack/メールアラート用途

特に「Table Item Processed」は請求書の明細や受注テーブル処理など、各行ごとに個別レコード化したい時に効果的です。

JSON ペイロードの内容

ドキュメントが処理されると、Parseur はエンドポイントへ JSON オブジェクトを送信します。その主な内容は以下です。

  • 抽出した各フィールド（テンプレートで指定したフィールド名と値のペア）
  • テーブル行はオブジェクト配列（各 row ごとの配列）
  • ドキュメントのメタデータ（ドキュメント ID、メールボックス ID、処理タイムスタンプ、元ファイル名など）

データ構造はテンプレート通りで、たとえばテンプレートの invoice_number は JSON の invoice_number フィールドとなります。テーブルフィールドは配列として送信され、各行にはテンプレートで設定した列の値が格納されます。

JSON の全体構造やフィールド型については Webhook ドキュメント をご参照ください。

手順ガイド: Parseur Webhook 設定方法

ステップ 1: ドキュメントをアップロード・抽出テンプレートを作成

ドキュメントをドラッグ＆ドロップ、または Parseur メールボックスへの転送でアップロードします。大量運用には 自動転送ルール の設定もおすすめです。

Parseur にドキュメントが表示されたら、抽出したいフィールドをハイライト・命名します。Parseur の AI がこのテンプレートを、同じフォーマットの今後のドキュメントに自動適用します。

Lead parsing template showing extracted fields
Define the fields you want in your JSON payload

ステップ 2: Webhook を作成

エクスポート → Webhook → 新規 Webhook をクリックし、エンドポイントの URL、トリガーイベントを選択します。

統合のテスト時は、webhook.site を使うことで全リクエスト内容や JSON ペイロードを直に確認できます。

Copy the webhook URL from webhook.site for testing
Use webhook.site to inspect the payload before connecting your real endpoint

Parseur のターゲット URL 欄に発行した URL を貼り付けます。

Paste the webhook URL into Parseur
Add your endpoint URL and choose the trigger event

ステップ 3: 認証ヘッダーの追加（推奨）

本番 API に連携する場合は、カスタム HTTP ヘッダーに認証トークンや共有シークレットを必ず追加しましょう。受信システム側でヘッダー検証を行うことで、不正リクエストから守れます。

ステップ 5: 統合テスト

Parseur メールボックスでドキュメントを再処理し、Webhook 配信が正常に行われること・期待通りの JSON 構造で到着していることを確認しましょう。

Verifying the webhook data received at the endpoint
Verify the JSON payload structure in your endpoint logs

テスト成功後は、Parseur で処理するすべてのドキュメントで自動的に JSON ペイロードがエンドポイントに送信されるようになります。

完全なセットアップ手順はWebhook ドキュメント もご活用ください。

開発者の主なユースケース

ノーコードツールでカバーできない独自システムへの連携でも、Parseur Webhook なら柔軟に統合できます。

  • カスタムデータベース: 請求書の明細データを PostgreSQL や MySQL にそのまま挿入。「Table Item Processed」なら各行が 1 レコードで挿入され、インポートの手間も最小化。
  • 社内 ERP: REST API 経由で抽出データを直接既存 ERP へ登録し、ファイル取り込み要らず。
  • マイクロサービス: 書類処理をトリガーに、後続バリデーションや出荷通知など、他サービスの自動実行も簡単。
  • n8n（セルフホスト）: 自前サーバー運用の n8n で Parseur を文書抽出レイヤーとして活用。詳細は n8n 連携ガイド を参照。
  • CRM・リードルーティング: リードメール データも CRM の受信 API へダイレクト転送、Zapier などは不要。

関連書類形式向けの無料ツール

連携前に出力 JSON を確認したい場合は、以下の無料変換ツールでブラウザ上から構造を手軽に確認できます：

Parseur API リファレンスや Webhook ペイロード詳細は データ抽出 API ガイド をご覧ください。

Parseur logo
Parseurとは？

Parseurは、メールやPDF、各種ドキュメントからテキストデータを抽出し、業務プロセスの自動化を実現する強力なドキュメント処理ソフトウェアです。 Parseurの全機能はこちら。

Webhook logo
これはWebhookとは？

Webhook は、API を使ってアプリケーションやサーバー間でデータを交換するために利用されます。Webhook は通知イベント（HTTP POST 経由）であり、Parseur が新しいドキュメントを解析するたびにトリガーされ、解析済みデータを JSON 形式で送信します。

さらに詳しく

こちらもおすすめ

Cover image for PDFをJSONに変換する方法

PDFをJSONに変換する方法

あらゆるPDFを数秒でJSONに変換。PDFをアップロードするだけで、AIが全てのフィールドやテーブルを抽出し、構造化された.jsonファイルを即座にダウンロードできます。サインアップ不要で、あらゆるPDFタイプやレイアウトに対応。

Cover image for 請求書をJSONに変換

請求書をJSONに変換

PDF請求書を数秒でJSONに変換。請求書をアップロードするだけで、すべてのフィールドと明細項目を抽出した構造化済みの.jsonファイルを瞬時にダウンロードできます。API連携やアプリケーション利用にすぐ使えます。登録不要です。

Cover image for メールやPDFから抽出したデータをn8nに送信する

メールやPDFから抽出したデータをn8nに送信する

n8nは開発者や技術チーム向けの強力な自動化プラットフォームですが、文書パースで本格運用するにはギャップがあります。標準のRead...

Cover image for ParseurとZapierを連携してメールやPDFデータ抽出を自動化しよう

ParseurとZapierを連携してメールやPDFデータ抽出を自動化しよう

Zapierには独自のEmail...

Cover image for メールやPDFから抽出したデータをMakeへ送信する

メールやPDFから抽出したデータをMakeへ送信する

Makeは非常に強力な自動化プラットフォームですが、内蔵のメールパーサーは「正規表現パターン」や「テキスト位置の固定」に頼っているため、少し送信元側のメール書式が変わっただけで抽出ができなくなってしまう、PDF添付内のデータには全く手が届かない、などの弱点があります。Parseurを組み合わせればこれらの課題を完...

Cover image for ドキュメントのデータ抽出API ― 完全ガイド（2026年版）

ドキュメントのデータ抽出API ― 完全ガイド（2026年版）

要点まとめ データ抽出APIは、非構造化ドキュメントをJSONやCSVなどの構造化データへ変換します。 データ抽出APIを利用すれば、アプリケーションやシステムにドキュメントデータ抽出機能を簡単に組み込むことが可能です。...

今すぐ始める

書類のデータ入力、
まだ手作業で続けますか？

数分で設定完了。業務で使う書類からデータを自動で抽出できます。

AIモデルの学習や複雑な初期設定は一切不要
導入したその日から本番業務で使える
少量の処理から大量の自動化まで柔軟に対応
無料で始める

よくある質問

Parseur Webhook を使い、解析済みドキュメントデータをカスタムアプリや API に送る際によくあるご質問。

Parseur Webhook とは、ドキュメントが処理されるたびに Parseur から指定した URL へ送信される HTTP POST リクエストです。リクエストのボディには抽出したフィールドが JSON 形式で含まれ、アプリケーションはリアルタイムでデータを受け取り、任意の処理・保存・ルーティングが実行できます。

JSON ペイロードには、ドキュメントから抽出されたフィールドがキーと値で含まれます。ドキュメントIDやメールボックスID、処理タイムスタンプなどのメタデータも含まれています。テーブル形式のデータはオブジェクト配列（各行が1エントリ）として送信されます。構造はテンプレートフィールド次第です。詳細なペイロード例は Parseur ドキュメントでご確認いただけます。

Parseur は配信に失敗した Webhook を自動でリトライします。一時的な停止であれば再試行されます。また「Export Failed」イベントを利用して、配信失敗時に即アラートを設定できます。

はい、n8n のセルフホスト環境でも汎用 Webhook ノードで Parseur と連携可能です（n8n インスタンスが外部公開されている必要があります）。n8n Cloud には Parseur ネイティブコネクタも利用できます。

はい、「Table Item Processed」イベントならテーブルの各行ごとに個別 Webhook イベントが発火します。これを利用すれば請求書の各明細行をデータベースの個別レコードとして書き込むことも容易です。

Parseur は4種類の Webhook トリガーイベントをサポートしています。「Document Processed」（ドキュメント処理済み）はドキュメント抽出後のフル JSON を送信します。「Flattened Tables」は各テーブル行を個別オブジェクトとして送信します。「Table Item Processed」はテーブル内各行を個別イベントとして送信します。「Export Failed」は配信失敗時に発火し、エラー監視やアラート用途に便利です。

はい可能です。Parseur では、Webhook リクエストにカスタム HTTP ヘッダー（例: Authorization 用トークンや共有シークレット）を追加できます。受信側エンドポイントでは、このヘッダーを使って受信リクエストを検証できます。特に本稼働データベースや機密ワークフロー連携時は推奨される実装です。

Zapier や Make に無い独自アプリ、自社システム、カスタムデータベースへ連携したい場合は Webhook を使います。Webhook なら受信側エンドポイントの仕様も処理内容も自由に設計可能です。一方 Google Sheets、HubSpot、Slack など一般的アプリなら Zapier/Make が素早く構築できます。

できます。webhook.site などのサービスを使えば、テスト用のパブリック URL で受信内容や JSON 構造を手軽に確認できます。Webhook を設定後、Parseur でドキュメントを再処理するとテスト配信が行われます。

はい、Parseur には REST API もあり、ドキュメントのアップロードや解析結果取得・メールボックス管理などをプログラムで操作できます。Webhook は Parseur→受信側のプッシュ型、API は受信側→Parseur のプル型となります。リアルタイム連携用途は通常 Webhook が推奨され、バッチ用途や定期ポーリングの場合は API も活躍します。