기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateCallAnalyticsCategory
새 통화 분석 범주를 만듭니다.
모든 카테고리는 Call Analytics 트랜스크립션에 자동으로 적용됩니다. 참고로, 카테고리는 소급 적용할 수 없으므로 트랜스크립션 요청을 제출하기 전에 카테고리를 생성해야 합니다.
새 범주를 작성할 때InputType
매개변수를 사용하여 범주에 APOST_CALL
REAL_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 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.