建立 Webhook 與設定目標

arinova.webhook.create_webhook 必填 name。targetType 預設 none、enabled 預設 true；ISO-8601 expiresAt 是 inbound 時間 gate。

targetConfig 必須符合對應形狀：

- none：必須是空物件 {}。 - post_to_conversation：必填 conversationId、messageTemplate；senderType 只能是 system。 - create_card：必填 boardId、titleTemplate；可選 columnId、descriptionTemplate 與 label UUIDs。 - run_workflow：只需 workflowId。工作流程必須屬於 Webhook owner，且在事件 dispatch 時為 active。

run_workflow 把 accepted JSON 原樣作為 trigger_payload，頂層欄位用 {{trigger.payload.field}}。它另有 102,400-byte payload cap，小於 inbound 1 MiB；超過會 render_error。Success 只代表建立 run。該 Workflow 在 rolling hour 內達預設十 runs（所有 status 都計數）後，function 會 skipped／workflow_rate_limited。

Missing target 拒絕 create/update；existing target 若 owner 權限不足，仍保存並回 targetPermissionWarning，但修正前會失敗。Dispatch 會重查 captured config。

每位 owner 最多 100 個 non-cancelled Webhooks。Create 只顯示一次明文 signingSecret；idempotency replay、list、get 都不揭露。Metadata、target、enabled、expiry、status: active 用 update；rotation 另需確認。

Related actions

arinova.webhook.create_webhook, arinova.webhook.update_webhook, arinova.webhook.get_webhook

Also known as

建立 webhook, targetType, targetConfig, 貼到對話, 建立卡片, 執行工作流程, 事件目的地

---

Machine-readable Markdown · Knowledge index