在任何自動化加入真人覆核

以一個 HTTP 請求交給真人處理,結果回到你的工作流。

  • 同一個覆核畫面,網頁及手機 App 皆可
  • 確認的人可先修改數值
  • 可指定誰確認,每項決定都有紀錄
設定(約五分鐘)
  1. 在工作區按「新增」,選「由範本開始」,再選範本「外部自動化請人批核」。範本已包含網址觸發及等候人手確認兩個步驟。
  2. 按「發佈」並開啟工作流。沒有等候人手確認步驟的工作流會被拒絕(NO_WAIT_NODE),以免請求無人處理。
  3. 在網址觸發複製「批核 API 地址」:即 https://whatask.tech/api/v1/approvals/ 加上網址觸發地址最後的一段(/api/v1/hooks/ 之後的部分)。再按「顯示密鑰」;密鑰只存放於你的自動化平台的認證資料內。
提出請求

以 POST 送出 JSON,標頭 Authorization 設為「Bearer 加一個空格再加密鑰」。request_id 是你自己的編號:同一編號再送只算同一項批核,不會重複。

POST https://whatask.tech/api/v1/approvals/<trigger-id>
Authorization: Bearer <secret>
Content-Type: application/json

{
  "request_id": "po-1042",
  "title": "Purchase approval",
  "source": "Make",
  "fields": [
    { "key": "ref", "label": "Reference", "value": "PO-1042" },
    { "key": "limit", "label": "Limit", "type": "number", "value": 1280.5 },
    { "key": "needed_by", "label": "Needed by", "type": "date", "value": "2026-11-05" }
  ],
  "deciders": ["owner@example.com"],
  "expires_at": "2026-11-05T18:00:00+08:00",
  "callback_url": "https://hooks.example.com/whatask-approval"
}
取回結果

三種方式任選:在請求中提供 callback_url,確認或捨棄後我們以 POST 送回;以 GET 同一地址加上 /request_id 查詢;或在網址加上查詢參數 wait=25,最多等候 25 秒才回覆。

{
  "id": "8f14e45f-ceea-467a-9575-2b1c5a2e7c31",
  "request_id": "po-1042",
  "status": "confirmed",
  "decision": "confirm",
  "fields": { "ref": "PO-1042", "limit": 1280.5, "needed_by": "2026-11-05" },
  "note": null,
  "decided_by": "owner@example.com",
  "decided_at": "2026-11-01T02:14:09.000Z",
  "started": true
}

新的請求在等候有人覆核時回覆 202,started 為 true;在 wait 時間內已有人回覆則為 200,started 為 true。以同一 request_id 再送,回覆 200,started 為 false,即原有的那一項批核。status 為以下其中之一:

pending
正等候有人確認或捨棄。
confirmed
已確認;fields 為確認後的數值。
discarded
已捨棄;note 或會說明原因。
ended
執行已結束而沒有回覆,例如工作流被停止。

每次回呼附有 x-whatask-timestamp 及 x-whatask-signature(sha256= 加上以密鑰對「時間戳.內容」計算的 HMAC-SHA256),可用來核對來源;亦附有 Idempotency-Key 標頭,同一結果每次重試都相同。回呼未能送達會按 30 秒、2 分鐘、10 分鐘、30 分鐘及 2 小時重試。

各平台的做法

n8n

匯入範例工作流,在 HTTP Request 節點填入批核 API 地址。密鑰以 Header Auth 認證資料存放:名稱 Authorization,數值為 Bearer 加一個空格再加密鑰。範例以 Webhook 節點接收結果,再以 IF 節點按 decision 分流。

下載 n8n 範例工作流

Make

加入 HTTP 模組「Make a request」:方法 POST,網址為請求地址,標頭 Authorization 為 Bearer 加密鑰,內容類型 JSON。結果可用 Webhooks 模組「Custom webhook」接收,把它的地址填入 callback_url。

Zapier

加入「Webhooks by Zapier」的 Custom Request:方法 POST,同樣的網址、標頭及 JSON 內容。結果以另一個 Zap 的「Catch Hook」接收,把它的地址填入 callback_url。

其他平台及 AI 代理

任何能送出 HTTP 請求的工具均可使用,例如 Power Automate 的 HTTP 動作。AI 代理以 MCP 連接時,用工作區的 MCP 權杖代替網址觸發的密鑰,並以工作流的 workflowId 使用 request_approval 及 get_approval。

錯誤代碼

每項拒絕都以 JSON 內容的 error 欄位註明代碼。

400
請求內容未能讀取。error 為以下其中之一:BODY_NOT_JSON · REQUEST_ID_INVALID · TITLE_REQUIRED · TITLE_TOO_LONG · SOURCE_INVALID · FIELDS_INVALID · FIELDS_TOO_MANY · FILES_INVALID · DECIDERS_INVALID · EXPIRES_AT_INVALID · CALLBACK_URL_INVALID。
401
UNAUTHORIZED:密鑰不正確或未有提供。
404
NOT_FOUND:沒有此網址觸發或此 request_id;工作流未開啟時亦不接受新的請求,已提出的批核仍可查詢。
409
NO_WAIT_NODE:工作流在網址觸發之後沒有等候人手確認步驟。
413
BODY_TOO_LARGE:內容超過 64 KB。
422
DECIDERS_NOT_MEMBERS:deciders 中有人不是工作區成員。
429
RATE_LIMITED:這一分鐘的請求太多,請稍後再試。