Webhook連携ガイド — FAX OCR結果をリアルタイムで外部システムに送る

SP-FAX OCRにはkintoneやfreeeとのダイレクト連携機能がありますが、「うちの基幹システムは自社開発なんだけど...」「GAS（Google Apps Script）でスプレッドシートに書き込みたい」「Slackに通知を飛ばしたい」という声もよくいただきます。

そんなときに使えるのがWebhook連携です。OCR結果が承認されたタイミングで、指定したURLにJSONデータをリアルタイムでPOSTします。受け取り側さえ用意すれば、どんなシステムとでも繋がります。

この記事では、Webhookの仕組みから設定方法、送信されるJSONの構造、そして実際の活用例まで、ステップバイステップで解説します。

Webhookとは何か

Webhookは「イベントが発生したら、指定URLにHTTPリクエストを送る」仕組みです。SP-FAX OCRの場合、OCR結果が承認されたタイミングがイベントのトリガーになります。

つまりWebhookを使えば、FAXが届いてからOCR→レビュー→承認→外部システム登録まで、すべてをリアルタイムの一本道でつなげられます。

Webhookの設定方法

設定は管理画面の「外部連携（コネクター）」から行います。数分で完了します。

外部連携の設定画面。「コネクターを追加」からWebhookを選択する。

送信されるJSONの構造

OCR結果が承認されると、以下のようなJSONが指定URLにPOSTされます。Content-Typeは application/json です。

{
  "event": "ocr.approved",
  "timestamp": "2026-03-18T10:30:00+09:00",
  "data": {
    "ocr_id": "ocr_abc123def456",
    "document_type": "order",
    "sender": {
      "fax_number": "03-1234-5678",
      "company_name": "山田自動車整備工場",
      "resolved_name": "山田自動車整備工場"
    },
    "items": [
      {
        "product_code": "SL-H4-060",
        "product_code_raw": "SL H4 060",
        "product_name": "LEDヘッドライト H4 6000K",
        "quantity": 6,
        "quantity_raw": "6ヨウ",
        "unit_price": 4980,
        "note": "納期3/25希望"
      },
      {
        "product_code": "SL-HB3-045",
        "product_code_raw": "HB3-045",
        "product_name": "LEDヘッドライト HB3 4500K",
        "quantity": 2,
        "quantity_raw": "2",
        "unit_price": 5200,
        "note": ""
      }
    ],
    "plain_text": "注文書\n山田自動車整備工場\n...",
    "pdf_url": "https://fax.spread-inc.co.jp/api/ocr/ocr_abc123def456/pdf",
    "approved_by": "tanaka@example.com",
    "approved_at": "2026-03-18T10:30:00+09:00"
  }
}

Webhook活用例

Webhookの受け取り先次第で、活用方法は無限に広がります。代表的な例を紹介します。

function doPost(e) {
  const payload = JSON.parse(e.postData.contents);
  const sheet = SpreadsheetApp.getActiveSpreadsheet()
    .getSheetByName("FAX受注");

  // 承認済みOCR結果の各明細行を追記
  payload.data.items.forEach(item => {
    sheet.appendRow([
      payload.data.approved_at,
      payload.data.sender.company_name,
      payload.data.document_type,
      item.product_code,
      item.product_name,
      item.quantity,
      item.unit_price,
      item.note
    ]);
  });

  return ContentService
    .createTextOutput("OK")
    .setMimeType(ContentService.MimeType.TEXT);
}

セキュリティと信頼性

Webhookで送信されるデータにはFAX注文書の品番・数量・取引先名など業務上重要な情報が含まれます。安全に運用するためのポイントを押さえておきましょう。

承認前のレビュー画面

Webhookで送信されるデータは、担当者がレビュー画面で確認・修正したあとの確定データです。参考までに、レビュー画面の実際の様子を紹介します。

レビュー画面。左にFAX原本、右にAIが抽出した構造化データ。「承認」を押した瞬間にWebhookが発火する。

AIの読み取り結果に誤りがあればこの画面で修正し、「承認」を押します。Webhookには修正後の正確なデータだけが送信されるため、受け取り側で二重チェックする必要はありません。