---
{
  "id": "platform.webhook.create-and-targets",
  "topic": "webhook",
  "title": "建立 Webhook 與設定目標",
  "locale": "zh-TW",
  "version": "2026-08-09",
  "summary": "建立時支援四種嚴格的目標設定、可選到期時間，並只顯示一次 signing secret。",
  "content": "`arinova.webhook.create_webhook` 必填 `name`。`targetType` 預設 `none`、`enabled` 預設 true；ISO-8601 `expiresAt` 是 inbound 時間 gate。\n\n`targetConfig` 必須符合對應形狀：\n\n- `none`：必須是空物件 `{}`。\n- `post_to_conversation`：必填 `conversationId`、`messageTemplate`；`senderType` 只能是 `system`。\n- `create_card`：必填 `boardId`、`titleTemplate`；可選 `columnId`、`descriptionTemplate` 與 label UUIDs。\n- `run_workflow`：只需 `workflowId`。工作流程必須屬於 Webhook owner，且在事件 dispatch 時為 active。\n\n`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`。\n\nMissing target 拒絕 create/update；existing target 若 owner 權限不足，仍保存並回 `targetPermissionWarning`，但修正前會失敗。Dispatch 會重查 captured config。\n\n每位 owner 最多 100 個 non-cancelled Webhooks。Create 只顯示一次明文 `signingSecret`；idempotency replay、list、get 都不揭露。Metadata、target、enabled、expiry、`status: active` 用 update；rotation 另需確認。\n",
  "aliases": [
    "建立 webhook",
    "targetType",
    "targetConfig",
    "貼到對話",
    "建立卡片",
    "執行工作流程",
    "事件目的地"
  ],
  "tags": [
    "configuration",
    "display-once",
    "targets"
  ],
  "relatedActions": [
    "arinova.webhook.create_webhook",
    "arinova.webhook.update_webhook",
    "arinova.webhook.get_webhook"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/webhook/create-and-targets/"
}
---

`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 另需確認。