Webhook

技術用語
約1分で読めます

特定のイベントが発生した際に、サーバーが指定されたURLにリアルタイムでデータを送信するHTTPベースのイベント通知メカニズムです。

別名
ウェブフック

詳しい説明

Webhookは「逆方向のAPI」とも呼ばれ、アプリケーション間でリアルタイムにデータをやり取りする効率的な方式です。クライアントがサーバーにデータを要求するポーリング（Polling）方式とは異なり、サーバーで特定のイベント（決済完了、コードのプッシュ、AIタスクの完了など）が発生すると、あらかじめ登録されたURLにHTTP POSTリクエストを送信します。これにより、システムはリソースを無駄にすることなく、イベント発生後すぐに後続の処理を実行できます。特に処理時間が長い生成AIのAPIや、自動化ワークフローを構築する際に不可欠な技術要素です。

AIツール選定において重要な理由

大規模言語モデル（LLM）や画像生成AIは、結果が出力されるまでに時間がかかる非同期処理が多く存在します。このとき、Webhookに対応しているツールを選択してこそ、いつまでも待機することなく、タスク完了のタイミングに合わせて効率的に成果物を受け取り、次のステップを実行することができます。

確認すべき点

  • セキュリティのための署명検証（Secret Key/HMAC）機能をサポートしているか？
  • 送信失敗時の再試行（Retry）ロジックが実装されているか？
  • 送信されるデータ形式（JSONなど）が既存システムと互換性があるか？
  • テスト用のログ確認およびシミュレーション機能が提供されているか？

実際の活用例

ユーザーがチャットボットに複雑な分析を依頼すると、AIサービスは分析を終えた後、あらかじめ指定されたSlackのWebhook URLに結果メッセージを送信し、ユーザーに即座に通知を送ります。

混同しやすい用語

Polling

データが存在するかどうかを確認するために、クライアントが定期的にサーバーに問い合わせる方式（リソース消費が大きい）

Webhook

イベントが発生した時のみサーバーがクライアントに通知する方式（リアルタイム性と効率性が高い）

関連用語

APIREST