CreateCallAnalyticsCategory - Transcribe
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateCallAnalyticsCategory

Erstellt eine neue Call Analytics-Kategorie.

Alle Kategorien werden automatisch auf Ihre Call Analytics-Transkriptionen angewendet. Beachten Sie, dass Sie, um Kategorien auf Ihre Transkriptionen anzuwenden, diese erstellen müssen, bevor Sie Ihre Transkriptionsanfrage einreichen, da Kategorien nicht rückwirkend angewendet werden können.

Wenn Sie eine neue Kategorie erstellen, können Sie denInputType Parameter verwenden, um die Kategorie als KategoriePOST_CALL oder alsREAL_TIME Kategorie zu kennzeichnen. POST_CALLKategorien können nur auf Transkriptionen nach einem Anruf angewendet werden undREAL_TIME Kategorien können nur auf Transkriptionen in Echtzeit angewendet werden. Wenn Sie dies nicht angebenInputType, wird Ihre Kategorie standardmäßig alsPOST_CALL Kategorie erstellt.

Die Kategorien von Call Analytics bestehen aus Regeln. Für jede Kategorie müssen Sie zwischen 1 und 20 Regeln erstellen. Regeln können die folgenden Parameter enthalten:InterruptionFilterNonTalkTimeFilter,SentimentFilter, undTranscriptFilter.

Informationen zum Aktualisieren einer vorhandenen Kategorie finden Sie unterUpdateCallAnalyticsCategory.

Weitere Informationen zu Call Analytics-Kategorien finden Sie unter Kategorien für Transkriptionen nach einem Anruf erstellen und Kategorien für Echtzeit-Transkriptionen erstellen.

Anforderungssyntax

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

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

CategoryName

Ein von Ihnen ausgewählter eindeutiger Name für Ihre Call Analytics-Kategorie. Es ist hilfreich, ein detailliertes Benennungssystem zu verwenden, das für Sie in future sinnvoll sein wird. Zum Beispiel ist es besser, ihnsentiment-positive-last30seconds für eine Kategorie als einen generischen Namen wie zu verwendentest-category.

Bei Namen von Kategorien wird zwischen Groß- und Kleinschreibung unterschieden.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

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

Erforderlich: Ja

InputType

Wählen Sie aus, ob Sie eine Echtzeit- oder eine Kategorie nach dem Anruf für Ihre Call Analytics-Transkription erstellen möchten.

Wenn Sie angeben,POST_CALL wird Ihre Kategorie Transkriptionen nach einem Anruf zugewiesen. Kategorien mit diesem Eingabetyp können nicht auf Streaming-Transkriptionen (Echtzeit) angewendet werden.

Durch die AngabeREAL_TIME wird Ihre Kategorie Streaming-Transkriptionen zugewiesen. Kategorien mit diesem Eingabetyp können nicht auf Transkriptionen nach einem Anruf angewendet werden.

Wenn Sie dies nicht angebenInputType, wird Ihre Kategorie standardmäßig als Kategorie nach dem Anruf erstellt.

Typ: Zeichenfolge

Zulässige Werte: REAL_TIME | POST_CALL

Required: No

Rules

Regeln definieren eine Call Analytics-Kategorie. Wenn Sie eine neue Kategorie erstellen, müssen Sie zwischen 1 und 20 Regeln für diese Kategorie erstellen. Für jede Regel geben Sie einen Filter an, der auf die Attribute eines Anrufs angewendet werden soll. Sie können beispielsweise einen Stimmungsfilter wählen, der erkennt, ob die Stimmung eines Kunden in den letzten 30 Sekunden des Anrufs positiv war.

Typ: Array von Rule-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.

Erforderlich: Ja

Antwortsyntax

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

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

CategoryProperties

Stellt Ihnen die Eigenschaften Ihrer neuen Kategorie zur Verfügung, einschließlich der zugehörigen Regeln.

Typ: CategoryProperties Objekt

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

BadRequestException

Ihre Anfrage hat einen oder mehrere Validierungstests nicht bestanden. Dies kann vorkommen, wenn die Entität, die Sie löschen möchten, nicht existiert oder wenn sie sich in einem nicht terminalen Zustand befindet (z. B.IN PROGRESS). Weitere Informationen finden Sie im Feld für die Ausnahmemeldung.

HTTP Status Code: 400

ConflictException

Eine Ressource mit diesem Namen ist bereits vorhanden. Ressourcennamen müssen innerhalb eines ---Objekts eindeutig seinAWS-Konto.

HTTP Status Code: 400

InternalFailureException

Es ist ein interner Fehler aufgetreten. Überprüfen Sie die Fehlermeldung, korrigieren Sie das Problem und versuchen Sie Ihre Anfrage erneut.

HTTP Status Code: 500

LimitExceededException

Sie haben entweder zu viele Anfragen gesendet oder Ihre Eingabedatei ist zu lang. Warten Sie, bevor Sie Ihre Anfrage erneut versuchen, oder verwenden Sie eine kleinere Datei und versuchen Sie es erneut.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: