本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateCallAnalyticsCategory
注意
并非所有地区都支持呼叫分析。
创建新的呼叫分析类别。
所有类别都会自动应用于您的呼叫分析转录。请注意，为了将类别应用于您的转录，您必须在提交转录请求之前创建类别，因为类别不能追溯应用。
创建新类别时，您可以使用InputType参数将该类别标记为POST_CALL或REAL_TIME类别。 POST_CALL类别只能应用于通话后转录，REAL_TIME类别只能应用于实时转录。如果您不包括InputType，则默认情况下，您的类别将创建为一个POST_CALL类别。
呼叫分析类别由规则组成。对于每个类别，您必须创建 1 到 20 条规则。规则可以包括以下参数：InterruptionFilterNonTalkTimeFilter、SentimentFilter、和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
-
您为呼叫分析类别选择的唯一名称。使用将来对你有意义的详细命名系统会很有帮助。例如，最好使用
sentiment-positive-last30seconds类别而不是像这样的通用名称test-category。类别名称区分大小写。
类型：字符串
长度限制：最小长度为 1。最大长度为 200。
模式：
^[0-9a-zA-Z._-]+必需：是
- InputType
-
选择要为呼叫分析转录创建实时类别还是通话后类别。
指定会将您的类别
POST_CALL分配给呼叫后转录；具有此输入类型的类别不能应用于流式传输（实时）转录。指定会将您的类别
REAL_TIME分配给流媒体转录；具有此输入类型的类别不能应用于通话后转录。如果您不包括
InputType，则默认情况下，您的类别将创建为通话后类别。类型：字符串
有效值:
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
-
使用此名称的资源已经存在。中的资源名称必须唯一Amazon Web Services 账户。
HTTP 状态代码：400
- InternalFailureException
-
遇到了内部错误。检查错误消息、更正问题，然后重试请求。
HTTP 状态代码：500
- LimitExceededException
-
你要么发送了太多的请求，要么你的输入文件太长。请稍候，然后重试您的请求，或者使用较小的文件重试您的请求。
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：