Textbook / 5 min read

Webhook(ウェブフック)の教科書

「Webhookって何?設定して大丈夫?」に、5分で答えます。

Webhookとは何か

ふだん私たちがネット上の何かを知りたい時は、自分から「聞きに行く」のが基本です。お店の在庫を知りたければ、お店に電話して「在庫ありますか?」と聞き、答えが返ってくるのを待ちます。Webhook(ウェブフック)は、この関係を逆転させる仕組みです。

たとえるなら
毎日何度もお店に電話して「入荷しました?」と聞く代わりに、入荷した瞬間にお店側から自動で電話がかかってくる——それがWebhookです。あなたは待っているだけで、起きたことがその場で届きます。

LINE公式アカウントやInstagramに置き換えると、こうなります。お客さまがあなたのアカウントにメッセージを送った瞬間、LINEやInstagram側が「メッセージが届きました」と、あなたのシステムに自動で知らせてくれる。この「自動で知らせる」役割を果たしているのがWebhookです。あなたのシステムが四六時中「新着メッセージないですか?」と聞き続けなくても、届いた瞬間に反応できるのはこのおかげです。

なぜ必要なのか

もしWebhookがなければ、あなたの自動応答システムは「今この瞬間に何かが起きたこと」を知る手段がありません。お客さまからメッセージが来ても、システム側から定期的に確認しに行かない限り、気づけないのです。それでは即返信どころか、反応そのものが遅れてしまいます。

「Webhookを設定する」とは、LINEやInstagramに対して「何か起きたら、この住所(URL)に知らせてください」と登録することだけです。難しい仕組みを作るわけではなく、届け先の住所を1回教えておく、というシンプルな話。この届け先は、Cloudflare Workerの教科書で説明している、あなた自身のシステムのURLを指すのが一般的です。

安全性・費用について

Webhook URLは秘密情報?パスワードほどの機密ではありませんが、非公開の電話番号のようなものです。このURLに届いた内容はそのままシステムが処理するため、SNSや公開の場に貼り出すことは避けてください
設定を間違えたらどうなる?多くの場合、単に「メッセージが届かない・自動応答が動かない」だけです。データが壊れたり、危険な事態になることは基本的にありません
費用はかかる?Webhookの設定自体に料金はかかりません。LINEやInstagramの管理画面にURLを1つ登録するだけの作業です
設定は難しい?ほとんどの場合、決められた入力欄にURLを1回貼り付けるだけです。一度設定すれば、それ以降は自動で動き続けます
似た言葉に「API」がありますが、役割は逆です。APIはあなたから「聞きに行く」ための窓口、Webhookは相手から「知らせが来る」ための窓口。違いはAPIの教科書で詳しく説明しています。

よくある不安

Webhook URLを他の人に教えてしまったら危険ですか?
すぐに深刻な被害が出るものではありませんが、そのURL宛に誰でもデータを送り込める状態になるため、公開の場に載せるのは避け、心当たりのない相手に教えないようにしてください。心配であれば、URLを作り直すこと(再発行)もできます。
設定を間違えたら何か壊れますか?
いいえ。多くの場合は「自動応答が動かない」だけで、既存のデータやアカウント自体に影響が出ることはありません。落ち着いて設定を見直せば直せます。
毎回設定し直す必要がありますか?
いいえ。一度正しく登録すれば、URLを変更しない限りそのまま動き続けます。日々の運用で触る場面はほとんどありません。
難しそうですが自分で作る必要がありますか?
ゼロから仕組みを作る必要はありません。多くのツールはWebhookを受け取る側の仕組みをあらかじめ用意しており、あなたがやるのは指定された欄にURLを貼り付けるだけ、というケースがほとんどです。
← 用語の教科書 一覧へ戻る