CreateCallAnalyticsCategory - Transcribe
Sintaxis de la solicitudParámetros de solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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 elInputType parámetro para etiquetar la categoría como una categoríaPOST_CALL o unaREAL_TIME categoría. POST_CALLlas categorías solo se pueden aplicar a las transcripciones posteriores a la llamada y lasREAL_TIME categorías solo a las transcripciones en tiempo real. Si no incluyesInputType, tu categoría se crea comoPOST_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:InterruptionFilterNonTalkTimeFilter,SentimentFilter, yTranscriptFilter.

Para actualizar una categoría existente, consulteUpdateCallAnalyticsCategory.

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 y Creación de categorías para transcripciones en tiempo real.

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.

La solicitud acepta los siguientes datos en formato JSON.

CategoryName

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 usarlosentiment-positive-last30seconds para una categoría que para un nombre genérico comotest-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

Elige si quieres crear una categoría en tiempo real o posterior a la llamada para tu transcripción de Call Analytics.

Al especificar, sePOST_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, seREAL_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 incluyesInputType, 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

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

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

Le proporciona las propiedades de la nueva categoría, incluidas las reglas asociadas.

Tipo: objeto CategoryProperties

Errores

Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.

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 ejemploIN 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: