---
{
  "id": "platform.delivery.overview",
  "topic": "delivery",
  "title": "Outbound Delivery 概觀",
  "locale": "zh-TW",
  "version": "2026-08-09.1",
  "summary": "Delivery 是 outbound-only，將 event 與 JSON payload 非同步排入 owner 已註冊且 active 的 endpoint。",
  "content": "Delivery 是 outbound-only：把 event 名稱與 JSON payload 送到 owner 在 Office > 送出傳遞註冊的 endpoint。`arinova.delivery.list_endpoints` 只列已 explicit grant 的安全 metadata：ID、name、kind、status，刻意不含 target URL 與 secret；`arinova.delivery.send` 需要 `write` grant 才會把工作排入 durable queue。Migration 只把既有 endpoint 預先授權給 active external Agents；platform Agents 取得零 grants，新 endpoint 也要由 owner 在 Office 授權後才會分享。因此空清單可能代表「沒有 grants」，不代表「沒有 endpoints」。endpoint 必須已存在且為 `active`。建立、驗證、啟用、輪替、停用與刪除都是 Office 人工操作，Agent 沒有這些 actions。\n\nsend 成功回 `deliveryId` 與 `status=queued`，只表示 Arinova 已收單，不代表接收端已收到。最終狀態由 durable worker 決定，owner 可在 Office 查看逐筆歷史。enqueue 成功依目前設定扣 owner 的 Arinova credit；被 rate limit 拒絕時不建立 delivery，也不扣款。說明狀態時一律優先採用當下 action result 與 persisted history。\n\n分流關鍵是方向：Webhook 是外部進 Arinova；Delivery 是 Arinova 送到外部；Trigger 回應平台內資源事件；Email 收信且只能回覆。Workflow `notify` step 寫入 owner 的內部 Notification Center，絕不是 Delivery。詢問「收到 delivery／webhook」或「外部事件進來」不屬於 Delivery。Office Agent 可能取得 endpoint collaboration context，terminal endpoint 也可用來解釋歷史；但送出仍要求 active endpoint 與 write grant。\n",
  "aliases": [
    "對外傳送",
    "外部端點",
    "送到我們的系統",
    "把結果推到外部",
    "outbound delivery",
    "delivery endpoint",
    "external endpoint"
  ],
  "tags": [
    "delivery",
    "overview",
    "outbound"
  ],
  "relatedActions": [
    "arinova.delivery.list_endpoints",
    "arinova.delivery.send"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/delivery/overview/"
}
---

Delivery 是 outbound-only：把 event 名稱與 JSON payload 送到 owner 在 Office > 送出傳遞註冊的 endpoint。`arinova.delivery.list_endpoints` 只列已 explicit grant 的安全 metadata：ID、name、kind、status，刻意不含 target URL 與 secret；`arinova.delivery.send` 需要 `write` grant 才會把工作排入 durable queue。Migration 只把既有 endpoint 預先授權給 active external Agents；platform Agents 取得零 grants，新 endpoint 也要由 owner 在 Office 授權後才會分享。因此空清單可能代表「沒有 grants」，不代表「沒有 endpoints」。endpoint 必須已存在且為 `active`。建立、驗證、啟用、輪替、停用與刪除都是 Office 人工操作，Agent 沒有這些 actions。

send 成功回 `deliveryId` 與 `status=queued`，只表示 Arinova 已收單，不代表接收端已收到。最終狀態由 durable worker 決定，owner 可在 Office 查看逐筆歷史。enqueue 成功依目前設定扣 owner 的 Arinova credit；被 rate limit 拒絕時不建立 delivery，也不扣款。說明狀態時一律優先採用當下 action result 與 persisted history。

分流關鍵是方向：Webhook 是外部進 Arinova；Delivery 是 Arinova 送到外部；Trigger 回應平台內資源事件；Email 收信且只能回覆。Workflow `notify` step 寫入 owner 的內部 Notification Center，絕不是 Delivery。詢問「收到 delivery／webhook」或「外部事件進來」不屬於 Delivery。Office Agent 可能取得 endpoint collaboration context，terminal endpoint 也可用來解釋歷史；但送出仍要求 active endpoint 與 write grant。