Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # CreateCallAnalyticsCategory Crea una nueva categoría de análisis de llamadas. Todas las categorías se aplican automáticamente a tus transcripciones de Call Analytics. Tenga en cuenta que para aplicar categorías a sus transcripciones, debe crearlas antes de enviar su solicitud de transcripción, ya que las categorías no se pueden aplicar de forma retroactiva. Al crear una nueva categoría, puede utilizar el`InputType` parámetro para etiquetar la categoría como una categoría`POST_CALL` o una`REAL_TIME` categoría. `POST_CALL`las categorías solo se pueden aplicar a las transcripciones posteriores a la llamada y las`REAL_TIME` categorías solo a las transcripciones en tiempo real. Si no incluyes`InputType`, tu categoría se crea como`POST_CALL` categoría de forma predeterminada. Las categorías de análisis de llamadas se componen de reglas. Para cada categoría, debe crear entre 1 y 20 reglas. Las reglas pueden incluir los siguientes parámetros:[InterruptionFilter](API_InterruptionFilter.md)[NonTalkTimeFilter](API_NonTalkTimeFilter.md),[SentimentFilter](API_SentimentFilter.md), y[TranscriptFilter](API_TranscriptFilter.md). Para actualizar una categoría existente, consulte[UpdateCallAnalyticsCategory](API_UpdateCallAnalyticsCategory.md). Para obtener más información sobre las categorías de análisis de llamadas, consulte [Creación de categorías para transcripciones posteriores a la llamada](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html) y [Creación de categorías para transcripciones en tiempo real](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html). ## Sintaxis de la solicitud ``` { "CategoryName": "string", "InputType": "string", "Rules": [ { "InterruptionFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "NonTalkTimeFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "SentimentFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Sentiments": [ "string" ] }, "TranscriptFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Targets": [ "string" ], "TranscriptFilterType": "string" } } ] } ``` ## Parámetros de solicitud Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [CategoryName](#API_CreateCallAnalyticsCategory_RequestSyntax) ** Un nombre único, elegido por ti, para tu categoría de análisis de llamadas. Es útil utilizar un sistema de nombres detallado que tenga sentido para ti en el future. Por ejemplo, es mejor usarlo`sentiment-positive-last30seconds` para una categoría que para un nombre genérico como`test-category`. Los nombres de categoría distinguen entre mayúsculas y minúsculas. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres. Patrón: `^[0-9a-zA-Z._-]+` Obligatorio: sí ** [InputType](#API_CreateCallAnalyticsCategory_RequestSyntax) ** Elige si quieres crear una categoría en tiempo real o posterior a la llamada para tu transcripción de Call Analytics. Al especificar, se`POST_CALL` asigna la categoría a las transcripciones posteriores a la llamada; las categorías con este tipo de entrada no se pueden aplicar a las transcripciones en streaming (en tiempo real). Al especificar, se`REAL_TIME` asigna una categoría a las transcripciones en streaming; las categorías con este tipo de entrada no se pueden aplicar a las transcripciones posteriores a la llamada. Si no incluyes`InputType`, tu categoría se crea como categoría posterior a la llamada de forma predeterminada. Tipo: cadena Valores válidos:` REAL_TIME | POST_CALL` Obligatorio: no ** [Rules](#API_CreateCallAnalyticsCategory_RequestSyntax) ** Las reglas definen una categoría de análisis de llamadas. Al crear una nueva categoría, debe crear entre 1 y 20 reglas para esa categoría. Para cada regla, se especifica un filtro que se aplica a los atributos de una llamada. Por ejemplo, puedes elegir un filtro de opiniones que detecte si la opinión de un cliente fue positiva durante los últimos 30 segundos de la llamada. Tipo: Matriz de objetos [Rule](API_Rule.md) Miembros de la matriz: número mínimo de 1 elemento. Número máximo de 20 elementos. Obligatorio: sí ## Sintaxis de la respuesta ``` { "CategoryProperties": { "CategoryName": "string", "CreateTime": number, "InputType": "string", "LastUpdateTime": number, "Rules": [ { "InterruptionFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "NonTalkTimeFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "SentimentFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Sentiments": [ "string" ] }, "TranscriptFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Targets": [ "string" ], "TranscriptFilterType": "string" } } ] } } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [CategoryProperties](#API_CreateCallAnalyticsCategory_ResponseSyntax) ** Le proporciona las propiedades de la nueva categoría, incluidas las reglas asociadas. Tipo: objeto [CategoryProperties](API_CategoryProperties.md) ## Errores Para obtener información sobre los errores comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md). ** BadRequestException ** Tu solicitud no ha superado una o más pruebas de validación. Esto puede ocurrir cuando la entidad que intentas eliminar no existe o si se encuentra en un estado no terminal (por ejemplo`IN PROGRESS`). Para obtener más información, consulte el campo mensaje de excepción. Código de estado HTTP: 400 ** ConflictException ** Ya existe un recurso con este nombre. Los nombres de recurso deben ser únicos dentro deCuenta de AWS. Código de estado HTTP: 400 ** InternalFailureException ** Se produjo un error interno. Para comprobar el mensaje de error, se corrige el problema y se vuelve a intentar realizar la solicitud. Código de estado HTTP: 500 ** LimitExceededException ** Has enviado demasiadas solicitudes o tu archivo de entrada es demasiado largo. Espere antes de volver a intentar la solicitud o utilice un archivo más pequeño y vuelva a intentarlo. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)