Webhookとは、あるサービスで決まった出来事が起きたときに、あらかじめ登録したURLへ、その内容を自動で送る仕組みのことです。たとえば、「Webのフォームに回答があった」「決済が完了した」といった出来事をきっかけに、そのデータを別のシステムへすぐに届けられます。こちらから聞きに行くのではなく、相手から知らせてもらう形のため、「逆向きのAPI」と説明されることもあります。
Webhookは、どんな仕組みか?
送る側のサービスに、知らせてほしい出来事と送り先のURLを登録しておきます。出来事が起きると、送る側がそのURLへデータを送り、受け取る側がその内容に応じて処理をします。
送り先を用意する
受け取る側で、データを受け取るためのURLを用意します。
送る側に登録する
送る側のサービスの設定画面などで、送り先のURLと、知らせてほしい出来事を登録します。
出来事が起きると送られる
登録した出来事が起きると、その内容がURLへ自動で送られます。
受け取って処理する
受け取る側は、届いた内容を確かめてから、登録や通知などの処理を行います。
WebhookとAPIは、どう違うのか?
APIは、必要なときにこちらから相手に問い合わせる仕組みで、Webhookは、出来事が起きたときに相手から知らせてもらう仕組みです。変化をすぐに知りたいときは、Webhookのほうが向いています。
実際には、Webhookで「出来事が起きた」ことを受け取り、詳しいデータはAPIで取りに行く、という組み合わせもよく使われます。
| 比べる点 | API(問い合わせ) | Webhook |
|---|---|---|
| やり取りの向き | こちらから相手に問い合わせる | 相手からこちらに知らせてくる |
| データが届くまでの時間 | 問い合わせる間隔による | 出来事が起きてすぐ |
| むだなやり取り | 変化がなくても、問い合わせが発生する | 出来事が起きたときだけ送られる |
| 向いている場面 | 必要なときに、必要なデータを取りに行く | 新しい注文や回答を、すぐ次の処理につなげる |
Webhookで、何ができるのか?
フォームの回答や決済、問い合わせなどの出来事を、すぐにほかのシステムの処理や通知につなげられます。
- Webのフォームの回答を、CRMに登録し、担当者のチャットに知らせる
- 決済の完了を受けて、受注の処理や発送の手配を始める
- 予約や申し込みを、社内のカレンダーや管理表に反映する
- プログラムの更新をきっかけに、テストや公開の作業を自動で始める
- 問い合わせの受け付けをきっかけに、生成AIで内容を要約・分類する
Webhookを使うときの注意点は?
届いたデータが本物かを確かめること、届かない・二重に届くことに備えること、受け取ったらすぐに応答することの3つが大切です。
- 本物かを確かめる
- 送り先のURLは、外からデータが届く窓口です。送る側が付ける署名などを確かめ、ほかから送られたデータを受け付けないようにします。
- 届かない・二重に届くことに備える
- 通信の失敗で届かなかったり、再送で同じ内容が二度届いたりすることがあります。同じ内容を二度処理しない作りにします。
- すぐに応答する
- 受け取る側の処理が長いと、送る側が失敗とみなして再送することがあります。受け取ったことをすぐに返し、重い処理はあとで行います。
- 届いた記録を残す
- 何が、いつ届き、どう処理したかを記録しておくと、連携が止まったときに原因を追えます。
トラックファームでは、Webhookをどう扱っているか?
Webhookは、業務システムの開発やAIエージェントによる業務の自動化で、出来事をきっかけに処理を始める入り口として使います。署名の確認や、失敗したときのやり直しまで含めて設計します。
よくある質問
Webhookを使うのに、プログラミングは必要ですか?
受け取る側を自分でつくる場合は、プログラミングが必要です。ただ、iPaaSやノーコードのツールには、Webhookを受け取る部品を備えたものもあり、画面の操作だけで使える場合があります。
使っているSaaSがWebhookに対応しているかは、どう調べればいいですか?
提供している会社の開発者向けの説明ページや、設定画面の「連携」「通知」といった項目を確かめるのが近道です。知らせてもらえる出来事の種類は、サービスによって違います。
