本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateCallAnalyticsCategory
建立新的通話分析類別。
所有類別都會自動套用至您的通話分析記錄。請注意，若要將類別套用至您的轉錄，您必須在提交轉錄要求之前先建立類別，因為類別無法追溯套用。
建立新品類時，您可以使用InputType參數將品類標示為品類POST_CALL或REAL_TIME品類。 POST_CALL類別只能套用至通話後轉錄，而REAL_TIME類別只能套用至即時轉錄。如果未包含InputType，則依預設，您的類別會建立為POST_CALL類別。
通話分析類別由規則組成。您必須為每個類別建立 1 到 20 個規則。規則可以包括以下參數：InterruptionFilterNonTalkTimeFilterSentimentFilter、、和TranscriptFilter。
若要更新既有品類，請參閱UpdateCallAnalyticsCategory。
若要深入瞭解通話分析類別，請參閱建立通話後轉譯的類別和建立即時轉錄的類別。
請求語法
{
"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
-
選擇要為通話分析轉錄建立即時或通話後類別。
POST_CALL指定您的類別會將類別指派給通話後轉譯；具有此輸入類型的類別無法套用至串流 (即時) 轉錄。REAL_TIME指定將類別指派給串流轉錄；具有此輸入類型的類別無法套用至通話後轉譯。如果不包含
InputType，則依預設，您的類別會建立為通話後類別。類型：String
有效值：
REAL_TIME | POST_CALL必要：否
- 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
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
