在任何自動化加入真人覆核
以一個 HTTP 請求交給真人處理,結果回到你的工作流。
- 同一個覆核畫面,網頁及手機 App 皆可
- 確認的人可先修改數值
- 可指定誰確認,每項決定都有紀錄
設定(約五分鐘)
- 在工作區按「新增」,選「由範本開始」,再選範本「外部自動化請人批核」。範本已包含網址觸發及等候人手確認兩個步驟。
- 按「發佈」並開啟工作流。沒有等候人手確認步驟的工作流會被拒絕(NO_WAIT_NODE),以免請求無人處理。
- 在網址觸發複製「批核 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:這一分鐘的請求太多,請稍後再試。