CreateCallAnalyticsCategory - Transcribe
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CreateCallAnalyticsCategory

Crea una nuova categoria Call Analytics.

Tutte le categorie vengono applicate automaticamente alle trascrizioni di Call Analytics. Tieni presente che per applicare le categorie alle tue trascrizioni, devi crearle prima di inviare la richiesta di trascrizione, poiché le categorie non possono essere applicate retroattivamente.

Quando si crea una nuova categoria, è possibile utilizzare ilInputType parametro per etichettare la categoria come unaPOST_CALL o unaREAL_TIME categoria. POST_CALLle categorie possono essere applicate solo alle trascrizioni post-chiamata e leREAL_TIME categorie possono essere applicate solo alle trascrizioni in tempo reale. Se non lo includiInputType, la tua categoria viene creata comePOST_CALL categoria per impostazione predefinita.

Le categorie di Call Analytics sono composte da regole. Per ogni categoria, devi creare da 1 a 20 regole. Le regole possono includere i seguenti parametri:InterruptionFilterNonTalkTimeFilter,SentimentFilter, eTranscriptFilter.

Per aggiornare una categoria esistente, consultaUpdateCallAnalyticsCategory.

Per ulteriori informazioni sulle categorie di Call Analytics, vedi Creazione di categorie per le trascrizioni post-chiamata e Creazione di categorie per le trascrizioni in tempo reale.

Sintassi della richiesta

{
   "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"
         }
      }
   ]
}

Parametri della richiesta

Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

CategoryName

Un nome univoco, scelto da te, per la tua categoria Call Analytics. È utile utilizzare un sistema di denominazione dettagliato che abbia senso per te in future. Ad esempio, è meglio usaresentiment-positive-last30seconds per una categoria piuttosto che un nome generico cometest-category.

I nomi delle categorie

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.

Pattern: ^[0-9a-zA-Z._-]+

Campo obbligatorio: sì

InputType

Scegli se vuoi creare una categoria in tempo reale o post-chiamata per la trascrizione di Call Analytics.

LaPOST_CALL specificazione assegna la categoria alle trascrizioni post-chiamata; le categorie con questo tipo di input non possono essere applicate alle trascrizioni in streaming (in tempo reale).

LaREAL_TIME specificazione assegna la categoria alle trascrizioni in streaming; le categorie con questo tipo di input non possono essere applicate alle trascrizioni post-chiamata.

Se non lo includiInputType, la tua categoria viene creata come categoria post-chiamata per impostazione predefinita.

Tipo: String

Valori validi: REAL_TIME | POST_CALL

Required: No

Rules

Le regole definiscono una categoria di Call Analytics. Quando si crea una nuova categoria, è necessario creare tra 1 e 20 regole per quella categoria. Per ogni regola puoi specificare un filtro tramite cui applicare gli attributi di una chiamata. Ad esempio, puoi scegliere un filtro che rilevi se il sentiment di un cliente è stato positivo negli ultimi 30 secondi della chiamata.

Tipo: matrice di oggetti Rule

Membri dell’array: numero minimo di 1 elemento. Numero massimo di 20 elementi.

Campo obbligatorio: sì

Sintassi della risposta

{
   "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"
            }
         }
      ]
   }
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

CategoryProperties

Fornisce le proprietà della nuova categoria, comprese le regole associate.

Tipo: CategoryProperties oggetto

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

BadRequestException

La tua richiesta non ha superato uno o più test di convalida. Ciò può verificarsi quando l'entità che stai cercando di eliminare non esiste o se si trova in uno stato non terminale (ad esempioIN PROGRESS). Per ulteriori informazioni, consulta il campo del messaggio di eccezione.

Codice di stato HTTP: 400

ConflictException

Esiste già una risorsa con questo nome. I nomi delle risorse devono essere univoci nell'Account AWS.

Codice di stato HTTP: 400

InternalFailureException

Si è verificato un errore Controlla il messaggio di errore

Codice di stato HTTP: 500

LimitExceededException

Hai inviato troppe richieste o il file di input è troppo lungo. Attendi prima di riprovare la richiesta oppure utilizza un file più piccolo e riprova la richiesta.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: