데이터 추출 API

데이터 추출 API를 통해 외부 보고 목적으로 CXone Mpower에서 데이터를 추출할 수 있습니다. 예를 들어 QM 워크플로 데이터, QM 질문 및 답변 데이터, Recording 인터랙션 메타데이터 또는 WFM 급여 데이터를 추출할 수 있습니다. 데이터는 지정된 날짜 범위에 따라서만 필터링할 수 있습니다.

개발자 포털에서 데이터 추출 API를 사용해보고 해당 문서를 검토할 수 있습니다.

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

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

시작하기 전에

CXone Mpower개발자 포털 에서 API를 테스트할 수 있습니다. CXone Mpower 계정으로 로그인한 후 계정의 테넌트 고급 조직 그룹화는 CXone Mpower 시스템을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다.에게 요청을 할 수 있습니다.

API를 사용하려면 NiCE에 등록하여 인증에 사용되는 유효한 자격 증명을 받아야 합니다. 개발자 포털의 시작하기 페이지 에서 지침을 확인하세요.

이러한 API를 사용하려면 다음 권한이 필요합니다.

엔터티:
- 상호작용 메타데이터를 추출하는 경우 검색 및 재생 > API > 상호작용 메타데이터 추출 권한이 필요합니다.
- QM 워크플로 데이터를 추출하는 경우, QM 도구 > 데이터 추출 API > QM 워크플로 API 권한이 필요합니다.
- QM Q&A 데이터를 추출하는 경우, QM 도구 > 데이터 추출 API > QM 워크플로 API 권한이 필요합니다.
- WFM급여 데이터를 추출하려면 WFM > 데이터 추출 API > WFM급여 API 권한이 필요합니다.
- QM평가자 노트를 추출하는 경우 QM 도구 > 데이터 추출 API > QM 평가자 노트 API 권한이 필요합니다.

일자리를 구하세요

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

메서드: GET

엔드포인트: /data-extraction/v1/jobs

매개변수: 없음

일자리 준비

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

방법: POST

엔드포인트: /data-extraction/v1/jobs

매개변수: 없음

예시 값 및 응답

요청 본문*:	application/json
exportRequest { 설명:	데이터를 추출하기 위해 제공되어야 하는 매개변수입니다.
entityName	문자열 추출할 엔터티의 이름입니다. 올바른 엔터티 이름에 대해서는 아래 내용을 참조하십시오.
버전	문자열 추출할 엔터티의 버전입니다. 각 엔터티의 올바른 버전에 대해서는 아래 내용을 참조하십시오.
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초 동안 액세스할 수 있습니다(파일 다운로드에 걸린 시간 제외). 작업에 실패하면 오류 메시지가 반환됩니다. 링크를 사용하여 추출된 데이터에 액세스할 수 있습니다. 가능한 작업 상태는 실행 중, 성공, 실패, 취소 및 만료입니다.

메서드: GET

엔드포인트: /data-extraction/v1/jobs

매개변수:

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 - 내부 서버 오류.

QM 워크플로 엔터티 및 CSV 파일

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

POST 작업의 경우:

entityName : qm-workflows
버전 : 4

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

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)
실패한 중요 질문	값이 true인 경우, 사용자가 중요 질문에 실패했음을 의미하며, 평가 양식 점수는 0으로 설정됩니다. 값이 false인 경우, 사용자가 질문에 올바르게 답했음을 의미합니다. 필드 유형: 부울
사용자 검토 주석	평가에 이의를 제기할 때 사용자(상담원)가 입력한 주석입니다. 필드 유형: 최대 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 이상

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

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

POST 작업의 경우:

entityName : qm-questions
버전 : 2

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

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)
채점 가능	질문이 채점 가능한 것이었는지를 나타내는 True 또는 False 플래그입니다. 필드 유형: 부울
실제 점수	상담원이 질문에 대해 받은 점수입니다. 필드 유형: 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)
중요함	질문이 중요 질문이었는지를 나타내는 True 또는 False 플래그입니다. 필드 유형: 부울
실패한 중요 질문	값이 true인 경우, 사용자가 중요 질문에 실패했음을 의미하며, 평가 양식 점수는 0으로 설정됩니다. 값이 false인 경우, 사용자가 질문에 올바르게 답했음을 의미합니다. 필드 유형: 부울
필수	질문이 필수였는지를 나타내는 True 또는 False 플래그입니다. 필드 유형: 부울
질문 유형	질문의 유형: 라디오 예/아니요 확인란 드롭다운 날짜/시간 필드 유형: 최대 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 이상

QM 평가자 참고 및 CSV 파일

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

POST 작업의 경우:

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

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

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로 Recording 상호작용 메타데이터를 추출할 수 있습니다.

POST 작업의 경우:

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

인터랙션 메타데이터 CSV 파일에 있는 필드

열 이름	설명
ACD 통화 ID(예: 마스터 컨택 ID)	ACD 통화 ID는 ACD 솔루션에 따라 다릅니다. 예를 들어 이는 CXone Mpower 마스터 컨택 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, WhatsApp, Apple Messages for Business(Apple Business Chat), LINE 메시징, Telegram 메신저, Viber 메신저, 사용자 지정, Microsoft Teams, Slack. 공개 소셜 채널: Facebook, Google 장소, Google Play,LinkedIn, YouTube, Apple 앱 리뷰, 사용자 지정(공개). 필드 유형: 최대 150자의 문자열(VARCHAR)
화면 녹화	세그먼트가 화면 녹화를 포함하는지 여부: 예 아니요
음성 녹음 상태	레코딩의 상태: 성공 부분 녹음: 이 세그먼트의 일부가 녹음되지 않았지만 여전히 상호작용을 재생할 수 있습니다 어떤 정책과도 일치하지 않음: 녹음 없음 - 이 상호 작용으로 인해 어떤 녹음 정책도 트리거되지 않았습니다. 기록되지 않음(기록 %로 인해): 기록 없음 - 이 상호작용으로 인해 기록 정책이 트리거되었지만 정책에 정의된 기록 비율로 인해 기록되지 않았습니다. 기록 안 함 정책: 기록 없음 - 이 상호 작용에 대해 기록 안 함 정책이 트리거되었습니다. IVR에서 동의 거부: 녹음 없음 실패: 녹음 없음 마스크됨: 녹음 안 됨-녹음이 마스크됨 선택되지 않은 외부 번호로 녹음 전송: 녹음 없음 녹음 가능(음성) 선택 안 됨: 녹음 안 됨-에이전트 속성 녹음 가능(음성)이 선택되지 않았습니다. 필드 유형: 최대 250자의 문자열(VARCHAR)
화면 녹화 상태	레코딩의 상태: 성공 부분 녹음: 이 세그먼트의 일부가 녹음되지 않았지만 여전히 상호작용을 재생할 수 있습니다 어떤 정책과도 일치하지 않음: 녹음 없음 - 이 상호 작용으로 인해 어떤 녹음 정책도 트리거되지 않았습니다. 기록되지 않음(기록 %로 인해): 기록 없음 - 이 상호작용으로 인해 기록 정책이 트리거되었지만 정책에 정의된 기록 비율로 인해 기록되지 않았습니다. 기록 안 함 정책: 기록 없음 - 이 상호 작용에 대해 기록 안 함 정책이 트리거되었습니다. IVR에서 동의 거부: 녹음 없음 실패: 녹음 없음 마스크됨: 녹음 안 됨-녹음이 마스크됨 필드 유형: 최대 250자의 문자열(VARCHAR)
레코딩 주의	레코딩 알림에 포함되는 항목: ScreenAgent에 접근할 수 없습니다: ScreenAgent가 올바르게 구성되지 않았거나 실행 중이 아닙니다. 화면 녹화 오류: 통화 내용이 완전히 녹음되지 않을 수 있습니다. 화면 녹화 오류 ScreenAgent 머신 구성 오류 ScreenAgent와 에이전트의 화면 사이에 연결이 없습니다. ScreenAgent 머신 네트워크 구성 오류 ScreenAgent가 머신 구성으로 인해 녹화를 시작하지 못했습니다. ScreenAgent가 자체 서명 인증서 구성으로 인해 녹화 파일을 업로드하지 못했습니다. ScreenAgent 머신 하드 드라이브 구성 오류 ScreenAgent가 최대 병렬 호출 수에 도달했습니다. 화면 녹화가 최대 통화 시간에 도달했습니다. ScreenAgent 문제 해결을(를) 참조하십시오. 녹음이 너무 짧음: 화면 녹화 시간이 너무 짧습니다. 오디오는 4초 미만이며 녹음이 불가능합니다. 미디어 서버에 연결되지 않음: 미디어 서버에 문제가 있어 녹화가 불가능합니다. 이 오류는 다양한 이유로 발생할 수 있으며, 녹음 알림에 대한 오류 설명에는 더 자세한 정보가 제공됩니다. Multi-ACD (Open) 솔루션의 경우 이 오류는 고객의 SIP 이벤트가 누락되었음을 나타냅니다. 이는 초대장 전체가 누락되었거나 한쪽(근거리 또는 원거리)만 수신되었음을 의미할 수 있습니다. 음성 녹음기가 통화를 녹음할 수 없음: 녹음되지 않습니다. 음성 녹음기에 문제가 있습니다. 여러 가지 이유가 있을 수 있습니다. 녹음 경보의 오류 설명은 보다 자세한 정보를 제공합니다. 오디오 사용 불가: 불완전한 오디오 데이터: 이 상호 작용에 오디오를 사용할 수 없습니다(불완전한 오디오 데이터). CXone Mpower 지원팀에 문의하세요. 오디오 사용 불가: 오디오 패킷 누락: 이 상호 작용에 오디오를 사용할 수 없습니다(오디오 패킷 누락). CXone Mpower 지원팀에 문의하세요. 오디오　이용불가: 외부 소스에서 오디오 패킷 누락：　(CR 기능) 이 인터랙션에 오디오를　사용할　수　없습니다(미디어 스트림에서 오디오 패킷 누락). CXone Mpower 지원팀에 문의하세요. 시스템 오류: 녹음이 시작되지 않았거나 다른 일반 오류가 발생했습니다. CXone Mpower 지원팀에 문의하세요. 마스킹 실패: 녹음을 마스킹하지 못했습니다. 녹음을 재생하여 민감한 데이터가 있는지 확인할 수 있습니다. 녹음을 삭제하려면 작업을 클릭하고 녹음 삭제를 선택합니다. 요청 시 녹음 중지: 사용자에 의해 녹음이 중지되었습니다.
정책 이름	이 인터랙션에 적용된 레코딩 정책 또는 레코딩 금지 정책의 이름입니다. 필드 유형: 최대 100자의 문자열(VARCHAR)
ANI	수신 전화의 경우 ANI는 발신자(발신자 ID)의 전화번호입니다. 필드 유형: 최대 200자의 문자열(VARCHAR)
DNIS	수신 전화의 경우 DNIS는 전화를 건 전화번호(숫자)입니다. 필드 유형: 최대 200자의 문자열(VARCHAR)
ACW(초)	통화가 종료된 후 상담원의 통화 후속 작업을 포착하기 위해 화면 녹화가 지속된 시간(초)입니다.
처분	통화에 대한 추가 정보와 함께 상담원이 할당하는 태그입니다.
외부 세그먼트 ID	녹음의 외부 소스에 정의된 세그먼트의 ID입니다. 값은 AppLink이(가) 있는 사용자만 사용할 수 있습니다. 필드 유형: 최대 100자의 문자열(VARCHAR) API 버전: 6 이상
외부 컨택 ID	녹음의 외부 소스에 정의된 컨택의 ID입니다. 값은 AppLink이(가) 있는 사용자만 사용할 수 있습니다. 필드 유형: 최대 100자의 문자열(VARCHAR) API 버전: 6 이상
소스	녹음의 소스-CXone Mpower 또는 외부 소스. 값에는 다음이 포함됩니다. 참여 BrandEmbassy Uptivity InContactACD 다중 ACD MigratedCallsExternal MigratedCallsEngage MigratedCallsNim SmartReach 필드 유형: 최대 30자의 문자열(VARCHAR) API 버전: 6 이상
관련 컨택 번호 목록	세그먼트와 관련된 상담원의 컨택 번호 목록입니다. 이 목록의 요소는 숫자 유형으로만 구성됩니다. 필드 유형: Variant API 버전: 7 이상
상호작용 ID	인터랙션의 고유 ID(UUID)입니다. 단일 상호작용과 연결된 세그먼트가 여러 개 있는 경우 세그먼트는 동일한 상호작용 ID를 가질 수 있습니다. 상호작용 ID는 세그먼트 ID 또는 컨택 ID와 동일하지 않습니다. 필드 유형: 최대 36자의 문자열(VARCHAR) API 버전: 7 이상
보류 수	통화 중에 상담원이 고객을 보류시킨 총 횟수입니다. API 버전: 8 이상
유지 기간(초)	고객이 통화 중에 대기한 총 시간(초)(모든 대기 시간의 합계)입니다. API 버전: 8 이상
복잡한 호출	통화에 여러 사람이 참여했는지 여부를 나타냅니다. 필드 유형: TRUE 또는 FALSE(BOOLEAN)로 구성된 부울 값 API 버전: 9 이상
음성 녹음 마스킹 상태	상호작용에 대한 음성 녹음 마스킹 상태를 나타냅니다. 필드 유형: 문자열 API 버전: 10 이상 가능한 값: 성공: 음성 녹음이 성공적으로 마스크되었습니다. 실패: 음성 녹음 마스킹에 실패했습니다. 부분: 음성 녹음이 부분적으로 가려졌습니다. NA: 해당 없음
화면 녹화 마스킹 상태	상호작용에 대한 화면 녹화 마스킹 상태를 나타냅니다. 필드 유형: 문자열 API 버전: 10 이상 가능한 값: 성공: 화면 녹화가 성공적으로 마스크되었습니다. 실패: 화면 녹화 마스킹에 실패했습니다. 부분: 화면 녹화가 부분적으로 마스크되었습니다. NA: 해당 없음
상담원 사용자 ID	상담원에게 할당된 고유 식별자입니다. CSV 파일에는 최대 5명의 에이전트를 지원하는 각 에이전트에 대한 별도 열로 이 필드가 포함되어 있습니다. 예시 열 이름: `Agent 1 User ID, Agent 2 User ID, ..., Agent 5 User ID` 필드 유형: 최대 36자의 문자열(VARCHAR)
상담원 ACD ID	ACD에 의해 상담원에게 할당된 고유 식별자입니다. CSV 파일에는 최대 5명의 에이전트를 지원하는 각 에이전트에 대한 별도 열로 이 필드가 포함되어 있습니다. 예시 열 이름: `Agent 1 ACD ID, Agent 2 ACD ID, ..., Agent 5 ACD ID` 필드 유형: 최대 50자의 문자열(VARCHAR)
상담원 컨택 번호	이 상담원에 대해 생성된 컨택의 고유 식별자입니다. 이 필드는 Multi-ACD (Open)에 대해 사용할 수 없습니다. CSV 파일에는 최대 5명의 에이전트를 지원하는 각 에이전트에 대한 별도 열로 이 필드가 포함되어 있습니다. 예시 열 이름: `Agent 1 Contact Number, Agent 2 Contact Number, ..., Agent 5 Contact Number` 필드 유형: 최대 38자리를 포함하는 숫자 API 버전: 5 이상
상담원 이름	CXone Mpower 직원 계정에 지정된 상담원의 이름입니다. CSV 파일에는 최대 5명의 에이전트를 지원하는 각 에이전트에 대한 별도 열로 이 필드가 포함되어 있습니다. 예시 열 이름: `Agent 1 Name, Agent 2 Name, ..., Agent 5 Name` 필드 유형: 최대 100자의 문자열(VARCHAR)
상담원 팀 ID	상담원의 팀에 할당된 고유 식별자입니다. CSV 파일에는 최대 5명의 에이전트를 지원하는 각 에이전트에 대한 별도 열로 이 필드가 포함되어 있습니다. 예시 열 이름: `Agent 1 Team ID, Agent 2 Team ID, ..., Agent 5 Team ID` 필드 유형: 최대 36자의 문자열(VARCHAR UUID)
상담원 팀	상담원의 팀 이름입니다. CSV 파일에는 최대 5명의 에이전트를 지원하는 각 에이전트에 대한 별도 열로 이 필드가 포함되어 있습니다. 예시 열 이름: `Agent 1 Team, Agent 2 Team, ..., Agent 5 Team` 필드 유형: 최대 40자의 문자열(VARCHAR)
상담원 스킬	능력, 전공 및 지식에 따라 ACD에서 상담원에게 할당된 분류입니다. CSV 파일에는 최대 5명의 에이전트를 지원하는 각 에이전트에 대한 별도 열로 이 필드가 포함되어 있습니다. 예시 열 이름: `Agent 1 Skills, Agent 2 Skills, ..., Agent 5 Skills` 필드 유형: 최대 50자의 문자열(VARCHAR)
비즈니스 데이터 이름	지정한 비즈니스 데이터 필드의 이름입니다. CSV 파일에는 각 비즈니스 데이터 항목에 대한 별도 열로 다음 필드가 포함되어 있습니다. API 버전 7~10의 경우 파일은 최대 50개 항목(35개 varchar, 10개 숫자, 5개 Boolean)을 지원합니다. Controlled Release(CR) 프로그램의 고객에게 제공되는 API 버전 11의 경우, 해당 파일은 최대 250개 항목(1-35개 varchar, 36-45개 숫자, 46-65개 부울, 66-95개 날짜, 96-210개 varchar, 211-250개 숫자)을 지원합니다. 예시 열 이름: `Business Data Name 1, Business Data Name 2, ..., Business Data Name 50`(CR의 경우 최대 `Business Data Name 250`) 필드 유형: 최대 128자의 문자열(VARCHAR) API 버전: 7 이상
비즈니스 데이터 값	비즈니스 데이터 값은 텍스트, 숫자 또는 true/false일 수 있습니다. CSV 파일에는 각 비즈니스 데이터 항목에 대한 별도 열로 다음 필드가 포함되어 있습니다. API 버전 7~10의 경우 파일은 최대 50개 항목(35개 varchar, 10개 숫자, 5개 Boolean)을 지원합니다. Controlled Release(CR) 프로그램의 고객에게 제공되는 API 버전 11의 경우, 해당 파일은 최대 250개 항목(1-35개 varchar, 36-45개 숫자, 46-65개 부울, 66-95개 날짜, 96-210개 varchar, 211-250개 숫자)을 지원합니다. 예시 열 이름: `Business Data Value 1, Business Data Value 2, ..., Business Data Value 50`(CR의 경우 최대 `Business Data Value 250`) 필드 유형: 최대 4000자의 문자열(VARCHAR) 최대 38자리의 숫자 값(NUMBER) TRUE 또는 FALSE로 구성된 부울 값(BOOLEAN) 지원되는 형식(DATE)의 날짜 값 API 버전: 7 이상 상호 작용이 생성된 후 2일이 지난 후에 이루어진 비즈니스 데이터 업데이트는 데이터 추출 API 출력에 포함되지 않습니다.

WFM 급여 엔터티 및 CSV 파일

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

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

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

WFM 급여 CSV 파일에 있는 필드

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