CreateCallAnalyticsCategory - 변환

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CreateCallAnalyticsCategory

새 통화 분석 범주를 만듭니다.

모든 카테고리는 Call Analytics 트랜스크립션에 자동으로 적용됩니다. 참고로, 카테고리는 소급 적용할 수 없으므로 트랜스크립션 요청을 제출하기 전에 카테고리를 생성해야 합니다.

새 범주를 작성할 때InputType 매개변수를 사용하여 범주에 APOST_CALLREAL_TIME 또는 범주로 레이블을 지정할 수 있습니다. POST_CALL카테고리는 통화 후 트랜스크립션에만 적용할 수 있으며REAL_TIME 카테고리는 실시간 트랜스크립션에만 적용할 수 있습니다. InputType포함하지 않으면 기본적으로 범주가POST_CALL 범주로 생성됩니다.

통화 분석 카테고리는 규칙으로 구성됩니다. 각 범주에 대해 1~20개 사이의 규칙을 만들어야 합니다. 규칙에는InterruptionFilter,NonTalkTimeFilterSentimentFilter, 및 매개 변수가 포함될 수TranscriptFilter 있습니다.

기존 범주를 업데이트하려면 을 참조하십시오UpdateCallAnalyticsCategory.

Call Analytics 카테고리에 대해 자세히 알아보려면 통화 후 트랜스크립션을 위한 카테고리 만들기 및 실시간 트랜스크립션을 위한 카테고리 만들기를 참조하세요.

요청 구문

{ "CategoryName": "string", "InputType": "string", "Rules": [ { "InterruptionFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "NonTalkTimeFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "SentimentFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Sentiments": [ "string" ] }, "TranscriptFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Targets": [ "string" ], "TranscriptFilterType": "string" } } ] }

요청 파라미터

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

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

CategoryName

통화 분석 카테고리에서 사용자가 선택한 고유한 이름입니다. future 이해할 수 있는 상세한 이름 지정 시스템을 사용하는 것이 좋습니다. 예를 들어, 와 같은 일반 이름보다 카테고리에 사용하는sentiment-positive-last30seconds 것이 좋습니다test-category.

범주 이름은 대/소문자를 구분합니다.

유형: String

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

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

필수 항목 여부: 예

InputType

Call Analytics 트랜스크립션에 실시간 또는 통화 후 카테고리를 만들지 여부를 선택하세요.

지정하면 통화 후 트랜스크립션에 카테고리가POST_CALL 할당됩니다. 이 입력 유형의 카테고리는 스트리밍 (실시간) 트랜스크립션에 적용할 수 없습니다.

지정하면 스트리밍 트랜스크립션에 카테고리가REAL_TIME 할당됩니다. 이 입력 유형의 카테고리는 통화 후 트랜스크립션에 적용할 수 없습니다.

InputType포함하지 않으면 기본적으로 카테고리가 통화 후 카테고리로 생성됩니다.

유형: String

유효한 값: REAL_TIME | POST_CALL

Required: No

Rules

규칙은 통화 분석 범주를 정의합니다. 새 범주를 만들 때는 해당 범주에 대해 1~20개 사이의 규칙을 만들어야 합니다. 각 규칙에서 호출 속성에 적용할 필터를 지정합니다. 예를 들어, 통화 마지막 30초 동안 고객의 감정이 긍정적이었는지 감지하는 감정 필터를 선택할 수 있습니다.

유형: Rule 객체 배열

배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.

필수 항목 여부: 예

응답 구문

{ "CategoryProperties": { "CategoryName": "string", "CreateTime": number, "InputType": "string", "LastUpdateTime": number, "Rules": [ { "InterruptionFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "NonTalkTimeFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "SentimentFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Sentiments": [ "string" ] }, "TranscriptFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Targets": [ "string" ], "TranscriptFilterType": "string" } } ] } }

응답 요소

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

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

CategoryProperties

새 카테고리의 속성 (관련 규칙 포함) 을 제공합니다.

유형: CategoryProperties 객체

오류

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

BadRequestException

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

HTTP 상태 코드: 400

ConflictException

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

HTTP 상태 코드: 400

InternalFailureException

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

HTTP 상태 코드: 500

LimitExceededException

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

HTTP 상태 코드: 400

참고 항목

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