AgentList

ListVar 매개변수에 지정된 변수로 반환된 다음 필드와 함께, 각 상담원의 프로필 정보가 포함된 배열로 사업부에 할당된 모든 상담원(특정 에이전트 ID가 속성에 입력되지 않은 경우)을 반환합니다. • 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 action이 이 작업보다 먼저 실행되고, 해당 작업의 출력 변수가 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 등입니다.