화면 상호작용 녹화 API

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

이 API는 Multi-ACD (Open) 및 CXone MpowerACD 사용자에게 제공됩니다.

시작하기 전

이러한 API를 사용하려면 먼저 사용자 권한을 설정하고, 액세스 키를 생성하고, 개발자 포털에 설명된 등록 및 인증 프로세스를 따르세요.

이러한 API에는 Interactions Hub 화면 상호작용 기록 권한이 필요합니다.

POST 화면 상호작용 녹화 시작

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

  • 녹화가 시작되면(응답 코드 202로 표시) 또는 성공하면(응답 코드 200으로 표시) 녹화된 화면과 연관된 연락처 ID가 제공됩니다. 이 연락처 ID는 중지 명령을 내릴 때 사용해야 합니다.

  • API는 상담원과 고객 간의 실시간 통화 중에 활용될 수 있으며, 통화 내용은 녹음될 수 있습니다. 이런 경우에는 음성 대화를 녹음한 하나와 API 상호 작용을 기반으로 한 다른 하나 등 두 가지 녹음이 이루어지며, 각각은 서로 다른 연락처 ID와 연결됩니다.

  • 라이브 통화에 마스킹을 적용하면 병렬로 녹화될 수 있는 API 화면 녹화 상호작용에도 영향을 미칩니다.

  • API를 사용하면 화면 녹화 인스턴스가 한 번만 발생할 수 있습니다. 상담원의 화면이 이미 API를 통해 녹화되고 있는 경우, 동일한 상담원에 대한 후속 API 호출은 새로운 화면 녹화를 생성하지 않으며 녹화 기간도 업데이트하지 않습니다.

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

  • 상태 202-작업이 진행 중입니다.

    contactId(숫자): ACD 연락처 ID

    interactionId(문자열): 글로벌 상호작용 ID

  • 상태 400-잘못된 요청입니다.

  • 상태 401-요청한 사용자가 인증에 실패했습니다.

  • 상태 403-요청하는 사용자는 작업을 수행할 권한이 없습니다.

  • 상태 404-찾을 수 없음. 활성 인터랙션을 찾을 수 없습니다.

  • 상태 425-이전 요청을 처리하는 동안 상호작용이 잠겼습니다.

  • 상태 500-내부 서버 오류.

  • 상태 504-요청 시간이 초과되었습니다.

POST 화면 상호작용 녹화 중지

API를 사용하면 start-screen-interaction-recording 명령을 사용하여 시작된 특정 사용자의 연락처 ID에 대한 화면 녹화를 중지할 수 있습니다. start-screen-interaction-recording 명령의 응답에서 제공된 연락처 ID를 사용해야 합니다. 이 메서드를 호출하지 않으면 start-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-요청 시간이 초과되었습니다.