요청 시 레코딩 API

이 API는 CXone Multi-ACD (CXone Open) 사용자만 사용할 수 있습니다.

이러한 API를 사용하면 요청 시 통화 녹음을 시작, 중지, 비활성화할 수 있으므로 API를 통해 녹음을 제어할 수 있습니다.

시작하기 전

마스크 및 마스크 해제 API 사용을 시작하려면 사용자 권한을 설정하고, 액세스 키를 생성하고, 개발자 포털에서 설명하는 등록 및 인증 프로세스를 따르십시오.

이 API를 사용하려면 검색 및 재생 > API > 다중 ACD 요청 시 레코딩 API 권한이 필요합니다.

POST 요청 시 레코딩 시작

API를 사용하면 상담원이나 애플리케이션이 특정 사용자의 진행 중인 통화를 녹음할 수 있습니다. 규정 준수 목적, 품질 보증 또는 교육과 관련된 구체적인 인터랙션이나 대화를 수집하는 데 사용할 수 있습니다.

음성만 녹음을 시작하거나 음성과 화면 모두 녹음/녹화를 시작하도록 지정할 수 있습니다. 이 API 메서드는 레코딩 정책보다 우선순위가 높습니다.

mediaType 플래그는 옵션이며 어떤 미디어 유형을 레코딩할지 제어할 수 있습니다. 지원되는 값은 voice와 voiceAndScreen이며, 이를 통해 음성만 녹음하거나 음성과 화면을 모두 녹음/녹화할 수 있습니다. 플래그가 전달되지 않으면 기본값은 voice입니다.

userId*:

문자열

레코딩할 미디어 유형입니다.

POST /interaction-recording-management-service/interactions/start-recording-on-demand?user-id=1234567

응답

  • 상태 200 - 성공적인 작업. 요청 시 레코딩 시작 요청이 시작되었습니다.

  • 상태 202 - 작업 진행 중. 요청 시 시작 요청이 수락되어 처리 중입니다.

  • 400 오류 - 잘못된 요청

  • 상태 401 - 요청한 사용자가 인증에 실패함.

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

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

  • 상태 409 - 서비스 상태로 인해 요청을 실행할 수 없습니다.

  • 상태 425 - 이전 요청 시 레코딩/요청 시 중지 요청을 처리하는 동안 인터랙션이 잠겼습니다.

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

  • 상태 504 - 요청 시간 초과.

POST 요청 시 레코딩 중지

API를 사용하면 특정 사용자의 통화 진행 중 음성 및 화면 녹음/녹화를 중지할 수 있습니다. 이는 고객의 개인 정보를 보호하거나 특정 유형의 대화 녹음을 제한하는 규정을 준수하는 데 사용될 수 있습니다.

이 API 메서드는 레코딩 정책보다 우선순위가 높습니다. 요청 시 레코딩 중지 후 레코딩은 요청 시 레코딩 시작을 호출해서만 재개할 수 있습니다.

userId*:

문자열

레코딩할 상담원의 상담원 사용자 ID입니다.

POST /interaction-recording-management-service/interactions/stop-recording-on-demand?user-id=1234567

응답

  • 상태 200 - 성공적인 작업. 요청 시 레코딩 중지 요청이 시작되었습니다.

  • 상태 202 - 작업 진행 중. 요청 시 중지 요청이 수락되어 처리 중입니다.

  • 400 오류 - 잘못된 요청.

  • 상태 401 - 요청한 사용자가 인증에 실패함.

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

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

  • 상태 409 - 서비스 상태로 인해 요청을 실행할 수 없습니다.

  • 상태 425 - 이전 요청 시 레코딩/요청 시 중지 요청을 처리하는 동안 인터랙션이 잠겼습니다..

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

  • 상태 504 - 요청 시간 초과.

POST 통화 녹음 옵션 비활성화

API를 사용하면 고객이 동의를 거부하고 레코딩에 동의하지 않을 경우 통화 음성 및 화면을 녹음/녹화하는 옵션을 비활성화할 수 있습니다. 이는 특히 EU 일반 데이터 보호 규정(GDRP)과 관련이 있습니다. 고객이 동의를 거부하면 CXone Recording은 통화를 레코딩하지 않습니다. 이는 통화를 레코딩하도록 레코딩 정책이 설정되어 있거나, 상담원이 요청에 따라 또는 API를 사용하여 통화를 레코딩하는 경우에도 마찬가지입니다.

API 통화 후 레코딩은 전환, 협의, 그룹통화를 포함한 전체 고객 컨택에 대해 개시할 수 없습니다. 통화 레코딩이 진행되는 동안 API가 호출되면 CXone Recording이 레코딩을 중지하고, 레코딩된 통화 부분을 검색 및 재생할 수 있습니다.

레코딩 동의는 현재 통화에만 적용됩니다. 이는 향후 고객과의 인터랙션을 위해 저장되지 않습니다.

userId*:

문자열

레코딩할 상담원의 상담원 사용자 ID입니다.

POST /interaction-recording-management-service/interactions/do-not-record?user-id=1234567

응답

  • 상태 200 - 성공적인 작업. 레코딩 금지 요청이 시작되었습니다.

  • 상태 202 - 작업 진행 중. 레코딩 금지 요청이 수락되어 처리 중입니다.

  • 400 오류 - 잘못된 요청.

  • 상태 401 - 요청한 사용자가 인증에 실패함.

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

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

  • 상태 409 - 서비스 상태로 인해 요청을 실행할 수 없습니다.

  • 상태 425 - 이전 요청을 처리하는 동안 인터랙션이 잠겼습니다.

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

  • 상태 504 - 요청 시간 초과.