amazonka-transcribe-2.0: Amazon Transcribe Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.Transcribe.CreateCallAnalyticsCategory

Description

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.

Synopsis

Creating a Request

data CreateCallAnalyticsCategory Source #

See: newCreateCallAnalyticsCategory smart constructor.

Constructors

CreateCallAnalyticsCategory' 

Fields

  • inputType :: Maybe InputType

    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.

  • categoryName :: Text

    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.

  • rules :: NonEmpty Rule

    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.

Instances

Instances details
ToJSON CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

ToHeaders CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

ToPath CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

ToQuery CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

AWSRequest CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Generic CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Associated Types

type Rep CreateCallAnalyticsCategory :: Type -> Type #

Read CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Show CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

NFData CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Eq CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Hashable CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

type AWSResponse CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

type Rep CreateCallAnalyticsCategory Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

type Rep CreateCallAnalyticsCategory = D1 ('MetaData "CreateCallAnalyticsCategory" "Amazonka.Transcribe.CreateCallAnalyticsCategory" "amazonka-transcribe-2.0-4BjJqzwmm0K94bsEMe1tnF" 'False) (C1 ('MetaCons "CreateCallAnalyticsCategory'" 'PrefixI 'True) (S1 ('MetaSel ('Just "inputType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe InputType)) :*: (S1 ('MetaSel ('Just "categoryName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "rules") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (NonEmpty Rule)))))

newCreateCallAnalyticsCategory Source #

Create a value of CreateCallAnalyticsCategory with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

CreateCallAnalyticsCategory, createCallAnalyticsCategory_inputType - 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.

CreateCallAnalyticsCategory, createCallAnalyticsCategory_categoryName - 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.

CreateCallAnalyticsCategory, createCallAnalyticsCategory_rules - 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.

Request Lenses

createCallAnalyticsCategory_inputType :: Lens' CreateCallAnalyticsCategory (Maybe InputType) Source #

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.

createCallAnalyticsCategory_categoryName :: Lens' CreateCallAnalyticsCategory Text Source #

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.

createCallAnalyticsCategory_rules :: Lens' CreateCallAnalyticsCategory (NonEmpty Rule) Source #

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.

Destructuring the Response

data CreateCallAnalyticsCategoryResponse Source #

Constructors

CreateCallAnalyticsCategoryResponse' 

Fields

Instances

Instances details
Generic CreateCallAnalyticsCategoryResponse Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Read CreateCallAnalyticsCategoryResponse Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Show CreateCallAnalyticsCategoryResponse Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

NFData CreateCallAnalyticsCategoryResponse Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

Eq CreateCallAnalyticsCategoryResponse Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

type Rep CreateCallAnalyticsCategoryResponse Source # 
Instance details

Defined in Amazonka.Transcribe.CreateCallAnalyticsCategory

type Rep CreateCallAnalyticsCategoryResponse = D1 ('MetaData "CreateCallAnalyticsCategoryResponse" "Amazonka.Transcribe.CreateCallAnalyticsCategory" "amazonka-transcribe-2.0-4BjJqzwmm0K94bsEMe1tnF" 'False) (C1 ('MetaCons "CreateCallAnalyticsCategoryResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "categoryProperties") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe CategoryProperties)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateCallAnalyticsCategoryResponse Source #

Create a value of CreateCallAnalyticsCategoryResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:categoryProperties:CreateCallAnalyticsCategoryResponse', createCallAnalyticsCategoryResponse_categoryProperties - Provides you with the properties of your new category, including its associated rules.

$sel:httpStatus:CreateCallAnalyticsCategoryResponse', createCallAnalyticsCategoryResponse_httpStatus - The response's http status code.

Response Lenses

createCallAnalyticsCategoryResponse_categoryProperties :: Lens' CreateCallAnalyticsCategoryResponse (Maybe CategoryProperties) Source #

Provides you with the properties of your new category, including its associated rules.