마스크 및 마스크 해제 API

이 API는 CXone Multi-ACD (CXone Open) 사용자만 사용할 수 있습니다. CXone ACD를 사용하는 경우 DEVone 개발자 커뮤니티 포털의 Agent API를 참조하십시오.

마스크 및 마스크 해제 API를 사용하면 상담원이 민감한 정보를 수집한 다음 녹음 마스킹을 해제할 때 음성 녹음 및 화면 녹화를 마스킹할 수 있습니다. 녹음을 마스킹하거나 마스킹 해제하는 기능은 조직이 개인 정보 보호 및 PCI 규정을 준수하는 데 도움이 됩니다. 이러한 API를 사용하면 녹음을 자동 또는 수동으로 마스킹하고 마스킹 해제할 수 있습니다. 사용자가 특정 사용자에 대한 마스킹 또는 마스킹 해제 요청을 제출합니다.

마스크 API를 호출하면 지정된 사용자 ID를 가진 상담원과 통화 중인 모든 참가자의 음성 녹음 및 화면 녹화가 중지됩니다.

  • 통화 녹음 여부에 관계없이 API 호출을 요청할 수 있습니다. 통화가 녹음되지 않으면 아무 작업도 발생하지 않습니다. 상담원은 통화가 녹음되지 않는다고 생각하는 경우에도 민감한 데이터를 수집할 때 항상 통화를 마스킹하도록 교육받을 수 있습니다. 이는 상담원이 모르는 사이에 관리자가 시작한 요청이나 상담원의 애플리케이션 중 하나에서 통화가 녹음될 수 있기 때문입니다.

  • 상담원이 고객과의 활성 통화를 두 번 이상 참여하고 있는 경우 API 호출은 상담원이 참여한 최근 통화를 마스킹합니다.

마스크 해제 API를 호출하면 통화의 음성 녹음 및 화면 녹화가 재개됩니다. 다음과 같은 경우 아무 작업도 발생하지 않습니다.

  • 마스킹 요청시 통화가 녹음되지 않았습니다.

  • 마스킹 작업 중에 녹음 중지 이벤트가 수신되었습니다.

마스크 및 마스크 해제 API는 DEVone 개발자 커뮤니티 포털에서 사용할 수 있습니다.

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

시작하기 전

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

  • 엔터티: 녹음을 마스킹하거나 마스킹 해제하려면 검색 및 재생 > API > Multi-ACD 마스킹 API 권한이 필요합니다.

POST 마스크

지정된 상담원 사용자 ID에 대해 음성 녹음 및 화면 녹화를 백색 소음으로 마스킹합니다. 마스킹 요청과 마스킹 해제 요청을 쌍으로 연결해야 합니다.

userId*:

문자열

마스킹할 상담원의 상담원 사용자 ID.

POST /interaction-recording-management-service/v1/interactions/mask?userId=12345

응답

  • 상태 200 - 성공적인 작업. 통화가 마스킹되는 중입니다.

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

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

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

  • 상태 404 - 찾을 수 없음. 요청한 상담원에 대한 활성 상호작용이 없습니다.

  • 상태: 422 - 내부 통화에 대한 작업이 지원되지 않습니다.

  • 상태 425 - 이전 마스킹/마스킹 해제 요청을 처리하는 동안 상호작용이 잠겼습니다. 이전 요청으로 서비스가 바쁜 동안에는 마스킹 요청을 처리할 수 없습니다.

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

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

POST 마스크 해제

해당 상담원 사용자 ID에 대한 음성 녹음 및 화면 녹화 마스킹을 해제합니다.

userId*:

문자열

마스킹 해제할 상담원의 상담원 사용자 ID.

POST /interaction-recording-management-service/v1/interactions/unmask?userId=12345

응답

  • 상태 200 - 성공적인 작업. 통화가 마스킹 해제되는 중입니다.

  • 상태 202 - 작업 진행 중. 마스킹 해제 요청이 수락되어 처리 중입니다.

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

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

  • 상태 404 - 찾을 수 없음. 요청한 상담원에 대한 활성 상호작용이 없습니다.

  • 상태: 422 - 내부 통화에 대한 작업이 지원되지 않습니다.

  • 상태 425 - 이전 마스킹/마스킹 해제 요청을 처리하는 동안 상호작용이 잠겼습니다. 서비스가 이전 요청으로 인해 사용 중인 동안에는 마스킹 해제 요청을 처리할 수 없습니다.

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

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