AgentList

在陣列中返回指派給業務單元（除非已將特定客服專員 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 輸入變數相符。

支援的指令碼類型

通用	電郵	聊天	電話	語音郵件	工作項目	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 Assignments、Agent States V4、Get Agents List、Get Agent Details by Agent ID 等。