AGENT LIST

이 도움말 페이지는 Studio을(를) 대상으로 합니다. 이 정보는 Desktop Studio에 대해서도 사용할 수 있습니다.

GET이 들어있는 캡슐 모양의 아이콘입니다.

각 에이전트의 프로필 정보가 포함된 배열에 없는 한, 사업부 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

이 작업을 사용하여 특정 상담원이 활성 상태인지 확인하거나, 상담원의 이메일 주소를 찾거나, 상담원이 속한 팀을 확인하거나, 기타 다양한 사용자 정의 옵션을 사용할 수 있습니다. 상담원 목록은 Studio 내에서 사용할 수 있는 API 중 하나입니다. 이 작업을 활용하려면 사업부에서 프레임워크 작업 및 권한을 활성화해야 합니다.

종속성

반드시 SetSecurityUser 작업이 이 작업보다 먼저 실행되고, 해당 작업의 출력 변수가 Agent List 작업 변수의 SecurityUser 입력 변수와 일치해야 합니다.
이는 API 작업 팔레트에 있는 API 작업입니다.

지원되는 스크립트 유형


일반	이메일	채팅	전화	음성 메일	워크 아이템	SMS

입력 속성

이러한 속성은 실행할 때 작업이 사용하는 데이터를 정의합니다.

속성	설명
Add Caption	스크립트에서 이 작업을 고유하게 식별하는 짧은 문구를 입력합니다. 캡션은 스크립트 캔버스의 작업 아이콘 아래에 표시됩니다.
보안 사용자	보안 프로필의 권한에 따라 선택된 상담원을 인증하는 SetSecurityUser 작업의 출력 값입니다. 이 필드는 중괄호({ })로 포맷된 변수를 허용합니다. 기본값은 SecurityUser(SetSecurityUser의 기본 출력 값과 동일함)입니다.
상담원 ID	상담원 ID입니다. 이 필드에 {agentId} 등의 변수를 사용할 수 있습니다. 비어 있을 때 테넌트 CXone Mpower 시스템의 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용되는 상위 조직 그룹입니다.과(와) 연결된 모든 사용자가 배열로 반환됩니다. 값 모드: 상담원 ID를 입력하거나 더하기(+) 또는 빼기(-) 버튼을 눌러 ID 번호를 추가합니다. 표현식 모드: 상담원 ID를 입력합니다.

속성

설명

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 등입니다.