Webhookとは？APIとの違い・仕組みと連携での使い方

Webhookとは

Webhookとは、あるサービスで特定の出来事（イベント）が起きたときに、そのサービスから事前に登録しておいたURLへ、自動的に通知のデータを送る仕組みです。

平易に言えば、「何かあったら電話で知らせてくれる仕組み」です。通常のAPIでは、こちらから「新しい注文はありますか」と定期的に問い合わせる必要があります。Webhookでは、注文が入った瞬間に相手から知らせてくれるため、問い合わせを繰り返す必要がなく、すぐに次の処理を始められます。

Webの「フック（引っかける）」という意味で、イベントに処理を引っかける仕組みを指します。サービスによっては「コールバックURL」「通知URL」「イベント通知」などと呼ばれることもあります。

Webhookの基本的な流れは次のとおりです。

APIとの違いを整理します。

実務では、Webhookで即時に通知を受け取り、念のため定期的にAPIで状態を確認して取りこぼしを補う、という組み合わせがよく使われます。

Webhookが使われる代表的な場面には、次のようなものがあります。

ある会社が、オンライン講座の申込と決済を自動化するとします。決済サービスのWebhookを使うと、次のように処理がつながります。

ここで重要なのは、画面上で「決済完了」と表示されたことではなく、Webhookで届いた決済結果を正として処理することです。利用者がブラウザを途中で閉じても、Webhookは届くため、申込の取りこぼしを防げます。

届いた通知をそのまま信用してしまう。 WebhookのURLは外部から呼び出せるため、偽の通知が送られる可能性があります。送信元が提供する署名の検証や、送信元の確認を必ず行いましょう。

同じ通知が二度届くことを想定しない。 送る側は、応答がなかった場合などに同じ通知を再送します。同じイベントを二度処理して、二重にアカウントを発行したり、二重にポイントを付与したりしないよう、イベントIDで処理済みかを確認する仕組みが必要です。

受信側で重い処理をしてしまう。 応答に時間がかかると、送る側はタイムアウトとみなして再送します。受け取ったらすぐに応答を返し、重い処理は裏側で順番に実行するのが基本です。

届く順番が保証されていると考える。 通知は発生順に届くとは限りません。「キャンセル」が「注文作成」より先に届いても破綻しない設計にしておきましょう。

Otsumuは、決済、LINE、EC、予約サービスなどのWebhookを使った連携を、署名の検証、重複処理の防止、取りこぼしの補完まで含めて設計・開発しています。手作業で確認している通知を自動処理につなげたい場合もご相談ください。

執筆：Otsumu株式会社／編集日 2026.10.01