Work with exported recordings in AWS S3 bucket

AWS S3 기록 대량 작업 통합 설정되면 Genesys Cloud에 있는 녹음을 대량으로 AWS S3 버킷으로 내보낼 수 있습니다. 이 내보내기는 QM 정책을 통해 자동으로 수행하거나 기록 대량 작업 API를 호출하여 명시적으로 수행할 수 있습니다. 

이 문서에서는 AWS S3 버킷으로 내보낸 콘텐츠에 대해 자세히 설명합니다.

AWS S3 버킷 콘텐츠

녹음 파일은 다음 구조의 폴더로 AWS S3 버킷으로 내보내집니다.

s3://{bucket}/{organizationId}/year={year}/{month={month}/day={day}/hour={hourOfDay}/conversation_id={conversationId}/ 

자리 표시자 설명
{버킷} S3 버킷 이름.
{조직 ID} 조직 ID입니다.
{년도} 대화가 시작된 연도.
{월} 대화가 시작된 달(숫자).
{day} 대화가 시작된 날.
{hourOfDay}
대화가 시작된 시간입니다.
{대화 ID}
대화 ID입니다.
참고: 대화가 시작된 날짜와 시간은 UTC 시간으로 표시됩니다.

폴더에는 대화 중에 보관된 모든 녹음 파일이 포함되어 있습니다. 각 녹음 파일에는 하나의 녹음이 있으며 파일 이름은 녹음 ID입니다.

각 녹음 파일에는 해당 JSON 메타데이터 파일이 있습니다. JSON 메타데이터 파일 이름에는 "_metadata.json" 접미사가 붙습니다.

메타데이터는 내보낸 녹음을 검색하는 데 사용할 수 있습니다. 자세한 내용은 다음을 참조하십시오. Athena+Glue 예시 (녹음 검색 서비스의 예).

메타데이터 파일은 다음 스키마를 포함하는 JSON 형식입니다.

{
“$schema”: “http://json-schema.org/draft-04/schema#”,
“type”: “object”,
“properties”: {
“mediaType”: {
“description”: “Media Type (one of Call, Chat, Email, Message, Screen)”,
“type”: “string”
},
“mediaSubtype”: {
“description”: “The subtype of the recording (one of Trunk, Station, Consult, Screen)”,
“type”: “string”
},
“mediaSubject”: {
“description”: “The subject of the recording”,
“type”: “string”
},
“provider”: {
“description”: “Type of provider for the recording, for example edge”,
“type”: “string”
},
“userIds”: {
“description”: “List of users”,
“type”: “array”,
“items”: [
{
“type”: “string”
}
]
},
“startTime”: {
“description”: “Start time of the recordings”,
“type”: “string”
},
“endTime”: {
“description”: “End time of the recordings”,
“type”: “string”
},
“durationMs”: {
“description”: “Duration of the recording”,
“type”: “integer”
},
“initialDirection”: {
“description”: “Initial direction of the conversation (inbound/outbound)”,
“type”: “string”
},
“aniNormalized”: {
“description”: “ANI”,
“type”: “string”
},
“aniDisplayable”: {
“description”: “ANI in displayable form”,
“type”: “string”
},
“dnisNormalized”: {
“description”: “DNIS”,
“type”: “string”
},
“dnisDisplayable”: {
“description”: “DNIS in displayable form”,
“type”: “string”
},
“queueIds”: {
“description”: “List of queue IDs for the recording”,
“type”: “array”,
“items”: [
{
“type”: “string”
}
]
},
“wrapupCodes”: {
“description”: “Wrap-up codes for the conversation”,
“type”: “array”,
“items”: [
{
“type”: “string”
}
]
},
“organizationId”: {
“description”: “Unique ID for the conversation”,
“type”: “string”
},
“conversationId”: {
“description”: “Unique ID associated with the conversation”,
“type”: “string”
},
“conversationStartTime”: {
“description”: “Conversation’s start time”,
“type”: “string”
},
“conversationEndTime”: {
“description”: “Conversation’s end time”,
“type”: “string”
},
“recordingId”: {
“description”: “Unique ID for the recording”,
“type”: “string”
},
“filePath”: {
“description”: “Original path of the recording”,
“type”: “string”
},
“fileSize”: {
“description”: “Recording file size”,
“type”: “integer”
},
“messageType”: {
“description”: “Type of message platform from which the message originated, e.g., sms, twitter, line, facebook, whatsapp, webmessaging, open, instagram”,
“type”: “string”
},
“languageIds”: {
“description”: “Identifier on the language”,
“type”: “array”,
“items”: [
{
“type”: “string”
}
]
},
“screenInformation”: {
“description”: “Screen specific information, includes the screen ID, X and Y position, resolution information”,
“type”: “object”
}
},
“required”: [
“mediaType”,
“provider”,
“startTime”,
“endTime”,
“durationMs”,
“organizationId”,
“conversationId”,
“conversationStartTime”,
“conversationEndTime”,
“recordingId”,
“filePath”,
“fileSize”
]
}

예를 들어 화면 녹화가 활성화된 통화 대화에는 다음 폴더 콘텐츠가 있을 수 있습니다. 

아래 이미지에서 .opus 파일은 오디오 녹음 파일이고 .zip 파일에는 화면 녹음 파일이 포함되어 있으며 .json 파일은 각 미디어 파일과 연결된 JSON 메타데이터입니다.

이미지를 클릭하면 확대됩니다.

디지털 대화에는 다음과 같은 폴더 콘텐츠가 있을 수 있습니다.

아래 이미지에서 .zip 파일에는 디지털 녹음 파일이 포함되어 있으며 .json 파일은 해당 JSON 파일입니다.

이미지를 클릭하면 확대됩니다.

암호화

S3 버킷은 이미 AWS S3 서버 측 암호화(SSE)로 구성되어 있습니다. Amazon S3 관리형(SSE-S3) 암호화 키로 활성화되었거나 AWS 관리형 키로 활성화되었을 수 있습니다. 고객 제공 키 AWS 키 관리 서비스(SSE-KMS)에서.

AWS S3 서버 측 암호화(SSE)는 S3 버킷에 저장되어 있는 녹음 파일을 보호합니다. 파일이 버킷에서 검색되면 AWS는 파일 콘텐츠를 자동으로 해독합니다.

시스템에 추가로 활성화된 녹음 내보내기 암호화, S3 버킷에서 파일을 검색한 후 파일 콘텐츠를 직접 해독해야 합니다.

참고: Genesys는 FedRAMP 지역에서 PGP를 통해 내보낸 기록에 대한 객체 수준 암호화를 지원하지 않습니다. 서버 측 암호화가 지원됩니다.