C TWO（預覽）

C TWO 是一個代理管理平台，負責協調自動化工作流程、管理人機互動，並透過通用佇列處理工作項目。 使用此連接器觸發來自 C TWO 會話的流程、管理會話生命週期、建立與處理佇列項目，並實現與數位工作者的人機互動。

此連接器適用於以下產品和區域：

服務 Class Regions
Copilot Studio 進階 除以下部分外，所有Power Automate區域：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government regions
     - Azure中國地區
     - 美國國防部 （DoD）
Power Apps 進階 除以下部分外，所有Power Apps區域
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除以下部分外，所有Power Automate區域：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
聯絡方式
名稱 C TWO 支援
URL https://ctwo.com/
Email customersuccess@ctwo.com
連接器中繼資料
發行者 C 二
網站 https://ctwo.com/
隱私策略 https://ctwo.com/privacy-policy/
類別 商業智能;人工智慧

C 二

C TWO 是一個代理管理平台，負責協調自動化工作流程、管理人機互動，並透過通用佇列處理工作項目。 此連接器讓 Power Automate、Power Apps、Azure Logic Apps 及 Copilot Studio 能觸發並被 C TWO 會話觸發，管理會話生命週期，建立與處理通用排隊列項目，並實現與數位工作者的人工互動。

C TWO 位於您的自動化資產之上，作為單一的編排、治理與監控層：無論創建或執行工作，C TWO 都會新增 SLA 追蹤、重試與自我修復、即時會話遙測，以及完整的稽核追蹤。

Prerequisites

在建立連結之前，你需要：

  1. 一個活躍的 C TWO 租戶——要麼是 C TWO 雲端（託管）或可透過 HTTPS 存取的本地 C TWO 伺服器。
  2. 由您的 C TWO 管理員核發的 服務帳號令牌 或 個人存取令牌 （參見 取得憑證）。
  3. 如果 C TWO 是本地主機，伺服器必須能透過 Power Platform 透過 HTTPS 存取（防火牆允許 Microsoft 的 Power Automate 外撥 IP 範圍——包括 Azure 服務標籤AzureConnectors.<region>及PowerPlatformPlex你的 Power Platform Geo）。
  4. 一個具備自訂連接器權限的 Power Platform 環境，以及支援自訂連接器的授權層級（Power Automate Premium 或同等版本）。

正在建立連線

當你建立連線時，你會提供 三個值，全部來自你自己的 C TWO 環境：

  1. C TWO 主機 — 僅使用你的 C TWO 伺服器主機名稱（無配置，無尾部斜線），例如 connect24.ctwo.cloud，或為本地主機，並可選連接埠，如 ctwo.contoso.com:8443。
  2. C TWO Base URL — 您的 C TWO API 的基底路徑，包含你的除法，以斜杠開頭且無斜線，例如 /DEFAULT/CTWO.Server/api。
  3. API 金鑰 — 您的憑證，輸入為 Bearer <your-token>。 建議使用 服務帳戶 代幣; 個人存取令牌 也可使用。

主機與基礎 URL 共同將連接器路由至您自己的 C TWO 伺服器（https://{Host}{Base URL}/…），使每位客戶連接到自己的環境——C TWO 雲端或本地部署。

取得認證

認證使用標頭中 Authorization 以持有憑證形式傳送的 API 金鑰。

服務帳號代幣（建議用於生產）

  1. 登入你的 C TWO 實例。
  2. 前往應用程式與連結→ Microsoft Power Automate →建立服務帳號。
  3. 立即複製產生的代幣——它只會顯示一次。

個人存取令牌（開發/測試）

  1. 在 C TWO 開啟你的使用者設定檔。
  2. 到 API Tokens 標籤並產生新的Token。
  3. 立即複製——該帳號只會顯示一次，若使用者帳號被停用則失效。

將兩種權杖類型視為秘密——只存放在 Power Platform 連線憑證中，絕不存在流程變數或用戶端程式碼中。

支援的作業

  • 觸發器 — 當 C TWO 派遣會話時啟動流程，無論是否強制逾時。
  • 會話管理 — 報告完成/失敗、撰寫打字會話日誌、調整會話逾時，並檢查是否有優雅的停止請求。
  • 通用佇列 — 建立、列出、鎖定、解鎖、重試及延後佇列項目;更新項目資料並新增項目層級日誌;新增/移除標籤;取回附件;建立自訂物品狀態;清單佇列。
  • 人工參與流程 — 建立、指派、取消指派及完成結構化的人工協助表單，並檢索/查詢。

內部輔助操作會填充動態下拉選單（任務與使用者選擇器），且不會直接呼叫。

已知問題與限制

  • 必須正確提供主機和基礎網址。 兩者都是在連線時輸入，然後將連接器路由到你的 C TWO 伺服器。 錯誤或無法存取的值會導致連線或請求失敗。
  • API 金鑰格式。 API 鍵欄位期望字串為字串 Bearer <token> ——省 Bearer 略前綴則為 401 Unauthorized。
  • 提供 JSON 項目資料。 項目資料欄位（Create Queue Item， Set Queue Item Data）是 JSON 物件。 在流程中，提供字面上的 JSON 與 json('…') 表達式，使其以物件而非字串形式傳送。
  • 輪詢觸發延遲。 觸發器是輪詢而非推送，因此在 C TWO 中派遣會話到流程開始之間有一個小延遲（受觸發重複次數限制）。
  • 形態類型。 表單操作回傳的一些識別碼欄位可能是整數、字串或空，視表單狀態而定。

常見錯誤和補救措施

錯誤 可能的原因 補救方法
401 Unauthorized API 金鑰缺少前綴、 Bearer 過期或被撤銷 重新輸入憑證為 Bearer <token>;若被撤銷，則產生新的服務帳號令牌
400 Bad request 在建立隊列項目上 缺少必填欄位（reference， queueItemState， itemKey） 填滿所有三個必填欄位
扳機從未觸發 錯誤選取任務，或 C TWO 任務未被 Power Automate 揭露 確認該任務是否出現在任務 ID 下拉選單中，且已設定為 C TWO 中公開的流程
以跳脫字串形式儲存的項目資料 JSON 以文字形式提供，而非物件 使用 json('…') 表達式（flows）或 Raw Body（連接器測試），讓它以物件形式傳送

FAQ

我可以用這個來自 Power Apps、Azure Logic Apps 和 Copilot Studio 的連接器，而不只是 Power Automate 嗎？ Yes. 觸發器是 Power Automate 專用的，但一旦建立連線，所有動作都可以從這些平台中呼叫。

這個連接器會管理授權嗎？ No. C TWO負責執行與執行;客戶需自行管理 Microsoft 授權。

我可以在哪裡取得協助？ 聯絡 C TWO 客戶成功部門。customersuccess@ctwo.com

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有地區 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description Required
C TWO 主機 字串 你的 C TWO 伺服器主機名稱只有——沒有策略，沒有尾部斜線。 例如 connect24.ctwo.cloud，或是帶有可選埠口（如 ctwo.contoso.com:8443）的本地主機。 沒錯
C TWO 基礎網址 字串 你的 C 2 API 的基礎路徑，包括你的師。 從斜線開始，不要後斜斜。 例如 /DEFAULT/CTWO。伺服器/API。 沒錯
API 金鑰 安全字串 您的 C TWO API 代幣，輸入為：持有 <者你的代幣>。 建議使用服務帳戶代幣;個人存取令牌也可使用。 沒錯

動作

依ID取得表格

透過唯一識別碼擷取特定的機器人互動形式。 使用此動作取得由數位工作者建立的人工參與表單的細節、欄位及當前狀態。
取得排隊

根據過濾條件擷取通用佇列。 使用此動作來列出可用佇列、檢查其配置或查詢佇列細節。 此操作同時推動其他動作的動態下拉選單。
取得排隊項目

根據指定的篩選條件（如狀態、標籤、日期及佇列名稱）檢索佇列項目。 使用此動作搜尋並監控你通用佇列中的工作項目。
取得排隊項目附件

從佇列項目中擷取特定檔案附件，作為 base64 編碼資料。 使用此動作下載在建立或處理時附加於工作項目的檔案。
取得表單

檢索機器人互動表單清單，並可選擇過濾。 使用此動作查詢待處理的人機請求、檢查狀態，或尋找分配給特定使用者的表單。
完整表格

標記機器人互動表單為完成，表示人類使用者已提供所需輸入，數位工作者可繼續處理。
將日誌加入佇列項目

在佇列項目中新增日誌訊息，以進行稽核追蹤與追蹤。 使用此動作記錄特定工作項目的處理步驟、警告或錯誤。
將日誌加入會話

會寫入一個 C TWO 會話的日誌條目。 使用此動作追蹤進度、記錄決策，或在流程執行時記錄診斷資訊。 日誌可在 C TWO 平台中檢視與排除故障。
將流程執行狀態設為失敗

標記 C TWO 會話為失敗，表示流程執行過程中發生錯誤。 在錯誤處理範圍內使用此動作，將故障回報給 C TWO，並詳細說明錯誤原因。
將流程執行狀態設為完成

標記 C TWO 會話已完成，表示流程已成功完成其工作。 將此動作放在流程的最後，回報 C TWO 自動化完成且無錯誤。
延後排隊項目

會延後排隊項目，使其直到指定日期/時間才會被處理。 當物品現在無法處理但之後應該重試時，請使用此動作。
建立佇列項目

在指定的通用隊列中建立一個新的工作項目。 使用此動作新增數位工作者處理的項目，包括資料載荷、標籤及可選的檔案附件。
建立佇列項目狀態

在特定佇列中建立新的自訂狀態。 自訂狀態允許你定義工作流程階段，超越預設狀態（待處理、完成、已轉交），並依你的業務流程量身打造佇列。
建立表單

創建一種新的機器人互動表單，讓數位工作者能請求人類協助。 該表單在 C TWO 平台上呈現給指定的使用者，使得需要人類專業知識來處理例外或複雜決策的人工參與情境。
指派形式

指派機器人互動表單給特定使用者，讓他們負責審核並完成人為參與的請求。
會議應該停止嗎

檢查 C TWO 是否已請求對該會話進行優雅（柔和）停止。 在迴圈內使用此動作，定期檢查會話是否應該提前終止，讓流程在停止前清理資源。
未指派形式

移除目前的使用者分配，讓其他使用者可以申請。
為佇列項目新增標籤

在排隊項目中新增一個或多個標籤，以便分類與篩選。 標籤有助於組織和搜尋跨隊列的工作項目。
移除佇列項目中的標籤

移除佇列項目中的一個或多個標籤。 使用此動作更新處理過程中工作項目的分類。
解鎖排隊道具

解鎖先前鎖定的排隊物品，並將其恢復為可用狀態。 當處理中斷時使用此動作，物品應該會釋放給其他工人。
設定佇列項目狀態

變更佇列項目的狀態（例如從待處理改為完成，或改為自訂狀態）。 利用這個動作推進你的工作流程流程。
設定佇列項目資料

更新佇列項目的資料內容。 使用此動作在處理過程中修改工作項目的有效載荷，例如儲存中間結果。
設定會話暫停

更新活躍 C TWO 會話的逾時值。 當原始逾時需要調整時，使用此動作延長或縮短執行中會話的允許執行時間。
重試佇列項目

重試特定佇列項目，將其資料恢復原始值，並建立新的嘗試。
鎖定佇列項目

鎖定佇列項目，防止其他工作者同時處理該項目。 在處理工作項目前使用此動作以確保專屬存取權。

依ID取得表格

作業識別碼：
GetFormById

透過唯一識別碼擷取特定的機器人互動形式。 使用此動作取得由數位工作者建立的人工參與表單的細節、欄位及當前狀態。

參數

名稱 機碼 必要 類型 Description
表單識別碼
 formId True string

Human in the loop 表格 id 以獲取詳細資訊。

傳回

名稱 路徑 類型 Description
id
 id integer

id
分區
 divisionId

分區
sessionID
 sessionId

sessionID
queueItemId
 queueItemId

queueItemId
claimedByUserID
 claimedByUserId

claimedByUserID
claimedOn（宣稱）
 claimedOn string

claimedOn（宣稱）
createdByWorkflowTaskId
 createdByWorkflowTaskId

createdByWorkflowTaskId
createdByUserId
 createdByUserId

createdByUserId
createdOn
 createdOn string

createdOn
截止日期
 deadline string

截止日期
已完成
 completed string

已完成
title
 title string

title
簡介
 intro string

簡介
領域
 fields string

領域

取得排隊

作業識別碼：
GetQueues

根據過濾條件擷取通用佇列。 使用此動作來列出可用佇列、檢查其配置或查詢佇列細節。 此操作同時推動其他動作的動態下拉選單。

參數

名稱 機碼 必要 類型 Description
佇列識別碼
 id string

依佇列 ID 篩選。
佇列參考
 reference string

依佇列參考篩選。
佇列名稱
 name string

依佇列名稱篩選。
州名
 stateName string

依州名稱篩選。
Deleted
 deleted boolean

請依刪除狀態篩選。
跳過
 skip integer

分頁時可以跳過的紀錄數量。
拿
 take integer

要傳回的記錄數目。

傳回

名稱 路徑 類型 Description
array of object
id
 id integer

佇列的唯一標識碼。
已刪除
 deleted boolean

是否刪除了佇列。
名字
 name string

佇列的名稱。
description
 description string

排隊的描述。
看得見的
 visible boolean

隊列是否可見。
includeInReports
 includeInReports boolean

是否要在報告中包含。
創造
 created string

創建時間戳記。
更新
 updated string

最後更新的時間戳記。
刪除時間
 deletedTime string

刪除時間戳記。
分區
 divisionId integer

師識別碼。
型別
 type integer

佇列類型。
參考
 reference string

排隊參考。
國家
 states array of object

此隊列中可用的州份。
id
 states.id integer

州識別碼。
名字
 states.name string

狀態名稱。
description
 states.description string

州政府描述。
標籤過濾器
 states.tagfilter string

這個狀態的標籤過濾器。
狀態
 states.state integer

州政府類型。
時間節省的物品
 states.timeSavedPerItem integer

每件物品節省的時間。
includeInReports
 states.includeInReports boolean

是否要在報告中包含。
回應時間計算基礎
 states.responseTimeCalculationBasis integer

以反應時間計算為基礎。

取得排隊項目

作業識別碼：
GetItems

根據指定的篩選條件（如狀態、標籤、日期及佇列名稱）檢索佇列項目。 使用此動作搜尋並監控你通用佇列中的工作項目。

參數

名稱 機碼 必要 類型 Description
項目說明
 itemKey string

依物品鍵篩選。
Attempts
 attempts integer

依照嘗試次數篩選。
延後之前
 deferredBefore date-time

篩選此日期前延後的項目。
延期
 deferredAfter date-time

篩選項目在此日期之後被延後處理。
建立時間之前
 createdBefore date-time

篩選此日期之前建立的項目。
建立時間
 createdAfter date-time

篩選此日期之後建立的項目。
先前結束
 concludedBefore date-time

篩選項目在此日期前完成。
結束後
 concludedAfter date-time

篩選項目於此日期後結束。
州內進入前
 stateEnteredTimeBefore date-time

篩選在此之前進入狀態的項目。
國家加入後
 stateEnteredTimeAfter date-time

篩選此時間後進入狀態的項目。
States
 states string

依佇列項目狀態篩選。
佇列項目狀態識別碼
 queueItemStateIds integer

依照佇列項目狀態 ID 篩選。
佇列項目狀態名稱
 queueItemStateNames string

依佇列項目狀態名稱篩選。
Tags
 tags string

以標籤篩選（逗號分隔）。
佇列識別碼
 queueIds integer

請依佇列 ID 篩選。
佇列名稱
 queueNames True string

以佇列名稱篩選（必須）。
References
 references string

依佇列參考篩選。
包含項目資料
 includeItemData boolean

是否要在回應中包含項目資料。
跳過
 skip integer

分頁時可以跳過的紀錄數量。
拿
 take integer

要傳回的記錄數目。

傳回

名稱 路徑 類型 Description
array of object
id
 id integer

佇列項目的唯一識別碼。
項目鑰匙
 itemKey string

排隊項目的唯一鍵。
嘗試
 attempts integer

處理次數。
queueId
 queueId integer

父佇列的識別碼。
id
 state.id integer

州識別碼。
名字
 state.name string

狀態的名稱。
狀態
 state.state string

狀態值。
tags
 tags array of string

與佇列項目相關的標籤。
創造
 created string

創建時間戳記。
createdByVendorSessionId
 createdByVendorSessionId integer

就是創建這個項目的會話 ID。
結論
 concluded string

結論時間戳記。
延期
 deferred string

延後的時間戳記。
測試
 test boolean

這是否是一個測試項目。
鎖
 locked boolean

物品是否被鎖定。

取得排隊項目附件

作業識別碼：
GetItemAttachment

從佇列項目中擷取特定檔案附件，作為 base64 編碼資料。 使用此動作下載在建立或處理時附加於工作項目的檔案。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

包含附件的佇列項目的 ID。
附件 ID
 attachmentId True string

要取回附件的 ID。
檔案名稱
 filename string

附件的檔名。

傳回

response
string

取得表單

作業識別碼：
GetForms

檢索機器人互動表單清單，並可選擇過濾。 使用此動作查詢待處理的人機請求、檢查狀態，或尋找分配給特定使用者的表單。

參數

名稱 機碼 必要 類型 Description
跳過
 skip integer

分頁時可以跳過的紀錄數量。
拿
 take integer

要傳回的記錄數目。
截止日期前
 deadlineBefore date-time

篩選表的截止日期早於此日期/時間（ISO 8601）。
截止日期
 deadlineAfter date-time

篩選表單的截止日期（ISO 8601）之後。
包含已完成
 includeCompleted boolean

是否要將填寫好的表格納入結果。
使用者識別號認領
 claimedByUserId integer

篩選表單由特定使用者 ID 領取。
由工作流程建立 任務識別碼
 createdByWorkflowTaskId integer

由特定工作流程任務 ID 建立的篩選表單。

傳回

名稱 路徑 類型 Description
array of object
id
 id integer

id
分區
 divisionId

分區
sessionID
 sessionId

sessionID
queueItemId
 queueItemId

queueItemId
claimedByUserID
 claimedByUserId

claimedByUserID
claimedOn（宣稱）
 claimedOn string

claimedOn（宣稱）
createdByWorkflowTaskId
 createdByWorkflowTaskId

createdByWorkflowTaskId
createdByUserId
 createdByUserId

createdByUserId
createdOn
 createdOn string

createdOn
截止日期
 deadline string

截止日期
已完成
 completed string

已完成
未被推遲
 undeferred boolean

未被推遲

完整表格

作業識別碼：
CompleteForm

標記機器人互動表單為完成，表示人類使用者已提供所需輸入，數位工作者可繼續處理。

參數

名稱 機碼 必要 類型 Description
表單識別碼
 formId True string

循環中的人類表單識別，標記為完成。
完成於
 completedAt date-time

填寫表格的時間戳記（ISO 8601格式）。

將日誌加入佇列項目

作業識別碼：
AddItemLog

在佇列項目中新增日誌訊息，以進行稽核追蹤與追蹤。 使用此動作記錄特定工作項目的處理步驟、警告或錯誤。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

要登入的佇列項目的 ID。
日誌等級
 level string

日誌條目嚴重程度。
Message
 message string

日誌內容。

將日誌加入會話

作業識別碼：
AddLogToSession

會寫入一個 C TWO 會話的日誌條目。 使用此動作追蹤進度、記錄決策，或在流程執行時記錄診斷資訊。 日誌可在 C TWO 平台中檢視與排除故障。

參數

名稱 機碼 必要 類型 Description
會話識別碼
 sessionId True string

C TWO 會話 ID，日誌條目將被記錄。 預設會回到觸發輸出的 session ID。
水平儀
 level True string

日誌條目嚴重程度。
訊息
 message True string

要記錄的日誌訊息內容。

將流程執行狀態設為失敗

作業識別碼：
SetSessionFailed

標記 C TWO 會話為失敗，表示流程執行過程中發生錯誤。 在錯誤處理範圍內使用此動作，將故障回報給 C TWO，並詳細說明錯誤原因。

參數

名稱 機碼 必要 類型 Description
會話識別碼
 sessionId True string

C TWO 會話 ID 標記為失敗。 預設會回到觸發輸出的 session ID。
details
 details True string

描述導致會話失敗的錯誤或異常。

將流程執行狀態設為完成

作業識別碼：
SetSessionCompleted

標記 C TWO 會話已完成，表示流程已成功完成其工作。 將此動作放在流程的最後，回報 C TWO 自動化完成且無錯誤。

參數

名稱 機碼 必要 類型 Description
會話識別碼
 sessionId True string

C TWO 會話 ID 標記為成功完成。 預設會回到觸發輸出的 session ID。

傳回

response
object

延後排隊項目

作業識別碼：
DeferItem

會延後排隊項目，使其直到指定日期/時間才會被處理。 當物品現在無法處理但之後應該重試時，請使用此動作。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

等待項目的 ID。
延後至此
 deferredUntil date-time

延後至（ISO 8601格式）的日期/時間。

傳回

response
string

建立佇列項目

作業識別碼：
CreateItem

在指定的通用隊列中建立一個新的工作項目。 使用此動作新增數位工作者處理的項目，包括資料載荷、標籤及可選的檔案附件。

參數

名稱 機碼 必要 類型 Description
項目說明
 itemKey True string

唯一商業金鑰用以識別此佇列項目（例如發票號碼、案件編號）。
佇列項目狀態
 queueItemState True string

佇列項目的初始狀態（例如，待處理）。
佇列參考
 reference True string

佇列會參考項目將建立的位置。
延後至此
 deferredUntil date-time

處理延後至此日期/時間（ISO 8601格式）。
題目資料
 itemData object

佇列項目的資料有效載荷以 JSON 格式呈現。
Tags
 tags string

排隊項目的標籤（逗號分隔）。
檔案名稱
 fileName string

附件檔的名稱。
檔案資料
 fileData string

base64 編碼的檔案資料。
會話識別碼
 sessionId string

與此項目相關的會話 ID。
裝置
 device string

創造這個物品的裝置。
User
 user string

就是創建這個項目的使用者。
自動化提供者
 automationProvider string

本項目的自動化供應商。

傳回

名稱 路徑 類型 Description
id
 id integer

id
項目鑰匙
 itemKey string

項目鑰匙
嘗試
 attempts integer

嘗試
queueId
 queueId integer

queueId
id
 state.id integer

id
名字
 state.name string

名字
狀態
 state.state string

狀態
tags
 tags array of string

tags
創造
 created string

創造
createdByVendorSessionId
 createdByVendorSessionId integer

createdByVendorSessionId
結論
 concluded string

結論
延期
 deferred string

延期
測試
 test boolean

測試
鎖
 locked boolean

鎖

建立佇列項目狀態

作業識別碼：
CreateItemState

在特定佇列中建立新的自訂狀態。 自訂狀態允許你定義工作流程階段，超越預設狀態（待處理、完成、已轉交），並依你的業務流程量身打造佇列。

參數

名稱 機碼 必要 類型 Description
名稱
 name string

新國家的名稱。
反應時間計算
 responseTimeCalculationBasis True string

決定進入此狀態的項目如何計算回應時間SLA。
狀態類型
 state True string

狀態類型（待處理、完成或轉介）。
佇列識別碼
 queueId True integer

該佇列將建立此狀態的 ID。
Description
 description string

描述這個狀態在你的工作流程中代表什麼。
每件物品節省的時間
 timeSavedPerItem integer

在此狀態下，每件商品節省的時間（秒數），用於投資報酬率報告。
每項產生價值
 valueGeneratedPerItem integer

此狀態下每件商品產生的價值，用於投資報酬率報告。
納入報告
 includeInReports boolean

是否要將此狀態納入分析與報告中。

建立表單

作業識別碼：
CreateForm

創建一種新的機器人互動表單，讓數位工作者能請求人類協助。 該表單在 C TWO 平台上呈現給指定的使用者，使得需要人類專業知識來處理例外或複雜決策的人工參與情境。

參數

名稱 機碼 必要 類型 Description
領域
 fields string

以 JSON 格式的字串定義使用者需要填寫的表單欄位。
title
 title string

當使用者打開表單時，標題會顯示給使用者。
截止日期
 deadline date-time

人員必須在期限內回覆該表格（ISO 8601格式）。
簡介
 intro string

向使用者展示介紹文字，說明所需的行動。
項目識別碼
 itemId integer

與此表單相關的佇列項目 ID，將人工互動與特定工作項目連結起來。
工作流任務ID
 workflowTaskId integer

創造這個形式的C TWO任務。

傳回

名稱 路徑 類型 Description
id
 id integer

id

指派形式

作業識別碼：
AssignForm

指派機器人互動表單給特定使用者，讓他們負責審核並完成人為參與的請求。

參數

名稱 機碼 必要 類型 Description
表單識別碼
 formId True string

在迴圈中用 Human Form 來指派。
使用者ID
 userId integer

指派表單的使用者 ID。

會議應該停止嗎

作業識別碼：
IsStopRequested

檢查 C TWO 是否已請求對該會話進行優雅（柔和）停止。 在迴圈內使用此動作，定期檢查會話是否應該提前終止，讓流程在停止前清理資源。

參數

名稱 機碼 必要 類型 Description
會話識別碼
 sessionId True string

C TWO 會話 ID 用來檢查是否有停止請求。 預設會回到觸發輸出的 session ID。

傳回

名稱 路徑 類型 Description
isStopRequested
 isStopRequested boolean

isStopRequested

未指派形式

作業識別碼：
UnassignForm

移除目前的使用者分配，讓其他使用者可以申請。

參數

名稱 機碼 必要 類型 Description
表單識別碼
 formId True string

在迴圈中 Human Form id 要取消指派。

為佇列項目新增標籤

作業識別碼：
AddItemTag

在排隊項目中新增一個或多個標籤，以便分類與篩選。 標籤有助於組織和搜尋跨隊列的工作項目。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

要加標籤的佇列項目的 ID。
Tags
 tags string

新增標籤清單，並以逗號分隔。

移除佇列項目中的標籤

作業識別碼：
RemoveItemTag

移除佇列項目中的一個或多個標籤。 使用此動作更新處理過程中工作項目的分類。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

要移除標籤的佇列項目的 ID。
Tags
 tags string

逗號分隔的標籤清單。

解鎖排隊道具

作業識別碼：
UnlockItem

解鎖先前鎖定的排隊物品，並將其恢復為可用狀態。 當處理中斷時使用此動作，物品應該會釋放給其他工人。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

要解鎖的排隊項目的 ID。

設定佇列項目狀態

作業識別碼：
SetItemState

變更佇列項目的狀態（例如從待處理改為完成，或改為自訂狀態）。 利用這個動作推進你的工作流程流程。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

要更新的佇列項目的 ID。
狀態
 state string

佇列項目的新狀態。

設定佇列項目資料

作業識別碼：
SetItemData

更新佇列項目的資料內容。 使用此動作在處理過程中修改工作項目的有效載荷，例如儲存中間結果。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True string

要更新的佇列項目的 ID。
數據
 data object

佇列項目的新資料有效載荷，作為 JSON 物件。
已建立
 created date-time

這是這些資料的建立時間戳。

設定會話暫停

作業識別碼：
SetTimeout

更新活躍 C TWO 會話的逾時值。 當原始逾時需要調整時，使用此動作延長或縮短執行中會話的允許執行時間。

參數

名稱 機碼 必要 類型 Description
會話識別碼
 sessionId True string

C TWO 會話 ID 來更新逾時。 預設會回到觸發輸出的 session ID。
逾時
 timeout True integer

新的超時值以秒數計，適用於該工作階段。

傳回

response
string

重試佇列項目

作業識別碼：
RetryItem

重試特定佇列項目，將其資料恢復原始值，並建立新的嘗試。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId True integer

要重試的特定佇列項目 ID。
縣/市 ID
 stateId integer

需設定特定的待處理佇列項目狀態識別碼;優先於狀態參數。
狀態
 state string

要設定特定的待處理佇列項目狀態名稱。
工作流程任務識別碼
 workflowTaskId integer

工作流程任務識別碼。
App ID
 appId integer

應用程式識別碼。

鎖定佇列項目

作業識別碼：
LockItem

鎖定佇列項目，防止其他工作者同時處理該項目。 在處理工作項目前使用此動作以確保專屬存取權。

參數

名稱 機碼 必要 類型 Description
佇列項目識別碼
 queueItemId string

要鎖定的佇列項目的 ID。 若未包含，下一個符合篩選條件的可用項目將被鎖定。
佇列名稱
 reference string

鎖定項目的佇列參考。
縣/市 ID
 stateId string

用 state ID 來篩選項目。
州名
 stateName string

用州名稱來篩選項目。
會話識別碼
 sessionId string

這個鎖的會話編號。

傳回

名稱 路徑 類型 Description
id
 id integer

鎖定項目的唯一識別碼。
項目鑰匙
 itemKey string

那是被鎖物品的唯一鑰匙。
嘗試
 attempts integer

處理次數。
queueId
 queueId integer

父佇列的識別碼。
id
 state.id integer

州識別碼。
名字
 state.name string

狀態的名稱。
狀態
 state.state string

狀態值。
tags
 tags array of string

與佇列項目相關的標籤。
創造
 created string

創建時間戳記。
createdByVendorSessionId
 createdByVendorSessionId integer

就是創建這個項目的會話 ID。
結論
 concluded string

結論時間戳記。
延期
 deferred string

延後的時間戳記。
測試
 test boolean

這是否是一個測試項目。
鎖
 locked boolean

物品是否被鎖定。

觸發程序

從會話請求開始流程且無逾時

輪詢新的 C 個 TWO 會話，並在為所選任務建立會話時觸發流程。 當自動化不需要逾時限制時，請使用此觸發器。 流程會接收會話細節，包括從 C TWO 傳遞的輸入值。
從會話請求開始流程並有逾時

輪詢新的 C TWO 會話，並以逾時限制觸發流程。 當自動化必須在特定時間內完成時，使用此觸發器。 如果該會話超過逾時，C TWO 會依照其逾時政策處理。

從會話請求開始流程且無逾時

作業識別碼：
StartFlowWithoutTimeout

輪詢新的 C 個 TWO 會話，並在為所選任務建立會話時觸發流程。 當自動化不需要逾時限制時，請使用此觸發器。 流程會接收會話細節，包括從 C TWO 傳遞的輸入值。

參數

名稱 機碼 必要 類型 Description
工作標識碼
 taskId True integer

選擇會觸發此流程的 C TWO 任務。 當 C TWO 中為此任務建立新工作階段時，流程將自動啟動，且不會強制逾時。

傳回

名稱 路徑 類型 Description
sessions
 sessions array of object

由 C TWO 觸發且無逾時的會話集合
sessionID
 sessions.sessionId integer

sessionID
工作流任務ID
 sessions.workflowTaskId integer

工作流任務ID
工作流名稱
 sessions.workflowName string

工作流名稱
任務名稱
 sessions.taskName string

任務名稱
創造
 sessions.created string

創造
processInputValues
 sessions.processInputValues object

processInputValues

從會話請求開始流程並有逾時

作業識別碼：
StartFlowWithTimeout

輪詢新的 C TWO 會話，並以逾時限制觸發流程。 當自動化必須在特定時間內完成時，使用此觸發器。 如果該會話超過逾時，C TWO 會依照其逾時政策處理。

參數

名稱 機碼 必要 類型 Description
工作標識碼
 taskId True integer

選擇會觸發此流程的 C TWO 任務。 當為此任務建立會話時，流程會以指定的逾時開始。
秒數暫停
 timeout True integer

該會話在C TWO標記為逾時前，允許執行的最大時間（秒數）。

傳回

名稱 路徑 類型 Description
sessions
 sessions array of object

由 C TWO 觸發並有逾時的會話集合
sessionID
 sessions.sessionId integer

sessionID
工作流任務ID
 sessions.workflowTaskId integer

工作流任務ID
工作流名稱
 sessions.workflowName string

工作流名稱
任務名稱
 sessions.taskName string

任務名稱
創造
 sessions.created string

創造
processInputValues
 sessions.processInputValues object

processInputValues

定義

字串

這是基本資料類型「string」。

物件

這是類型 'object'。