데이터 추출 API

데이터 추출 API를 통해 외부 보고 목적으로 CXone(으)로부터 데이터를 추출할 수 있습니다. 예를 들어 CXone QM 작업 흐름 데이터, CXone QM 질문 및 답변 데이터, CXone Recording 상호작용 메타데이터, 또는 CXone WFM 급여 데이터를 추출할 수 있습니다. 데이터는 지정된 날짜 범위에 따라서만 필터링할 수 있습니다.

데이터 추출 API는 DEVone Developer Community 포털에서 제공됩니다.

도메인과 URL에 대한 자세한 정보는 DEVone Developer Community 포털의 시작하기를 참조하십시오.

POST 메서드로 엔드포인트 /jobs를 호출할 때 데이터가 준비되는 동안 jobId가 반환됩니다, 데이터가 준비되었는지는 엔드포인트 /jobs/{jobId}로부터의 서비스 폴링을 통해 확인할 수 있습니다. 작업의 상태가 반환됩니다. 상태가 성공이라면 추가 URL 또한 반환됩니다. URL에는 30초 동안 액세스할 수 있습니다(파일 다운로드에 걸린 시간 제외).

매번 데이터를 수동으로 가져오는 대신 API를 주기적으로 호출하기 위해 스크립트를 작성할 수 있습니다. 정해진 시간에 테넌트당 한 명의 사용자만이 API를 호출할 수 있습니다. API는 30초에 한 번만 호출할 수 있습니다.

시작하기 전

비즈니스 데이터 API를 사용하여 시작하려면 사용자 권한을 설정하고, 액세스 키를 생성하고, 개발자 포털에서 설명하는 등록 및 인증 프로세스를 따르십시오. 필수 권한:

엔터티:
- 상호작용 메타데이터를 추출하는 경우 검색 및 재생 > API > 상호작용 메타데이터 추출 권한이 필요합니다.
- CXone QM 작업 흐름 데이터를 추출하려면 QM 도구 > 데이터 추출 API > QM 작업 흐름 API 권한이 필요합니다.
- CXone QM Q&A 데이터를 추출하려면 QM 도구 > 데이터 추출 API > QM 작업 흐름 API 권한이 필요합니다.
- CXone WFM급여 데이터를 추출하려면 CXone WFM > 데이터 추출 API > CXone WFM급여 API 권한이 필요합니다.

가져오기 작업

테넌트당 모든 작업 상태의 목록을 봅니다. 가능한 상태는 실행 중, 성공, 실패, 취소 및 만료입니다.

POST 작업

데이터 추출 요청이 전달된 후 데이터를 수집하고 추출을 위해 준비합니다. 데이터는 S3에서 CSV 파일로 24시간 동안 제공됩니다. 완료 시 작업 ID가 반환됩니다.

예시 값 및 응답

요청 본문*:	application/json
exportRequest { 설명:	데이터를 추출하기 위해 제공되어야 하는 매개변수입니다.
entityName	문자열 추출할 엔터티의 이름입니다. 올바른 엔터티 이름을 위해서는 아래를 참조하십시오.
version	문자열 추출할 엔터티의 버전입니다. 각 엔터티의 올바른 버전을 위해서는 아래를 참조하십시오.
startDate	string ($date) 데이터 추출을 시작할 UTC로 표시되는 날짜입니다. 날짜 형식은 <YYYY-MM-DD>입니다. 예를 들어 2019년 5월 22일부터 데이터를 추출하려면 2019-05-22를 날짜로 입력합니다.
endDate	string ($date) 데이터 추출을 중지하는 UTC로 표시되는 날짜입니다. 날짜 형식은 <YYYY-MM-DD>입니다. 예를 들어 2019년 5월 29일까지 데이터를 추출하려면 2019-05-29를 날짜로 입력합니다.
}

예시 값

{ "entityName": "qm-workflows", "version": "3", "startDate": "2019-05-22", "endDate": "2019-05-29" }

응답

202 상태 - 성공. 성공적으로 내보낸 비동기 작업입니다.

문자열

예: 12345d5h-c099-9303-j99j-w3ko9ppp1234
400 상태 - 잘못된 요청. 잘못된 데이터 필터 등입니다.
401 상태 - 비인가. 잘못된 자격 증명.
403 상태 - 금지. 사용자에게 작업 상태를 열람할 권한이 없습니다.
404 상태 - 찾을 수 없음. 없는 엔터티거나 잘못된 버전입니다.
500 상태 - 내부 서버 오류.

작업 ID로 작업 가져오기

작업 ID당 특정 작업의 상태를 봅니다. 작업이 성공적이라면 추출된 데이터에 액세스할 수 있는 URL이 반환되며 30초 동안 액세스할 수 있습니다(파일 다운로드에 걸린 시간 제외). 작업에 실패한다면 오류 메시지가 반환됩니다. 링크를 사용하여 추출된 데이터에 액세스할 수 있습니다. 가능한 작업 상태는 실행 중, 성공, 실패, 취소 및 만료입니다.

예시 값 및 응답

jobId *:

문자열

고객 데이터를 추출하기 위한 요청의 고유 식별자입니다.

예시 값

 12345d5h-r3ds-9303-0pw3-w3ko9ppp1234

응답

202 상태 - 성공. 작업 상태를 가져왔습니다.

 jobResponse{ description: Displays the job status jobStatus: { description: Job Status, includes job ID and job status id:	string Unique identifier of the job. status: string example: SUCCEEDED Job status that can be returned. Enum: [ RUNNING, SUCCEEDED, FAILED, CANCELLED, EXPIRED ] result: { description:	Job result. If successful, contains the url, if failed, an error message is displayed. url: string example: https://s3.example.amazonaws.com/results-bucket/data-extraction/{details} A url to access the extracted data is returned when a job for extracting data is successful. errorMessage: string Error message displayed when a request for extracting data fails. } } }

400 상태 - 잘못된 요청. 잘못된 데이터 필터 등입니다.
401 상태 - 비인가. 잘못된 자격 증명.
403 상태 - 금지. 사용자에게 작업 상태를 열람할 권한이 없습니다.
404 상태 - 찾을 수 없음. 없는 엔터티거나 잘못된 버전입니다.
500 상태 - 내부 서버 오류.

CXone QM 작업 흐름 엔터티 및 CSV 파일

CXone QM 작업 흐름 API로 평가, 자체 평가, 교정 등의 CXone QM 작업 흐름 데이터를 추출할 수 있습니다.

POST 작업의 경우:

entityName : qm-workflows
버전 : 4

데이터는 제출 날짜(UTC)에 따라 필터링됩니다.

CXone QM 작업 흐름 CSV 파일에 있는 필드

열 이름	설명
테넌트 이름	테넌트 이름입니다.
상담원 ID	상담원의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
유형	평가 유형. 예: 평가 자기 평가 필드 유형: 최대 24자의 문자열(VARCHAR)
평가 흐름 트리거	평가를 시작한 이벤트: 교정 협업 수동 QP 필드 유형: 최대 24자의 문자열(VARCHAR)
작업 흐름 상태	작업 흐름 상태: 상담원에게 전송됨 검토 중 이의제기 완료 확인 자체 평가 완료 완료됨 검토됨 완료됨 검토 없음 완료됨 삭제 삭제됨 - 완료됨 만료 삭제됨 - 만료됨 삭제됨 - 완료됨 확인됨 삭제됨 - 완료됨 검토됨 삭제됨 - 완료됨 검토 없음 필드 유형: 최대 128자의 문자열(VARCHAR)
자동 승인됨	가능한 값: TRUE: 상담원이 평가를 확인하지 않았을 경우 자동으로 확인됩니다. FALSE: 상담원이 평가를 확인한 경우입니다. 빈 값: 자체 평가의 경우 확인이 필요하지 않습니다. 필드 유형: 부울
작업 흐름 상태	작업 흐름 상태: 열기 휴무 시간 초과 필드 유형: 최대 128자의 문자열(VARCHAR)
작업 흐름 ID	평가의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR) API 버전: 3 이상
계획 이름	이 평가를 시작하는 데 사용된 품질 계획서의 이름입니다. 필드 유형: 최대 128자의 문자열(VARCHAR)
양식 이름	이 평가에 사용된 양식의 이름입니다. 필드 유형: 최대 256자의 문자열(VARCHAR)
양식 버전	이 평가에 사용된 평가 양식의 버전입니다. 필드 유형: 숫자(4,0)
시작 날짜	이 평가를 시작한 날짜 및 시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(3)
제출 날짜	이 평가가 제출된 날짜 및 시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(3)
최근 업데이트	이 평가가 마지막으로 수정된 타임스탬프(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(3)
점수 – 백분율	백분율로 표시된 평가 점수입니다. 필드 유형: FLOAT
점수	평가 점수. 필드 유형: FLOAT
가능한 최고 점수	평가 양식의 각 질문에서 가능한 가장 높은 점수입니다. 필드 유형: FLOAT
순위	양식 순위를 정의하기 위해 사용자가 설정한 사용자 정의 값 범위 세트입니다. 필드 유형: 최대 256자의 문자열(VARCHAR)
실패한 주요 질문	값이 참이라면 사용자는 주요 질문에 실패했으며 평가 양식 점수는 0으로 설정됩니다. 값이 거짓이라면 사용자가 질문에 올바르게 답했습니다. 필드 유형: 부울
사용자 검토 주석	평가에 이의를 제기했을 때 사용자(상담원)가 입력한 주석입니다. 필드 유형: 최대 256자의 문자열(VARCHAR)
분쟁 해결자 주석	분쟁을 종료할 때 사용자(관리자/평가자)가 입력한 주석입니다. 필드 유형: 최대 256자의 문자열(VARCHAR)
세그먼트 ID	평가되는 상호작용의 세그먼트 ID입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
ACD ID	자동 통화 분배기의 고유 식별자입니다. 필드 유형: 숫자(38,0)
상호작용 형식	상호작용 형식: PHONE_CALL 이메일 채팅 SMS WORKITEM GOOGLE_BUSINESS_MESSAGES_PRIVATE APPLE_BUSINESS_CHAT_PRIVATE TELEGRAM_PRIVATE LINE_PRIVATE WHATSAPP_PRIVATE SLACK_PRIVATE MICROSOFT_TEAMS_PRIVATE TW_PRIVATE VIBER_PRIVATE CUSTOM_PRIVATE WE_CHAT_PRIVATE FB_PRIVATE 필드 유형: 최대 50자의 문자열(VARCHAR)
상호작용 시작 날짜	상호작용의 시작 날짜-시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(6)
상호작용 종료 날짜	상호작용의 종료 날짜-시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(6)
상호작용 방향	통화 방향: 인바운드 아웃바운드 필드 유형: 최대 50자의 문자열(VARCHAR)
팀 ID	상담원 팀의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
팀 이름:	상담원의 팀 이름입니다. 필드 유형: 최대 50자의 문자열(VARCHAR)
전화번호	고객의 전화번호입니다. 필드 유형: 최대 200자의 문자열(VARCHAR)
FirstName (Eva)	평가자의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
LastName (Eva)	평가자의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
FirstName (Agent)	평가된 상담원의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
LastName (Agent)	평가된 상담원의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
FirstName (Disp)	분쟁 해결자의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
LastName (Disp)	분쟁 해결자의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
FirstName (Assigner)	평가를 할당한 사용자의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
LastName (Assigner)	평가를 할당한 사용자의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
이유	평가의 삭제 이유입니다. 필드 유형: 최대 128자의 문자열(VARCHAR) API 버전: 4 이상
상위 ID	공동 평가 및 교정 등, 평가의 상위 작업 흐름 ID입니다. 필드 유형: 최대 36자의 문자열(VARCHAR) API 버전: 4 이상
평가 주제	가능한 값: 직원 세그먼트 필드 유형: 최대 128자의 문자열(VARCHAR) API 버전: 4 이상

CXone QM 질문 및 답변(Q&A) 엔터티 및 CSV 파일

CXone QM Q&A API로 CXone QM 평가, 자체 평가 및 교정으로부터 질문 및 답변을 추출할 수 있습니다.

POST 작업의 경우:

entityName : qm-questions
버전 : 2

데이터는 제출 날짜(UTC)에 따라 필터링됩니다.

CXone QM Q&A CSV 파일에 있는 필드

열 이름	설명
질문ID	질문의 고유 식별자입니다. 필드 유형: 숫자(38,0)
질문 제목	질문의 텍스트입니다. 필드 유형: 최대 2048자의 문자열(VARCHAR)
질문 번호	평가 양식의 질문 번호입니다. 필드 유형: 최대 15자의 문자열(VARCHAR)
답변	질문에 대한 평가자의 답변입니다. 필드 유형: 최대 10000자의 문자열(VARCHAR)
옵션	질문에서 사용 가능한 옵션은 예/아니오, 숫자 옵션, 라디오 버튼 옵션 등을 포함합니다. 필드 유형: ARRAY
양식 ID	평가 양식의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
양식 이름	이 평가에 사용된 양식의 이름입니다. 필드 유형: 최대 256자의 문자열(VARCHAR)
양식 버전	이 평가에 사용된 평가 양식의 버전입니다. 필드 유형: 숫자(4,0)
평가 시작 날짜	이 평가를 시작한 날짜 및 시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(3)
평가 제출 날짜	이 평가가 제출된 날짜 및 시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(3)
작업 흐름 형식	평가 유형. 예: 평가 자기 평가 필드 유형: 최대 24자의 문자열(VARCHAR)
섹션 ID	평가 양식에 있는 섹션의 고유 식별자입니다. 필드 유형: 숫자(38,0)
섹션 제목	평가 양식에 있는 섹션의 이름입니다. 필드 유형: 최대 2048자의 문자열(VARCHAR)
채점 가능	질문을 채점할 수 있다면 보이는 참 또는 거짓 플래그입니다. 필드 유형: 부울
실제 점수	상담원이 질문에 대해 받은 점수입니다. 필드 유형: FLOAT
섹션 점수(%)	질문이 위치한 섹션의 백분율 점수입니다. 필드 유형: FLOAT
최고 점수	상담원이 질문에 대해 받은 최고 점수입니다. 필드 유형: FLOAT
상담원 ID	상담원의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
FirstName (Agent)	평가된 상담원의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
LastName (Agent)	평가된 상담원의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
팀 ID	상담원 팀의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
팀 이름:	상담원의 팀 이름입니다. 필드 유형: 최대 50자의 문자열(VARCHAR)
FirstName (Eva)	평가자의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
LastName (Eva)	평가자의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
중요함	질문이 주요 질문이라면 보이는 참 또는 거짓 플래그입니다. 필드 유형: 부울
실패한 주요 질문	값이 참이라면 사용자는 주요 질문에 실패했으며 평가 양식 점수는 0으로 설정됩니다. 값이 거짓이라면 사용자가 질문에 올바르게 답했습니다. 필드 유형: 부울
필수	질문이 필수라면 보이는 참 또는 거짓 플래그입니다. 필드 유형: 부울
질문 형식	질문 유형: 라디오 예/아니요 확인란 드롭다운 날짜/시간 필드 유형: 최대 64자의 문자열(VARCHAR)
세그먼트 ID	평가되는 상호작용의 세그먼트 ID입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
상호작용 시작 날짜	상호작용의 시작 날짜-시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(6)
상호작용 종료 날짜	상호작용의 종료 날짜-시간(UTC)입니다. 필드 유형: TIMESTAMP_LTZ(6)
WorkflowInstance ID	평가의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
평가 점수(%)	평가의 백분율 점수입니다. 필드 유형: FLOAT
은행 ID	질문이 위치한 질문 은행의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
숨겨진 이름	True 플래그는 질문을 숨기고 False 플래그는 질문을 드러냅니다. 품질 양식에서 QM 양식 규칙을 사용하면 이전 질문의 점수에 따라 후속 질문이 숨겨집니다. 필드 유형: 부울 API 버전: 2 이상

CXone QM 평가자 참고 및 CSV 파일

CXone QM 평가자 참고 API로 CXone QM 평가자 참고를 추출할 수 있습니다.

POST 작업의 경우:

entityName : qm-evaluation-comment-entity
버전 : 1

데이터는 제출 날짜(UTC)에 따라 필터링됩니다.

CXone QM 평가자 참고 CSV 파일의 필드

열 이름	설명
메모 ID	메모의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
메모	메모의 텍스트입니다. 필드 유형: 최대 300자의 문자열(VARCHAR)
메모 시간	메모가 추가된 날짜 및 시간입니다. 필드 유형: TIMESTAMP_LTZ(3)
활동	메모가 추가되었을 때의 평가 작업 이름입니다. 필드 유형: 최대 50자의 문자열(VARCHAR)
메모 작성자 ID	메모를 추가한 사용자의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
메모 작성자 FirstName	메모를 추가한 사용자의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
메모 작성자 LastName	메모를 추가한 사용자의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
질문ID	질문의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
질문 제목	질문의 텍스트입니다. 필드 유형: 최대 2048자의 문자열(VARCHAR)
양식 ID	평가 양식의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
양식 이름	평가에 사용된 양식의 이름입니다. 필드 유형: 최대 256자의 문자열(VARCHAR)
양식 버전	평가에 사용된 평가 양식의 버전입니다. 필드 유형: 숫자(4,0)
작업 흐름 ID	평가의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
작업 흐름 상태	작업 흐름의 상태입니다. 필드 유형: 최대 128자의 문자열(VARCHAR)
상담원 ID	상담원의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
FirstName (Agent)	상담원의 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
LastName (Agent)	상담원의 성입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
팀 ID	상담원 팀의 고유 식별자입니다. 필드 유형: 최대 36자의 문자열(VARCHAR)
팀 이름:	상담원의 팀 이름입니다. 필드 유형: 최대 50자의 문자열(VARCHAR)

상호작용 메타데이터 엔터티 및 CSV 파일

상호작용 메타데이터 API로 CXone Recording 상호작용 메타데이터를 추출할 수 있습니다.

POST 작업의 경우:

entityName : recording-interaction-metadata
버전 : 7
날짜 및 시간별로 데이터를 필터링하려면 yyyy-mm-dd hh:mm:ss 형식의 UTC 기준 startDate 및 endDate 를 사용합니다.

상호작용 메타데이터 CSV 파일에 있는 필드

열 이름	설명
ACD 통화 ID(예: 마스터 컨택 ID)	ACD 통화 ID는 ACD 솔루션에 따라 다릅니다. 예를 들어 이는 CXone 마스터 컨택 ID 관련된 하나 이상의 컨택에 대한 마스터 또는 상위 ID입니다. 새 마스터 컨택 ID는 컨택이 3회 이상 전환되었을 때 배정됩니다.와 동일합니다. 필드 유형: 최대 38자리를 포함하는 숫자
세그먼트 ID	세그먼트의 고유 식별자입니다. 세그먼트는 고객 및 상담원과 같은 두 명의 참가자를 포함한 상호작용입니다. 필드 유형: 최대 36자의 문자열(VARCHAR UUID)
세그먼트 시작 이유	세그먼트 시작 이유: 다자간 통화 IVR 세그먼트: 컨택의 첫 세그먼트 전환 컨택 승격됨 외부 번호로 전환 완료 외부 전환 필드 유형: 최대 100자의 문자열(VARCHAR)
세그먼트 종료 이유	세그먼트 종료 이유: 다자간 통화 IVR 세그먼트: 컨택의 마지막 세그먼트 전환 컨택 승격됨 외부 번호로 전환 완료 외부 전환 필드 유형: 최대 100자의 문자열(VARCHAR)
방향	세그먼트 방향: 인바운드 아웃바운드 내부 알 수 없음 필드 유형: 최대 150자의 문자열(VARCHAR)
시작 날짜	세그먼트의 시작 날짜 및 시간(UTC)입니다. 필드 유형: TIMESTAMP
종료 날짜	세그먼트의 종료 날짜 및 시간(UTC)입니다. 필드 유형: TIMESTAMP
채널 유형	상호작용 형식: 음성 채팅 이메일 IVR 워크 아이템 SMS 메시지 채널: Facebook Messenger, Twitter Direct Messages, WhatsApp, Apple Messages for Business (Apple Business Chat), LINE Messaging, Telegram Messenger, Viber Messenger, Custom, Google Business Messenger, Microsoft Teams, Slack. 공개 소셜 채널: Facebook, Google Places, Google Play, LinkedIn, Twitter, YouTube, Apple Apps Reviews, 사용자 정의(공개). 필드 유형: 최대 150자의 문자열(VARCHAR)
화면 녹화	세그먼트가 화면 녹화를 포함할 경우: 예 아니요
음성 녹음 상태	녹음 상태: 성공 부분 녹음: 이 세그먼트의 일부가 녹음되지 않았지만 여전히 상호작용을 재생할 수 있습니다 모든 정책과 불일치: 녹음 없음 — 어떠한 녹음 정책도 이 상호작용에 의해 촉발되지 않았습니다 녹음 비율로 인해 녹음되지 않음: 녹음 없음 — 녹음 정책이 이 상호작용에 의해 촉발되었지만 정책에서 정의한 녹음 비율에 의해 녹음되지 않았습니다 녹음 금지 정책: 녹음 없음 — 녹음 금지 정책이 이 상호작용에 의해 촉발되었습니다 IVR에서 동의 거부: 녹음 없음 실패: 녹음 없음 마스킹됨: 녹음 없음 — 녹음이 마스킹되었습니다. 선택되지 않은 외부 번호로 녹음 전송: 녹음 없음 녹음 가능(음성) 선택 안 됨: 녹음 없음 — 상담원 속성 녹음 가능(음성)이 선택되지 않았습니다. 필드 유형: 최대 250자의 문자열(VARCHAR)
화면 녹화 상태	녹음 상태: 성공 부분 녹음: 이 세그먼트의 일부가 녹음되지 않았지만 여전히 상호작용을 재생할 수 있습니다 모든 정책과 불일치: 녹음 없음 — 어떠한 녹음 정책도 이 상호작용에 의해 촉발되지 않았습니다 녹음 비율로 인해 녹음되지 않음: 녹음 없음 — 녹음 정책이 이 상호작용에 의해 촉발되었지만 정책에서 정의한 녹음 비율에 의해 녹음되지 않았습니다 녹음 금지 정책: 녹음 없음 — 녹음 금지 정책이 이 상호작용에 의해 촉발되었습니다 IVR에서 동의 거부: 녹음 없음 실패: 녹음 없음 마스킹됨: 녹음 없음 — 녹음이 마스킹되었습니다. 필드 유형: 최대 250자의 문자열(VARCHAR)
레코딩 주의	녹음 알림 포함 사항: ScreenAgent 오류: 여러 가지 이유가 있습니다. 예를 들면 상담원이 ScreenAgent NICE ScreenAgent는 화면 녹화가 필요한 상담원 데스크톱에서 운영하는 서비스입니다.을(를) 설치하지 않았거나 ScreenAgent에 오류가 있는 경우가 있습니다. ScreenAgent 문제 해결을(를) 참조하십시오. 미디어 서버에 연결되지 않음: 녹화되지 않습니다. 미디어 서버에 문제가 있습니다. 여러 가지 이유가 있을 수 있습니다. 녹음 경보의 오류 설명은 보다 자세한 정보를 제공합니다. 음성 녹음기가 통화를 녹음할 수 없음: 녹음되지 않습니다. 음성 녹음기에 문제가 있습니다. 여러 가지 이유가 있을 수 있습니다. 녹음 경보의 오류 설명은 보다 자세한 정보를 제공합니다. 오디오 사용 불가: 불완전한 오디오 데이터: 이 상호 작용에 오디오를 사용할 수 없습니다(불완전한 오디오 데이터). 컨택 NICE CXone 지원. 오디오 사용 불가: 오디오 패킷 누락: 이 상호 작용에 오디오를 사용할 수 없습니다(오디오 패킷 누락). 컨택 NICE CXone 지원. 오디오　이용불가: 외부 소스에서 오디오 패킷 누락：　(CR 기능) 이 인터랙션에 오디오를　사용할　수　없습니다(미디어 스트림에서 오디오 패킷 누락). 컨택 NICE CXone 지원. 시스템 오류: 녹음이 시작되지 않았거나 다른 일반 오류가 발생했습니다. 컨택 NICE CXone 지원. 통화가 너무 짧음: 통화가 4초 미만이므로 녹음할 수 없습니다. 마스킹 실패: 녹음을 마스킹하지 못했습니다. 녹음을 재생하여 민감한 데이터가 있는지 확인할 수 있습니다. 녹음을 삭제하려면 작업을 클릭하고 녹음 삭제를 선택합니다. 요청 시 녹음 중지: 사용자에 의해 녹음이 중지되었습니다.
정책 이름	이 상호작용에 적용된 녹음 정책 또는 녹음 금지 정책의 이름입니다. 필드 유형: 최대 100자의 문자열(VARCHAR)
ANI	수신 전화의 경우 ANI가 발신자(발신자 ID)의 전화번호입니다. 필드 유형: 최대 200자의 문자열(VARCHAR)
DNIS	수신 전화의 경우 DNIS가 전화를 건 전화번호(숫자)입니다. 필드 유형: 최대 200자의 문자열(VARCHAR)
ACW(초)	통화가 종료된 후 상담원의 통화 후속 작업을 포착하기 위해 화면 녹화가 지속된 시간(초)입니다.
처분	통화에 대한 추가 정보와 함께 상담원이 할당하는 태그입니다.
상담원 사용자 ID	상담원에게 할당된 고유 식별자입니다. CSV 파일에는 최대 5명의 상담원에 대한 상담원 관련 정보가 포함되어 있습니다. 예: 상담원1 사용자 ID, 상담원2 사용자 ID, 상담원3 사용자 ID, 상담원4 사용자 ID, 상담원5 사용자 ID. 필드 유형: 최대 36자의 문자열(VARCHAR)
상담원 ACD ID	ACD를 통해 상담원에게 할당된 고유 식별자입니다. CSV 파일에는 최대 5명의 상담원에 대한 상담원 관련 정보가 포함되어 있습니다. 예: 상담원1 ACD ID, 상담원2 ACD ID, 상담원3 ACD ID, 상담원4 ACD ID, 상담원5 ACD ID. 필드 유형: 최대 50자의 문자열(VARCHAR)
상담원 컨택 번호	이 상담원에 대해 생성된 컨택의 고유 식별자입니다. CSV 파일에는 최대 5명의 상담원에 대한 상담원 관련 정보가 포함되어 있습니다. 예: 상담원1 컨택 번호, 상담원2 컨택 번호, 상담원3 컨택 번호, 상담원4 컨택 번호, 상담원5 컨택 번호. 이 필드는 CXone Multi-ACD에 사용할 수 없습니다. 필드 유형: 최대 38자리를 포함하는 숫자 API 버전: 5 이상
상담원 이름	CXone 직원 계정에서 지정된 상담원의 이름입니다. CSV 파일에는 최대 5명의 상담원에 대한 상담원 관련 정보가 포함되어 있습니다. 예: 상담원1 이름, 상담원2 이름, 상담원3 이름, 상담원4 이름, 상담원5 이름. 필드 유형: 최대 100자의 문자열(VARCHAR)
상담원 팀 ID	상담원의 팀에 할당된 고유 식별자입니다. CSV 파일에는 최대 5명의 상담원에 대한 상담원 관련 정보가 포함되어 있습니다. 예: 상담원1 팀 ID, 상담원2 팀 ID, 상담원3 팀 ID, 상담원4 팀 ID, 상담원5 팀 ID. 필드 유형: 최대 36자의 문자열(VARCHAR UUID)
상담원 팀	상담원의 팀 이름입니다. CSV 파일에는 최대 5명의 상담원에 대한 상담원 관련 정보가 포함되어 있습니다. 예: 상담원1 팀, 상담원2 팀, 상담원3 팀, 상담원4 팀, 상담원5 팀. 필드 유형: 최대 40자의 문자열(VARCHAR)
에이전트 스킬	능력, 전공 및 지식에 따라 ACD에서 상담원에게 할당된 분류입니다. CSV 파일에는 최대 5명의 상담원에 대한 상담원 관련 정보가 포함되어 있습니다. 예: 상담원1 스킬, 상담원2 스킬, 상담원3 스킬, 상담원4 스킬, 상담원5 스킬. 필드 유형: 최대 50자의 문자열(VARCHAR)
관련 컨택 번호 목록	세그먼트와 관련된 상담원의 컨택 번호 목록입니다. 이 목록의 요소는 숫자 유형으로만 구성됩니다. 필드 유형: Variant API 버전: 7 이상
상호작용 ID	상호작용의 고유 ID(UUID)입니다. 단일 상호작용과 연결된 세그먼트가 여러 개 있는 경우 세그먼트는 동일한 상호작용 ID를 가질 수 있습니다. 상호작용 ID는 세그먼트 ID 또는 컨택 ID와 동일하지 않습니다. 필드 유형: 최대 36자의 문자열(VARCHAR) API 버전: 7 이상
비즈니스 데이터 이름	지정한 비즈니스 데이터 필드의 이름. 필드 유형: 최대 128자의 문자열(VARCHAR) API 버전: 7 이상
비즈니스 데이터 값	비즈니스 데이터 값은 텍스트, 숫자 또는 참/거짓일 수 있습니다. 비즈니스 데이터는 최대 50개의 필드로 구성될 수 있으며, 그 중 35개는 가변 문자, 10개는 숫자, 5개는 부울입니다. 필드 유형: 최대 4000자의 문자열(VARCHAR) 최대 38자리의 숫자 값(NUMBER) TRUE 또는 FALSE로 구성된 부울 값(BOOLEAN) API 버전: 7 이상
소스	녹음 소스이며, CXone 또는 외부 소스입니다. 값에는 다음이 포함됩니다. 참여 BrandEmbassy Uptivity InContactACD 다중 ACD MigratedCallsExternal MigratedCallsEngage MigratedCallsNim 필드 유형: 최대 30자의 문자열(VARCHAR) API 버전: 6 이상
외부 컨택 ID	녹음의 외부 소스에 정의된 컨택의 ID입니다. 값은 CXone AppLink이(가) 있는 사용자만 사용할 수 있습니다. 필드 유형: 최대 100자의 문자열(VARCHAR) API 버전: 6 이상
외부 세그먼트 ID	녹음의 외부 소스에 정의된 세그먼트의 ID입니다. 값은 CXone AppLink이(가) 있는 사용자만 사용할 수 있습니다. 필드 유형: 최대 100자의 문자열(VARCHAR) API 버전: 6 이상

CXone WFM 급여 엔터티 및 CSV 파일

CXone WFM 급여 API(버전 1)를 통해 외부 급여 보고 목적을 위해 CXone WFM의 활동 데이터를 추출할 수 있습니다.

POST 작업의 CXone WFM 급여 엔터티 이름은 wfm-payroll입니다.

데이터는 급여 코드의 날짜에 따라 필터링됩니다. 날짜 및 시간의 표준 시간대는 일정 단위의 표준 시간대를 따른다는 점을 유의하십시오.

CXone WFM 급여 CSV 파일에 있는 필드

열 이름	설명
이름	상담원의 이름. 필드 유형: 최대 255자의 문자열(VARCHAR)
성	상담원의 성. 필드 유형: 최대 255자의 문자열(VARCHAR)
사용자 이름	상담원의 사용자 이름입니다. 필드 유형: 최대 255자의 문자열(VARCHAR)
일정 단위	상담원의 일정 단위입니다. 필드 유형: 최대 256자의 문자열(VARCHAR)
일정 단위의 표준 시간대	상담원의 일정 단위의 표준 시간대입니다. 필드 유형: 최대 128자의 문자열(VARCHAR)
급여 코드	예정 활동 데이터가 포함된 급여 코드입니다. 필드 유형: 최대 50자의 문자열(VARCHAR)
날짜	활동의 날짜(일정 단위의 표준 시간대를 따름)입니다. 필드 유형: 날짜
시작 시간	활동의 시작 시간(일정 단위의 표준 시간대를 따름)입니다. 필드 유형: 시간 (9)
지속 시간(초)	활동의 지속 시간(초)입니다. 필드 유형: 숫자(8,0)