學習中心/術語一次搞懂·5 分鐘

Webhook 是什麼?跟 API 差在哪?

// 一句話回答

Webhook 是一種「事件一發生,就自動主動通知你」的機制。跟一般要你「主動去問」的做法相反:webhook 是「有事它自己來敲門」。例如有客人下單,系統就立刻透過 webhook 通知你的另一個系統去出貨、記帳。

先看兩種做法的差別

想知道「有沒有新消息」,有兩種做法。第一種是「主動一直去問」:每隔一段時間就問一次「有新的了嗎?」——這叫「輪詢(polling)」,像你每分鐘手動刷新一次收件匣。

第二種反過來:「有新消息時,對方主動推給你」——這就是 webhook,像手機設定好,一有新信就自動跳通知,你不必一直去看。

輪詢很費力又常常白問;webhook 即時又省力。所以要做「即時、自動」的串接,webhook 是常見的選擇。

Webhook 到底是什麼

具體來說:你先給對方一個網址(相當於「你家的門牌」),並約定「當某個事件發生時,就往這個網址送一則通知」。

之後只要那個事件一觸發(有人付款、有人填表),對方的系統就自動把一則訊息「送到你的門口」,你的系統收到後就接著做該做的事。整個過程不需要有人盯著。

用生活比喻

想像你在等一件缺貨商品到貨。輪詢=你每天打電話問店家「到了沒?」,很煩。Webhook=你留電話給店家,到貨時店家主動打給你。

Webhook 就是那個「到貨自動通知」:把主動權從你這邊,交給「事件發生的那一方」。

常見用途

  • 金流:客人付款成功,webhook 立刻通知你的系統去出貨、開發票
  • 電商:新訂單進來,自動同步到你的 ERP 或倉儲
  • 表單:有人填了表單,自動通知負責的同事或建立一筆資料
  • 聊天機器人:使用者傳訊息,webhook 把訊息推給你的程式去回覆

對企業的意義

Webhook 讓「即時、自動」變得可能:客人一付款,後台立刻出貨、記帳、發通知,全程不用人一直盯著問。它是把多個系統串成「自動流水線」時,最常見的零件之一。

常見問題

Webhook 跟 API 差在哪?

方向相反。API 多半是「你主動去要資料」;webhook 是「有事對方主動推給你」。兩者常一起用:對方用 webhook 通知你發生了事,你再用 API 去拿詳細資料或做後續動作。

Webhook 安全嗎?

本身沒問題,但因為是「別人往你網址送資料」,要防有人偽造假通知。常見做法是驗證來源、用密鑰簽章確認「這則通知真的來自對方」。設定時要留意這點。

設 webhook 一定要工程師嗎?

通常要一點技術設定(提供網址、處理收到的通知),但很多工具(金流、電商、自動化平台)都有現成介面,照著填網址即可,不一定要從頭寫程式。

為什麼叫 webhook?

web(網路)+ hook(掛鉤)——意思是「在網路事件上掛一個鉤子」,事件一發生就自動觸發你設定的通知。名字本身就描述了它的行為。

延伸閱讀

想讓整個團隊真的會用 AI?

我把自己經營公司在用的 AI 實戰,做成企業內訓 —— 帶團隊用真實任務當場做出成果。

看企業 AI 內訓