AGENT LIST

返回指派給業務單位 用於管理 CXone Mpower 系統的技術支援、計費和全域設置的高級組織分組。的所有客服專員，除非在包含每個客服專員的個人資料資訊的陣列中。可以通過在 AgentID 屬性中輸入代理 ID 來返回有關特定代理的資訊。 在 ListVar 參數中指定的變數中傳回以下欄位： • BusinessUnitID • UserName • MiddleName • Email • TeamId • ReportToId • ReportToMiddleName • IsSupervisor • LastModified • Custom1 • Custom3 • Custom5 • AgentID • FirstName • LastName • IsActive • TeamName • ReportToFirstName • ReportToLastName • LastLogin • Location • Custom2 • Custom4 • InternalId 您可使用此動作檢查某位客服專員是否在線、尋找該客服專員的電郵地址、檢查其所屬的團隊或各種其他自訂選項。 Agent List 是 Studio 中可用的 API 之一。 您必須對業務單元啟用 Framework 動作和權限才能使用此動作。

相依性

• 務必確保 SetSecurityUser 動作在此動作之前，並且該動作的輸出變數與 Agent List 動作屬性的 SecurityUser 輸入變數相符。

• 這是一個API動作，位於API 動作調色板上。

支援的指令碼類型

通用	電郵	聊天	電話	語音郵件	工作項目	SMS

輸入屬性

這些屬性定義了動作執行時使用的資料。

屬性	描述
Add Caption	輸入在指令碼中唯一標識此操作的短語。 標題出現在指令碼畫布上的動作圖示下。
安全使用者	SetSecurityUser 動作的輸出值，它根據選定客服專員在安全性設定檔中的權限對其進行身分驗證。 此欄位接受帶大括號 （ { } 格式的變數。 預設值為SecurityUser（與SetSecurityUser的預設輸出值相同）。
客服專員 Id	客服專員 ID。 您可以為該欄位使用一個變數，如 {agentId}。 為空時，將以陣列形式返回與 租戶 用於管理 CXone Mpower 系統的技術支援、計費和全域設置的高級組織分組。 關聯的所有使用者。 值模式中： 輸入客服專員 ID 或點擊加號 + 或減號 - 按鈕新增 ID 編號。 在運算式模式中： 輸入客服專員 ID。

輸出屬性

這些屬性包含變數，用於儲存執行動作後返回的資料。 當動作完成後，它們可供參考和使用。

屬性	描述
ListVar	保留返回的資料。 此變數的內容以陣列的形式儲存。 預設值為 Agents，但可以根據需要修改為任何值。

結果分支條件

結果分支條件允許您在指令碼中建立分支，以處理執行動作時的不同結果。

條件	描述
Default	指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。 如果沒有定義動作的其他分支，也會採用該路徑。
成功	動作完成且無錯誤而且任何 API 調用或資料返回均成功時採用的路徑（2xx 回應代碼）。
InvalidAgentId	如果「客服專員 ID」無效時，採用的路徑。
InvalidSecurityUser	使用無效的安全使用者時採用的路徑。

其他選項

根據您要獲取的資料，其他 API 動作 可能會有所幫助。 例如，All Agent Skill Assignments、Agent States V4、Get Agents List、Get Agent Details by Agent ID 等等。