---
{
  "id": "platform.webhook.overview",
  "topic": "webhook",
  "title": "Inbound Webhook 概觀",
  "locale": "zh-TW",
  "version": "2026-08-09.1",
  "summary": "Arinova 目前提供平台產生網址的 inbound webhook，接收外部事件後可導向平台內部目標。",
  "content": "Arinova 目前只支援 inbound webhook。建立 webhook 後，平台會依 webhook ID 產生 `/api/v1/webhooks/inbound/{webhook_id}`；使用者不需要也不能在這個功能中填入任意外部目的網址，因此它不是由 Arinova 主動呼叫第三方 URL 的 outbound callback。若要由 Arinova 對外送出事件，請改走 `delivery` 知識網域與 Office 的「送出傳遞」頁面。\n\n外部系統要對該網址送出 POST，並附上 timestamp、nonce 與 HMAC 簽章。通過驗證、防重放與流量檢查後，Arinova 會留下 fire event，並可依設定只保留稽核事件（`targetType: none`）、把渲染後的文字貼到對話、建立 Kanban 卡片，或以 inbound JSON 作為 trigger payload 啟動 active Workflow。\n\n建立入口使用 `arinova.webhook.create_webhook`；查詢目前 Agent 已獲授權的入口使用 `arinova.webhook.list_webhooks`；讀取單一設定使用 `arinova.webhook.get_webhook`。migration 已把既有 webhook 預先授權給 active external Agents，owner 可在 Office > 接收 Webhook 收回權限；新建的 owner webhook 不會自動分享，而 Agent 建立的 webhook 會在同一 transaction 授予該建立者 write。list 與 get 永遠不會回傳明文 signing secret。\n",
  "aliases": [
    "webhook",
    "inbound webhook",
    "回呼",
    "外部事件",
    "事件接收端",
    "HTTP hook",
    "出站 webhook",
    "對外 webhook",
    "發送 webhook",
    "webhook 傳送"
  ],
  "tags": [
    "inbound",
    "overview",
    "routing"
  ],
  "relatedActions": [
    "arinova.webhook.create_webhook",
    "arinova.webhook.list_webhooks",
    "arinova.webhook.get_webhook"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/webhook/overview/"
}
---

Arinova 目前只支援 inbound webhook。建立 webhook 後，平台會依 webhook ID 產生 `/api/v1/webhooks/inbound/{webhook_id}`；使用者不需要也不能在這個功能中填入任意外部目的網址，因此它不是由 Arinova 主動呼叫第三方 URL 的 outbound callback。若要由 Arinova 對外送出事件，請改走 `delivery` 知識網域與 Office 的「送出傳遞」頁面。

外部系統要對該網址送出 POST，並附上 timestamp、nonce 與 HMAC 簽章。通過驗證、防重放與流量檢查後，Arinova 會留下 fire event，並可依設定只保留稽核事件（`targetType: none`）、把渲染後的文字貼到對話、建立 Kanban 卡片，或以 inbound JSON 作為 trigger payload 啟動 active Workflow。

建立入口使用 `arinova.webhook.create_webhook`；查詢目前 Agent 已獲授權的入口使用 `arinova.webhook.list_webhooks`；讀取單一設定使用 `arinova.webhook.get_webhook`。migration 已把既有 webhook 預先授權給 active external Agents，owner 可在 Office > 接收 Webhook 收回權限；新建的 owner webhook 不會自動分享，而 Agent 建立的 webhook 會在同一 transaction 授予該建立者 write。list 與 get 永遠不會回傳明文 signing secret。