Webhook

Webhookとは、特定のイベントが発生した際に、あるアプリケーションから別のアプリケーションへ自動的にデータを送信するHTTPコールバックです。更新をポーリングする[API](/glossary/api)とは異なり、Webhookはイベント発生時にリアルタイムでデータをプッシュします。受信アプリケーションは指定されたURLエンドポイントでリクエストを待ち受け、到着と同時にデータを処理します。Webhookはパブリッシャー・サブスクライバーモデルに従います — ソースアプリケーションがトリガーイベント発生時に事前登録されたURLへHTTP POSTリクエストを送信し、サブスクライバー側がペイロードを要求せずに処理します。

Webhookにより、システム間の手動データ転送や定期的なポーリングが不要になります。デジタルパブリッシャーにとって、キャプチャされたリード、販売トランザクション、閲覧者のアクティビティが発生した瞬間にCRM、メールプラットフォーム、内部データベースに自動的に流れることを意味します。遅延が数分・数時間からミリ秒に短縮され、手動でのエクスポート・インポート作業がなくなり、ビジネスシステムが常に最新データを持つことが保証されます。Webhookがなければ、チームはダッシュボードを手動で確認するか、リアルタイムイベントに遅れるバッチプロセスを構築する必要があります。

FlipLinkの[オートメーションとインテグレーション](/features/automation-and-integrations)機能は、重要なイベント発生時に起動するWebhookをサポートしています。新しいリードのキャプチャ、ドキュメントの閲覧、Stripeを通じた販売完了時にデータを受信するWebhookエンドポイントを設定できます。各Webhookはイベント詳細を含む構造化JSONペイロードを指定URLに送信します。これによりFlipLinkをZapier、Make、カスタムバックエンドなど事実上あらゆるシステムに接続できます。[Google Sheetsインテグレーション](/features/automation-and-integrations)との組み合わせにより、コードを書かずにパブリケーションワークフロー全体を自動化する柔軟な方法を提供します。

トリガーイベント発生時、FlipLinkは登録済みエンドポイントURLにHTTP POSTリクエストを送信します。リクエストボディには以下の構造のJSONペイロードが含まれます： - **イベントタイプ** — イベントを識別する文字列（例：`lead.captured`、`document.viewed`、`sale.completed`） - **タイムスタンプ** — ISO 8601形式のイベント発生日時 - **ペイロードデータ** — 連絡先名、メールアドレス、ドキュメントタイトル、取引金額などのイベント固有のフィールド エンドポイントは受信確認としてHTTP 200ステータスコードを返す必要があります。エンドポイントがエラーを返すかタイムアウトした場合、FlipLinkはイベントが失われないよう配信を再試行します。すべてのWebhookペイロードはHTTPS経由で送信されるため、データは転送中に暗号化されます。カスタムインテグレーションを構築する開発者にとって、一貫したJSON構造によりイベントの解析とアプリケーション内の適切なハンドラーへのルーティングが容易になります。

1. **エンドポイントを準備する。** サーバー、Zapier、Make、またはPOSTリクエストを受信できるサービスにHTTPS URLを設定します。エンドポイントは公開アクセス可能で、200レスポンスを返す必要があります。 2. **インテグレーションに移動する。** FlipLinkダッシュボードで、パブリケーションの[オートメーションとインテグレーション](/features/automation-and-integrations)設定に移動します。 3. **Webhook URLを追加する。** エンドポイントのURLをWebhook設定フィールドに貼り付けます。 4. **トリガーイベントを選択する。** リードキャプチャ、ドキュメント閲覧、販売完了など、ワークフローのニーズに応じてWebhookを起動するイベントを選択します。 5. **テストイベントを送信する。** テスト機能を使用してサンプルペイロードをエンドポイントに送信します。システムがデータを正しく受信・処理することを確認します。 6. **本番運用を開始する。** 設定を保存します。この時点から、フリップブック内のすべての一致するイベントがエンドポイントへのリアルタイムPOSTをトリガーします。 7. **配信を監視する。** エンドポイントのログを定期的に確認し、Webhookが到着していることを確認します。ギャップに気づいた場合、エンドポイントが200レスポンスを返しているか、サーバーにFlipLinkのリクエストをブロックするファイアウォールルールがないか確認してください。

| 項目 | Webhook | APIポーリング | |------|---------|--------------| | **データ配信** | イベント発生時に自動プッシュ | 定義したスケジュールでプル | | **遅延** | ほぼ即時（ミリ秒） | ポーリング間隔に依存（秒〜分） | | **サーバー負荷** | 最小限 — イベント発生時のみリクエスト | 高い — 変更がなくても毎間隔でリクエスト | | **実装** | URLを登録し、受信POSTリクエストを処理 | APIエンドポイントを繰り返し呼び出すスケジュールジョブを構築 | | **最適な用途** | リアルタイム通知、CRM同期、即時アラート | バッチ処理、定期レポート、データスナップショット | | **リスク** | リトライロジックなしではエンドポイントダウン時にイベント損失の可能性 | ポーリングが追いつけばイベント損失なし、ただし認知が遅延 | ほとんどのFlipLinkパブリッシャーにとって、速度が重要なリードキャプチャや販売イベントにはWebhookが最良の選択です。APIポーリングは定期的なアナリティクスエクスポートや一定間隔で更新するダッシュボードに適しています。多くのチームは両方を使用しています：リアルタイムのリードルーティングにはWebhook、夜間のアナリティクス抽出には[REST API](/glossary/rest-api)。