화면 상호작용 녹화 API

API를 사용하면 데스크톱 활동의 화면 녹화를 시작할 수 있습니다. 이를 통해 연락이 없을 때 상담원의 화면을 녹화하고 백오피스 화면을 녹화할 수 있습니다.

이 API는 음성 또는 화면 녹화 기능이 있는 Engagement Hub 사용자와 CXone MpowerACD 사용자에게 제공됩니다.

시작하기 전에

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

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

또한 이러한 API를 사용하려면 Interactions Hub 화면 상호작용 기록 권한이 필요합니다.

시작 화면 상호작용 녹화

API를 사용하면 활성 통화에 참여하지 않은 특정 사용자의 화면 녹화를 시작할 수 있습니다. 시작 명령에서 매개변수로 녹음 기간을 지정해야 합니다. 지속시간은 5초에서 최대 허용시간인 3시간 30분 사이여야 합니다. 녹화 기간에 도달하면 녹화가 자동으로 중지됩니다. 또한, stop-screen-interaction-recording 명령을 호출하여 화면 녹화를 중지할 수 있습니다.

녹화가 시작되면(응답 코드 202로 표시) 또는 성공하면(응답 코드 200으로 표시) 녹화된 화면과 연관된 컨택 ID가 제공됩니다. 이 컨택 ID는 중지 명령을 내릴 때 사용해야 합니다.
API는 상담원과 고객 간의 실시간 통화 중에 활용될 수 있으며, 통화 내용은 녹음될 수 있습니다. 이런 경우에는 음성 대화를 녹음한 하나와 API 상호 작용을 기반으로 한 다른 하나 등 두 가지 녹음이 이루어지며, 각각은 서로 다른 연락처 ID와 연결됩니다.
라이브 통화에 마스킹을 적용하면 병렬로 녹화될 수 있는 API 화면 녹화 상호작용에도 영향을 미칩니다.
API를 사용하면 화면 녹화 인스턴스가 한 번만 발생할 수 있습니다. 상담원의 화면이 이미 API를 통해 녹화되고 있는 경우, 동일한 상담원에 대한 후속 API 호출은 새로운 화면 녹화를 생성하지 않으며 녹화 기간도 업데이트하지 않습니다.

방법: POST

엔드포인트: /interaction-recording-management-service/v1/interactions/start-screen-interaction-recording

매개변수:

userId*:

(질문)

문자열

기록할 사용자의 ID입니다.

녹음기간*:

(질문)

number

5~13200초 범위 내에서 필요한 녹음 기간을 지정합니다.

예시 값 및 응답

POST /interaction-recording-management-service/interactions/start-screen-interaction-recording?user-id=1234567&recordingDuration=3000

응답

상태 200-성공적인 작업.

설명(문자열): 응답에 대한 설명입니다.

contactId(숫자): ACD 연락처 ID입니다.

interactionId(문자열): 글로벌 상호작용 ID입니다.

httpStatus(문자열): HTTP 상태 설명입니다.
상태 202-작업이 진행 중입니다.

contactId(숫자): ACD 연락처 ID입니다.

interactionId(문자열): 글로벌 상호작용 ID입니다.

httpStatus(문자열): HTTP 상태 설명입니다.
상태 400-잘못된 요청입니다.
상태 401-요청한 사용자가 인증에 실패했습니다.
상태 403-요청하는 사용자는 작업을 수행할 권한이 없습니다.
상태 404-찾을 수 없음. 활성 인터랙션을 찾을 수 없습니다.
상태 425-이전 요청을 처리하는 동안 상호작용이 잠겼습니다.
상태 500-내부 서버 오류.
상태 504-요청 시간이 초과되었습니다.

화면 상호작용 녹화 중지

API를 사용하면 start-screen-interaction-recording 명령을 사용하여 시작된 특정 사용자의 연락처 ID에 대한 화면 녹화를 중지할 수 있습니다. start-screen-interaction-recording 명령의 응답에서 제공된 연락처 ID를 사용해야 합니다. 이 메서드를 호출하지 않으면 start-screen-interaction-recording 명령에서 제공한 기간이 지난 후 화면 녹화가 자동으로 중지됩니다.

방법: POST

엔드포인트: /interaction-recording-management-service/v1/interactions/stop-screen-interaction-recording

매개변수:

userId*:

문자열

중지할 기록된 사용자의 ID입니다.

연락처 ID*:

number

시작 화면 녹화 명령에서 반환된 연락처 ID입니다.

예시 값 및 응답

POST /interaction-recording-management-service/interactions/stop-screen-interaction-recording?user-id=1234567&contactId=1122334455

응답

상태 200-성공적인 작업.
상태 202-작업이 진행 중입니다.
상태 400-잘못된 요청입니다.
상태 401-요청한 사용자가 인증에 실패했습니다.
상태 403-요청하는 사용자는 작업을 수행할 권한이 없습니다.
상태 404-찾을 수 없음. 활성 인터랙션을 찾을 수 없습니다.
상태 425-이전 요청을 처리하는 동안 상호작용이 잠겼습니다.
상태 500-내부 서버 오류.
상태 504-요청 시간이 초과되었습니다.