本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateCallAnalyticsCategory
并非所有区域都支持呼叫分析。
创建新的呼叫分析类别。
所有类别都将自动应用于您的呼叫分析作业。请注意，为了将您的类别应用于您的工作，您必须在提交工作请求之前创建类别，因为类别不能追溯应用。
呼叫分析类别由规则组成。对于每个类别，必须创建 1 到 20 个规则。规则可以包括以下参数：InterruptionFilter、NonTalkTimeFilter、SentimentFilter, 和TranscriptFilter.
更新现有类别，请参阅UpdateCallAnalyticsCategory.
了解有关的更多信息：
-
呼叫分析类别，请参阅创建类别
-
致电分析，请参阅使用呼叫分析分析呼叫中心音频
请求语法
{
"CategoryName": "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._-]+必需：是
- Rules
-
规则定义了 “呼叫分析” 类别。创建新的呼叫分析类别时，必须为该类别创建 1 到 20 条规则。对于每个规则，您可以指定一个应用于呼叫属性的筛选条件。例如，您可以选择一个情绪过滤器，用于检测客户在通话的最后 30 秒内是否为正面情绪。
类型: 数组Rule对象
数组成员：最少 1 项。最多 20 项。
必需：是
响应语法
{
"CategoryProperties": {
"CategoryName": "string",
"CreateTime": number,
"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)。有关更多信息，请参阅异常消息字段。HTP 状态代码：400
- ConflictException
-
已存在具有此名称的资源。资源名称必须唯一Amazon Web Services 账户.
HTP 状态代码：400
- InternalFailureException
-
发生内部服务器错误。检查错误消息并更正问题，然后重试请求。
HTP 状态代码：500
- LimitExceededException
-
您已经发送过多的请求或您的输入文件太长。等待，然后再重试请求，或使用较小的文件，然后重试请求。
HTP 状态代码：400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：