2022/11/28 - Amazon Transcribe Service - 4 updated api methods
Changes This release adds support for 'inputType' for post-call and real-time (streaming) Call Analytics within Amazon Transcribe.
{'InputType': 'REAL_TIME | POST_CALL'}
Response {'CategoryProperties': {'InputType': 'REAL_TIME | POST_CALL'}}
Creates a new Call Analytics category.
All categories are automatically applied to your Call Analytics transcriptions. Note that in order to apply categories to your transcriptions, you must create them before submitting your transcription request, as categories cannot be applied retroactively.
When creating a new category, you can use the InputType parameter to label the category as a batch category ( POST_CALL) or a streaming category ( REAL_TIME). Batch categories can only be applied to batch transcriptions and streaming categories can only be applied to streaming transcriptions. If you do not include InputType, your category is created as a batch category by default.
Call Analytics categories are composed of rules. For each category, you must create between 1 and 20 rules. Rules can include these parameters: , , , and .
To update an existing category, see .
To learn more about Call Analytics categories, see Creating categories for batch transcriptions and Creating categories for streaming transcriptions.
See also: AWS API Documentation
Request Syntax
client.create_call_analytics_category(
CategoryName='string',
Rules=[
{
'NonTalkTimeFilter': {
'Threshold': 123,
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'InterruptionFilter': {
'Threshold': 123,
'ParticipantRole': 'AGENT'|'CUSTOMER',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'TranscriptFilter': {
'TranscriptFilterType': 'EXACT',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False,
'Targets': [
'string',
]
},
'SentimentFilter': {
'Sentiments': [
'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
],
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False
}
},
],
InputType='REAL_TIME'|'POST_CALL'
)
string
[REQUIRED]
A unique name, chosen by you, for your Call Analytics category. It's helpful to use a detailed naming system that will make sense to you in the future. For example, it's better to use sentiment-positive-last30seconds for a category over a generic name like test-category.
Category names are case sensitive.
list
[REQUIRED]
Rules define a Call Analytics category. When creating a new category, you must create between 1 and 20 rules for that category. For each rule, you specify a filter you want applied to the attributes of a call. For example, you can choose a sentiment filter that detects if a customer's sentiment was positive during the last 30 seconds of the call.
(dict) --
A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.
Rules can include these parameters: , , , and .
To learn more about Call Analytics rules and categories, see Creating categories for batch transcriptions and Creating categories for streaming transcriptions.
To learn more about Call Analytics, see Analyzing call center audio with Call Analytics.
NonTalkTimeFilter (dict) --
Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag periods of speech. Set to FALSE to flag periods of silence
InterruptionFilter (dict) --
Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.
ParticipantRole (string) --
Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag speech that does not contain interruptions. Set to FALSE to flag speech that contains interruptions.
TranscriptFilter (dict) --
Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.
TranscriptFilterType (string) -- [REQUIRED]
Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your Targets value, only that exact phrase is flagged.
Note that semantic matching is not supported. For example, if your customer says "speak to the manager", instead of "speak to a manager", your content is not flagged.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the absence of the phrase that you specified in your request. Set to FALSE to flag the presence of the phrase that you specified in your request.
Targets (list) -- [REQUIRED]
Specify the phrases that you want to flag.
(string) --
SentimentFilter (dict) --
Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.
Sentiments (list) -- [REQUIRED]
Specify the sentiments that you want to flag.
(string) --
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the sentiments that you didn't include in your request. Set to FALSE to flag the sentiments that you specified in your request.
string
Choose whether you want to create a streaming or a batch category for your Call Analytics transcription.
Specifying POST_CALL assigns your category to batch transcriptions; categories with this input type cannot be applied to streaming (real-time) transcriptions.
Specifying REAL_TIME assigns your category to streaming transcriptions; categories with this input type cannot be applied to batch (post-call) transcriptions.
If you do not include InputType, your category is created as a batch category by default.
dict
Response Syntax
{
'CategoryProperties': {
'CategoryName': 'string',
'Rules': [
{
'NonTalkTimeFilter': {
'Threshold': 123,
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'InterruptionFilter': {
'Threshold': 123,
'ParticipantRole': 'AGENT'|'CUSTOMER',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'TranscriptFilter': {
'TranscriptFilterType': 'EXACT',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False,
'Targets': [
'string',
]
},
'SentimentFilter': {
'Sentiments': [
'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
],
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False
}
},
],
'CreateTime': datetime(2015, 1, 1),
'LastUpdateTime': datetime(2015, 1, 1),
'InputType': 'REAL_TIME'|'POST_CALL'
}
}
Response Structure
(dict) --
CategoryProperties (dict) --
Provides you with the properties of your new category, including its associated rules.
CategoryName (string) --
The name of the Call Analytics category. Category names are case sensitive and must be unique within an Amazon Web Services account.
Rules (list) --
The rules used to define a Call Analytics category. Each category can have between 1 and 20 rules.
(dict) --
A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.
Rules can include these parameters: , , , and .
To learn more about Call Analytics rules and categories, see Creating categories for batch transcriptions and Creating categories for streaming transcriptions.
To learn more about Call Analytics, see Analyzing call center audio with Call Analytics.
NonTalkTimeFilter (dict) --
Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag periods of speech. Set to FALSE to flag periods of silence
InterruptionFilter (dict) --
Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.
ParticipantRole (string) --
Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag speech that does not contain interruptions. Set to FALSE to flag speech that contains interruptions.
TranscriptFilter (dict) --
Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.
TranscriptFilterType (string) --
Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your Targets value, only that exact phrase is flagged.
Note that semantic matching is not supported. For example, if your customer says "speak to the manager", instead of "speak to a manager", your content is not flagged.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the absence of the phrase that you specified in your request. Set to FALSE to flag the presence of the phrase that you specified in your request.
Targets (list) --
Specify the phrases that you want to flag.
(string) --
SentimentFilter (dict) --
Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.
Sentiments (list) --
Specify the sentiments that you want to flag.
(string) --
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the sentiments that you didn't include in your request. Set to FALSE to flag the sentiments that you specified in your request.
CreateTime (datetime) --
The date and time the specified Call Analytics category was created.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-04T12:32:58.761000-07:00 represents 12:32 PM UTC-7 on May 4, 2022.
LastUpdateTime (datetime) --
The date and time the specified Call Analytics category was last updated.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-05T12:45:32.691000-07:00 represents 12:45 PM UTC-7 on May 5, 2022.
InputType (string) --
The input type associated with the specified category. POST_CALL refers to a category that is applied to batch transcriptions; REAL_TIME refers to a category that is applied to streaming transcriptions.
{'CategoryProperties': {'InputType': 'REAL_TIME | POST_CALL'}}
Provides information about the specified Call Analytics category.
To get a list of your Call Analytics categories, use the operation.
See also: AWS API Documentation
Request Syntax
client.get_call_analytics_category(
CategoryName='string'
)
string
[REQUIRED]
The name of the Call Analytics category you want information about. Category names are case sensitive.
dict
Response Syntax
{
'CategoryProperties': {
'CategoryName': 'string',
'Rules': [
{
'NonTalkTimeFilter': {
'Threshold': 123,
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'InterruptionFilter': {
'Threshold': 123,
'ParticipantRole': 'AGENT'|'CUSTOMER',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'TranscriptFilter': {
'TranscriptFilterType': 'EXACT',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False,
'Targets': [
'string',
]
},
'SentimentFilter': {
'Sentiments': [
'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
],
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False
}
},
],
'CreateTime': datetime(2015, 1, 1),
'LastUpdateTime': datetime(2015, 1, 1),
'InputType': 'REAL_TIME'|'POST_CALL'
}
}
Response Structure
(dict) --
CategoryProperties (dict) --
Provides you with the properties of the Call Analytics category you specified in your GetCallAnalyticsCategory request.
CategoryName (string) --
The name of the Call Analytics category. Category names are case sensitive and must be unique within an Amazon Web Services account.
Rules (list) --
The rules used to define a Call Analytics category. Each category can have between 1 and 20 rules.
(dict) --
A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.
Rules can include these parameters: , , , and .
To learn more about Call Analytics rules and categories, see Creating categories for batch transcriptions and Creating categories for streaming transcriptions.
To learn more about Call Analytics, see Analyzing call center audio with Call Analytics.
NonTalkTimeFilter (dict) --
Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag periods of speech. Set to FALSE to flag periods of silence
InterruptionFilter (dict) --
Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.
ParticipantRole (string) --
Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag speech that does not contain interruptions. Set to FALSE to flag speech that contains interruptions.
TranscriptFilter (dict) --
Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.
TranscriptFilterType (string) --
Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your Targets value, only that exact phrase is flagged.
Note that semantic matching is not supported. For example, if your customer says "speak to the manager", instead of "speak to a manager", your content is not flagged.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the absence of the phrase that you specified in your request. Set to FALSE to flag the presence of the phrase that you specified in your request.
Targets (list) --
Specify the phrases that you want to flag.
(string) --
SentimentFilter (dict) --
Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.
Sentiments (list) --
Specify the sentiments that you want to flag.
(string) --
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the sentiments that you didn't include in your request. Set to FALSE to flag the sentiments that you specified in your request.
CreateTime (datetime) --
The date and time the specified Call Analytics category was created.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-04T12:32:58.761000-07:00 represents 12:32 PM UTC-7 on May 4, 2022.
LastUpdateTime (datetime) --
The date and time the specified Call Analytics category was last updated.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-05T12:45:32.691000-07:00 represents 12:45 PM UTC-7 on May 5, 2022.
InputType (string) --
The input type associated with the specified category. POST_CALL refers to a category that is applied to batch transcriptions; REAL_TIME refers to a category that is applied to streaming transcriptions.
{'Categories': {'InputType': 'REAL_TIME | POST_CALL'}}
Provides a list of Call Analytics categories, including all rules that make up each category.
To get detailed information about a specific Call Analytics category, use the operation.
See also: AWS API Documentation
Request Syntax
client.list_call_analytics_categories(
NextToken='string',
MaxResults=123
)
string
If your ListCallAnalyticsCategories request returns more results than can be displayed, NextToken is displayed in the response with an associated string. To get the next page of results, copy this string and repeat your request, including NextToken with the value of the copied string. Repeat as needed to view all your results.
integer
The maximum number of Call Analytics categories to return in each page of results. If there are fewer results than the value that you specify, only the actual results are returned. If you don't specify a value, a default of 5 is used.
dict
Response Syntax
{
'NextToken': 'string',
'Categories': [
{
'CategoryName': 'string',
'Rules': [
{
'NonTalkTimeFilter': {
'Threshold': 123,
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'InterruptionFilter': {
'Threshold': 123,
'ParticipantRole': 'AGENT'|'CUSTOMER',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'TranscriptFilter': {
'TranscriptFilterType': 'EXACT',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False,
'Targets': [
'string',
]
},
'SentimentFilter': {
'Sentiments': [
'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
],
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False
}
},
],
'CreateTime': datetime(2015, 1, 1),
'LastUpdateTime': datetime(2015, 1, 1),
'InputType': 'REAL_TIME'|'POST_CALL'
},
]
}
Response Structure
(dict) --
NextToken (string) --
If NextToken is present in your response, it indicates that not all results are displayed. To view the next set of results, copy the string associated with the NextToken parameter in your results output, then run your request again including NextToken with the value of the copied string. Repeat as needed to view all your results.
Categories (list) --
Provides detailed information about your Call Analytics categories, including all the rules associated with each category.
(dict) --
Provides you with the properties of the Call Analytics category you specified in your request. This includes the list of rules that define the specified category.
CategoryName (string) --
The name of the Call Analytics category. Category names are case sensitive and must be unique within an Amazon Web Services account.
Rules (list) --
The rules used to define a Call Analytics category. Each category can have between 1 and 20 rules.
(dict) --
A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.
Rules can include these parameters: , , , and .
To learn more about Call Analytics rules and categories, see Creating categories for batch transcriptions and Creating categories for streaming transcriptions.
To learn more about Call Analytics, see Analyzing call center audio with Call Analytics.
NonTalkTimeFilter (dict) --
Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag periods of speech. Set to FALSE to flag periods of silence
InterruptionFilter (dict) --
Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.
ParticipantRole (string) --
Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag speech that does not contain interruptions. Set to FALSE to flag speech that contains interruptions.
TranscriptFilter (dict) --
Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.
TranscriptFilterType (string) --
Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your Targets value, only that exact phrase is flagged.
Note that semantic matching is not supported. For example, if your customer says "speak to the manager", instead of "speak to a manager", your content is not flagged.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the absence of the phrase that you specified in your request. Set to FALSE to flag the presence of the phrase that you specified in your request.
Targets (list) --
Specify the phrases that you want to flag.
(string) --
SentimentFilter (dict) --
Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.
Sentiments (list) --
Specify the sentiments that you want to flag.
(string) --
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the sentiments that you didn't include in your request. Set to FALSE to flag the sentiments that you specified in your request.
CreateTime (datetime) --
The date and time the specified Call Analytics category was created.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-04T12:32:58.761000-07:00 represents 12:32 PM UTC-7 on May 4, 2022.
LastUpdateTime (datetime) --
The date and time the specified Call Analytics category was last updated.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-05T12:45:32.691000-07:00 represents 12:45 PM UTC-7 on May 5, 2022.
InputType (string) --
The input type associated with the specified category. POST_CALL refers to a category that is applied to batch transcriptions; REAL_TIME refers to a category that is applied to streaming transcriptions.
{'InputType': 'REAL_TIME | POST_CALL'}
Response {'CategoryProperties': {'InputType': 'REAL_TIME | POST_CALL'}}
Updates the specified Call Analytics category with new rules. Note that the UpdateCallAnalyticsCategory operation overwrites all existing rules contained in the specified category. You cannot append additional rules onto an existing category.
To create a new category, see .
See also: AWS API Documentation
Request Syntax
client.update_call_analytics_category(
CategoryName='string',
Rules=[
{
'NonTalkTimeFilter': {
'Threshold': 123,
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'InterruptionFilter': {
'Threshold': 123,
'ParticipantRole': 'AGENT'|'CUSTOMER',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'TranscriptFilter': {
'TranscriptFilterType': 'EXACT',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False,
'Targets': [
'string',
]
},
'SentimentFilter': {
'Sentiments': [
'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
],
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False
}
},
],
InputType='REAL_TIME'|'POST_CALL'
)
string
[REQUIRED]
The name of the Call Analytics category you want to update. Category names are case sensitive.
list
[REQUIRED]
The rules used for the updated Call Analytics category. The rules you provide in this field replace the ones that are currently being used in the specified category.
(dict) --
A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.
Rules can include these parameters: , , , and .
To learn more about Call Analytics rules and categories, see Creating categories for batch transcriptions and Creating categories for streaming transcriptions.
To learn more about Call Analytics, see Analyzing call center audio with Call Analytics.
NonTalkTimeFilter (dict) --
Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag periods of speech. Set to FALSE to flag periods of silence
InterruptionFilter (dict) --
Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.
ParticipantRole (string) --
Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag speech that does not contain interruptions. Set to FALSE to flag speech that contains interruptions.
TranscriptFilter (dict) --
Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.
TranscriptFilterType (string) -- [REQUIRED]
Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your Targets value, only that exact phrase is flagged.
Note that semantic matching is not supported. For example, if your customer says "speak to the manager", instead of "speak to a manager", your content is not flagged.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the absence of the phrase that you specified in your request. Set to FALSE to flag the presence of the phrase that you specified in your request.
Targets (list) -- [REQUIRED]
Specify the phrases that you want to flag.
(string) --
SentimentFilter (dict) --
Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.
Sentiments (list) -- [REQUIRED]
Specify the sentiments that you want to flag.
(string) --
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the sentiments that you didn't include in your request. Set to FALSE to flag the sentiments that you specified in your request.
string
Choose whether you want to update a streaming or a batch Call Analytics category. The input type you specify must match the input type specified when the category was created. For example, if you created a category with the POST_CALL input type, you must use POST_CALL as the input type when updating this category.
dict
Response Syntax
{
'CategoryProperties': {
'CategoryName': 'string',
'Rules': [
{
'NonTalkTimeFilter': {
'Threshold': 123,
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'InterruptionFilter': {
'Threshold': 123,
'ParticipantRole': 'AGENT'|'CUSTOMER',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'Negate': True|False
},
'TranscriptFilter': {
'TranscriptFilterType': 'EXACT',
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False,
'Targets': [
'string',
]
},
'SentimentFilter': {
'Sentiments': [
'POSITIVE'|'NEGATIVE'|'NEUTRAL'|'MIXED',
],
'AbsoluteTimeRange': {
'StartTime': 123,
'EndTime': 123,
'First': 123,
'Last': 123
},
'RelativeTimeRange': {
'StartPercentage': 123,
'EndPercentage': 123,
'First': 123,
'Last': 123
},
'ParticipantRole': 'AGENT'|'CUSTOMER',
'Negate': True|False
}
},
],
'CreateTime': datetime(2015, 1, 1),
'LastUpdateTime': datetime(2015, 1, 1),
'InputType': 'REAL_TIME'|'POST_CALL'
}
}
Response Structure
(dict) --
CategoryProperties (dict) --
Provides you with the properties of the Call Analytics category you specified in your UpdateCallAnalyticsCategory request.
CategoryName (string) --
The name of the Call Analytics category. Category names are case sensitive and must be unique within an Amazon Web Services account.
Rules (list) --
The rules used to define a Call Analytics category. Each category can have between 1 and 20 rules.
(dict) --
A rule is a set of criteria that you can specify to flag an attribute in your Call Analytics output. Rules define a Call Analytics category.
Rules can include these parameters: , , , and .
To learn more about Call Analytics rules and categories, see Creating categories for batch transcriptions and Creating categories for streaming transcriptions.
To learn more about Call Analytics, see Analyzing call center audio with Call Analytics.
NonTalkTimeFilter (dict) --
Flag the presence or absence of periods of silence in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration, in milliseconds, of the period of silence that you want to flag. For example, you can flag a silent period that lasts 30,000 milliseconds.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for a period of silence. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for a period of silence. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag periods of speech. Set to FALSE to flag periods of silence
InterruptionFilter (dict) --
Flag the presence or absence of interruptions in your Call Analytics transcription output. Refer to for more detail.
Threshold (integer) --
Specify the duration of the interruptions in milliseconds. For example, you can flag speech that contains more than 10,000 milliseconds of interruptions.
ParticipantRole (string) --
Specify the interrupter that you want to flag. Omitting this parameter is equivalent to specifying both participants.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for an interruption. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for an interruption. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
Negate (boolean) --
Set to TRUE to flag speech that does not contain interruptions. Set to FALSE to flag speech that contains interruptions.
TranscriptFilter (dict) --
Flag the presence or absence of specific words or phrases in your Call Analytics transcription output. Refer to for more detail.
TranscriptFilterType (string) --
Flag the presence or absence of an exact match to the phrases that you specify. For example, if you specify the phrase "speak to a manager" as your Targets value, only that exact phrase is flagged.
Note that semantic matching is not supported. For example, if your customer says "speak to the manager", instead of "speak to a manager", your content is not flagged.
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified key words or phrases. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified key words or phrases. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the absence of the phrase that you specified in your request. Set to FALSE to flag the presence of the phrase that you specified in your request.
Targets (list) --
Specify the phrases that you want to flag.
(string) --
SentimentFilter (dict) --
Flag the presence or absence of specific sentiments in your Call Analytics transcription output. Refer to for more detail.
Sentiments (list) --
Specify the sentiments that you want to flag.
(string) --
AbsoluteTimeRange (dict) --
Makes it possible to specify a time range (in milliseconds) in your audio, during which you want to search for the specified sentiments. See for more detail.
StartTime (integer) --
The time, in milliseconds, when Amazon Transcribe starts searching for the specified criteria in your audio. If you include StartTime in your request, you must also include EndTime.
EndTime (integer) --
The time, in milliseconds, when Amazon Transcribe stops searching for the specified criteria in your audio. If you include EndTime in your request, you must also include StartTime.
First (integer) --
The time, in milliseconds, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in milliseconds, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
RelativeTimeRange (dict) --
Makes it possible to specify a time range (in percentage) in your media file, during which you want to search for the specified sentiments. See for more detail.
StartPercentage (integer) --
The time, in percentage, when Amazon Transcribe starts searching for the specified criteria in your media file. If you include StartPercentage in your request, you must also include EndPercentage.
EndPercentage (integer) --
The time, in percentage, when Amazon Transcribe stops searching for the specified criteria in your media file. If you include EndPercentage in your request, you must also include StartPercentage.
First (integer) --
The time, in percentage, from the start of your media file until the specified value. Amazon Transcribe searches for your specified criteria in this time segment.
Last (integer) --
The time, in percentage, from the specified value until the end of your media file. Amazon Transcribe searches for your specified criteria in this time segment.
ParticipantRole (string) --
Specify the participant that you want to flag. Omitting this parameter is equivalent to specifying both participants.
Negate (boolean) --
Set to TRUE to flag the sentiments that you didn't include in your request. Set to FALSE to flag the sentiments that you specified in your request.
CreateTime (datetime) --
The date and time the specified Call Analytics category was created.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-04T12:32:58.761000-07:00 represents 12:32 PM UTC-7 on May 4, 2022.
LastUpdateTime (datetime) --
The date and time the specified Call Analytics category was last updated.
Timestamps are in the format YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. For example, 2022-05-05T12:45:32.691000-07:00 represents 12:45 PM UTC-7 on May 5, 2022.
InputType (string) --
The input type associated with the specified category. POST_CALL refers to a category that is applied to batch transcriptions; REAL_TIME refers to a category that is applied to streaming transcriptions.