Inbound Webhook 概觀

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。

Related actions

arinova.webhook.create_webhook, arinova.webhook.list_webhooks, arinova.webhook.get_webhook

Also known as

webhook, inbound webhook, 回呼, 外部事件, 事件接收端, HTTP hook, 出站 webhook, 對外 webhook, 發送 webhook, webhook 傳送

---

Machine-readable Markdown · Knowledge index