StartCallAnalyticsJob

고객 서비스 통화의 오디오를 녹음하고 요청에 포함하기로 선택한 추가 요청 매개 변수를 적용합니다.

Call Analytics는 다양한 표준 트랜스크립션 기능 외에도 통화 특성, 통화 요약, 화자 감정, 텍스트 트랜스크립트와 오디오 파일의 선택적 편집 기능을 제공합니다. 사용자 지정 범주를 적용하여 지정된 조건에 플래그를 지정할 수도 있습니다. 이러한 기능 및 인사이트에 대해 자세히 알아보려면 Call Analytics를 통한 콜 센터 오디오 분석을 참조하십시오.

Call Analytics 작업에 카테고리를 적용하려면 채용 요청을 제출하기 전에 카테고리를 생성해야 합니다. 카테고리는 작업에 소급 적용할 수 없습니다. 새 범주를 만들려면CreateCallAnalyticsCategory 작업을 사용하십시오. Call Analytics 카테고리에 대해 자세히 알아보려면 통화 후 트랜스크립션을 위한 카테고리 만들기 및 실시간 트랜스크립션을 위한 카테고리 만들기를 참조하세요.

StartCallAnalyticsJob요청을 하려면 먼저 미디어 파일을 Amazon S3 버킷에 업로드해야 합니다. 그런 다음Media 파라미터를 사용하여 파일의 Amazon S3 위치를 지정할 수 있습니다.

StartCallAnalyticsJob요청에 다음 파라미터를 포함해야 합니다.

region: 요청을 하는AWS 리전 곳. Amazon Transcribe에서AWS 리전 지원되는 목록은 Amazon Transcribe 엔드포인트 및 할당량을 참조하십시오.
CallAnalyticsJobName: 트랜스크립션 작업을 위해 생성한 사용자 지정 이름으로, 작업 내에서는 고유합니다AWS 계정.
DataAccessRoleArn: 입력 파일이 포함된 Amazon S3 버킷에 액세스할 수 있는 권한이 있는 IAM 역할의 Amazon 리소스 이름 (ARN) 입니다.
Media(MediaFileUri또는RedactedMediaFileUri): 미디어 파일의 Amazon S3 위치입니다.

참고

Call Analytics를 사용하면 입력 오디오의MediaFileUri 위치를 지정하는 대신RedactedMediaFileUri 포함시켜 미디어 파일에 포함된 오디오를 편집할 수 있습니다. 오디오를 편집하기로 선택한 경우 응답RedactedMediaFileUri 필드에 지정된 위치에서 편집된 미디어를 찾을 수 있습니다.

요청 구문


{
   "CallAnalyticsJobName": "string",
   "ChannelDefinitions": [ 
      { 
         "ChannelId": number,
         "ParticipantRole": "string"
      }
   ],
   "DataAccessRoleArn": "string",
   "Media": { 
      "MediaFileUri": "string",
      "RedactedMediaFileUri": "string"
   },
   "OutputEncryptionKMSKeyId": "string",
   "OutputLocation": "string",
   "Settings": { 
      "ContentRedaction": { 
         "PiiEntityTypes": [ "string" ],
         "RedactionOutput": "string",
         "RedactionType": "string"
      },
      "LanguageIdSettings": { 
         "string" : { 
            "LanguageModelName": "string",
            "VocabularyFilterName": "string",
            "VocabularyName": "string"
         }
      },
      "LanguageModelName": "string",
      "LanguageOptions": [ "string" ],
      "VocabularyFilterMethod": "string",
      "VocabularyFilterName": "string",
      "VocabularyName": "string"
   }
}

요청 파라미터

모든 작업에 공통되는 매개 변수에 대한 자세한 내용은 일반 매개 변수를 참조하세요.

요청은 JSON 형식의 다음 데이터를 받습니다.

CallAnalyticsJobName

Call Analytics 작업을 위해 사용자가 선택한 고유한 이름입니다.

이 이름은 대소문자를 구분하며 공백을 포함할 수 없으며, 에서 고유해야 합니다AWS 계정. 기존 작업과 동일한 이름으로 새 작업을 만들려고 하면ConflictException 오류가 발생합니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.

패턴: ^[0-9a-zA-Z._-]+

필수 항목 여부: 예

ChannelDefinitions

어떤 스피커가 어느 채널에 있는지 지정할 수 있습니다. 예를 들어 상담원이 가장 먼저 말하는 참가자인 경우0 (첫 번째 채널을 나타내기 위해) 로 설정하고ChannelIdAGENT (상담원이 말하는 사람임을 나타내기 위해) 로 설정합니다.ParticipantRole

유형: ChannelDefinition 객체 배열

배열 멤버: 고정된 항목 수는 2개입니다.

필수 항목 여부: 아니요

DataAccessRoleArn

입력 파일이 포함된 Amazon S3 버킷에 액세스할 수 있는 권한이 있는 IAM 역할의 Amazon 리소스 이름 (ARN) 입니다. 지정한 역할에 지정된 Amazon S3 위치에 액세스할 수 있는 적절한 권한이 없는 경우 요청이 실패합니다.

IAM 역할 ARN의 형식은 다음과 같습니다arn:partition:iam::account:role/role-name-with-path. 예: arn:aws:iam::111122223333:role/Admin.

자세한 내용은 IAM ARN을 참조하세요.

유형: String

길이 제약: 최소 길이는 20입니다. 최대 길이는 2048입니다.

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

필수 항목 여부: 아니요

Media

통화 분석 요청에 사용하려는 미디어 파일의 Amazon S3 위치를 설명합니다.

유형: Media 객체

필수 항목 여부: 예

OutputEncryptionKMSKeyId

통화 분석 결과를 암호화하는 데 사용할 KMS 키입니다.

현재AWS 계정 키에 있는 키를 사용하는 경우 다음 네 가지 방법 중 하나로 KMS 키를 지정할 수 있습니다.

KMS 키 ID 자체를 사용하십시오. 예: 1234abcd-12ab-34cd-56ef-1234567890ab.
KMS 키 ID에 별칭을 사용합니다. 예: alias/ExampleAlias.
KMS 키 ID에 Amazon 리소스 이름 (ARN) 을 사용합니다. 예: arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.
KMS 키 별칭을 위해 ARN을 사용합니다. 예: arn:aws:kms:region:account-ID:alias/ExampleAlias.

현재AWS 계정 키와 AWS 계정다른 위치에 있는 키를 사용하는 경우 다음 두 가지 방법 중 하나로 KMS 키를 지정할 수 있습니다.

KMS 키 ID에는 ARN을 사용하십시오. 예: arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.
KMS 키 별칭을 위해 ARN을 사용합니다. 예: arn:aws:kms:region:account-ID:alias/ExampleAlias.

암호화 키를 지정하지 않으면 출력은 기본 Amazon S3 키 (SSE-S3) 로 암호화됩니다.

KMS 키를 지정하여 출력을 암호화하는 경우OutputLocation 파라미터를 사용하여 출력 위치도 지정해야 합니다.

StartCallAnalyticsJob요청을 하는 역할의 권한이 있어야 합니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이는 2048입니다.

패턴: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

필수 항목 여부: 아니요

OutputLocation

통화 분석 트랜킷 출력을 저장하려는 Amazon S3 위치입니다. 다음 형식 중 하나를 사용하여 출력 위치를 지정할 수 있습니다.

s3://DOC-EXAMPLE-BUCKET
s3://DOC-EXAMPLE-BUCKET/my-output-folder/
s3://DOC-EXAMPLE-BUCKET/my-output-folder/my-call-analytics-job.json

파일 이름 (옵션 3) 을 지정하지 않는 한 출력 파일 이름은CallAnalyticsJobName 매개 변수를 사용하여 트랜스크립션 작업에 지정한 이름과 일치하는 기본값을 가집니다.

OutputEncryptionKMSKeyId파라미터를 사용하여 출력을 암호화하는 KMS 키를 지정할 수 있습니다. KMS 키를 지정하지 않으면 Amazon Transcribe Transvice 키에 기본 Amazon S3 키를 사용합니다.

OutputLocation지정하지 않으면 트랜스크립트가 서비스 관리형 Amazon S3 버킷에 저장되고 트랜스크립트에 액세스할 수 있는 URI가 제공됩니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이는 2입니다.

패턴: (s3://|http(s*)://).+

필수 항목 여부: 아니요

Settings

StartCallAnalyticsJob요청에 콘텐츠 수정을 비롯한 추가 옵션 설정을 지정하면 Call Analytics 작업에 사용자 지정 언어 모델, 어휘 필터 및 사용자 지정 어휘를 적용할 수 있습니다.

유형: CallAnalyticsJobSettings 객체

Required: No

응답 구문


{
   "CallAnalyticsJob": { 
      "CallAnalyticsJobName": "string",
      "CallAnalyticsJobStatus": "string",
      "ChannelDefinitions": [ 
         { 
            "ChannelId": number,
            "ParticipantRole": "string"
         }
      ],
      "CompletionTime": number,
      "CreationTime": number,
      "DataAccessRoleArn": "string",
      "FailureReason": "string",
      "IdentifiedLanguageScore": number,
      "LanguageCode": "string",
      "Media": { 
         "MediaFileUri": "string",
         "RedactedMediaFileUri": "string"
      },
      "MediaFormat": "string",
      "MediaSampleRateHertz": number,
      "Settings": { 
         "ContentRedaction": { 
            "PiiEntityTypes": [ "string" ],
            "RedactionOutput": "string",
            "RedactionType": "string"
         },
         "LanguageIdSettings": { 
            "string" : { 
               "LanguageModelName": "string",
               "VocabularyFilterName": "string",
               "VocabularyName": "string"
            }
         },
         "LanguageModelName": "string",
         "LanguageOptions": [ "string" ],
         "VocabularyFilterMethod": "string",
         "VocabularyFilterName": "string",
         "VocabularyName": "string"
      },
      "StartTime": number,
      "Transcript": { 
         "RedactedTranscriptFileUri": "string",
         "TranscriptFileUri": "string"
      }
   }
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

CallAnalyticsJob

작업 상태 및 해당하는 경우 실패 이유를 포함하여 현재 Call Analytics 작업에 대한 세부 정보를 제공합니다.

유형: CallAnalyticsJob 객체

오류

모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.

BadRequestException

요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:IN PROGRESS) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.

HTTP 상태 코드: 400

ConflictException

이 이름을 가진 리소스가 이미 있습니다. 리소스 이름은 내에서 고유해야AWS 계정 합니다.

HTTP 상태 코드: 400

InternalFailureException

에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

ListVocabularyFilters

StartMedicalTranscriptionJob