AgentList

This help page is for Desktop Studio.This information is also available for CXone Studio.

在陣列中返回指派給業務單元(除非已將特定客服專員 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 動作和權限才能使用此動作。

相依性

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

支援的指令碼類型

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

通用

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

輸入屬性

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

屬性

描述

Caption

輸入在指令碼中唯一標識此操作的短語。標題出現在指令碼畫布上的動作圖示下。The default is the action name.

SecurityUser SetSecurityUser 動作的輸出值,它根據選定客服專員在安全性設定檔中的權限對其進行身分驗證。此欄位接受使用大括號 ({ }) 格式的變數。預設值為SecurityUser(與SetSecurityUser的預設輸出值相同)。
AgentID 客服專員 ID。您可以為該欄位使用一個變數,如 {agentId}。當空白時,所有與該業務單元相關的使用者將以陣列形式返回。該欄位接受變數。

輸出屬性

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

屬性

描述

ListVar (out) 保留返回的資料。此變數的內容以陣列的形式儲存。 預設變數為 Agents

結果分支條件

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

條件

描述

Default

指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。如果沒有定義動作的其他分支,也會採用該路徑。

OnError

動作未能正確執行時採用的路徑。例如,當出現連接不良、語法錯誤等意外問題時。_ERR變數(帶有一個下畫線字元)應填入針對問題的簡要說明。

其他選項

根據您想要獲取的資料,其他的框架 API 動作可能會有所幫助。例如 All Agent Skill AssignmentsAgent States V4Get Agents ListGet Agent Details by Agent ID 等。