Transkriptionen nach dem Anruf

Preisgestaltung

Der Preis für die Transkription, mit oder ohne Zusammenfassung, beträgt $0,04510 / €0,04100 pro Minute, unabhängig von der Anzahl der Teilnehmer. Es fallen nur Gebühren für einzelne Archive an.

Überblick über die Funktionen

Die Transkription von Telefongesprächen kann zu einer verbesserten Aufzeichnung, einem besseren Kundenservice, einer höheren Produktivität und einer besseren Datenanalyse beitragen. Die Video API-Server von Vonage generieren Transkriptionen nach dem Gespräch mithilfe von künstlicher Intelligenz und anderen modernen Technologien.

Sie aktivieren Transkriptionen, wenn Sie ein Archiv über die REST-API starten.

Nach Abschluss der Archivaufzeichnung wird die Transkription als JSON-Datei zur Verfügung stehen.

Aktivieren der Transkription beim Starten eines Archivs

Wenn Sie mit der Vonage Video REST API ein Archiv starten, setzen Sie die hasAudio und hasTranscription Eigenschaften zu true in den JSON-Eigenschaften, die Sie an die Startarchiv-REST-Methode gesendet haben:

Außerdem können Sie eine optionale transcriptionProperties Objekt mit einer hasSummary (boolesch) und/oder primaryLanguageCode (String) Eigenschaften. Bei der Einstellung hasSummary auf true gesetzt, wird eine von der KI erstellte Zusammenfassung in die Transkription aufgenommen. Wenn sie auf false gesetzt ist oder fehlt (Standardwert ist false), wird die Transkriptionszusammenfassung nicht aufgenommen. Wenn die Transkription für eine andere Sprache als "en-US" (Standard) ist, konfigurieren Sie die Eigenschaft primaryLanguageCode mit einer Unterstützter Sprachcode.

Satz outputMode (in den POST-Daten) an "individual". Transkriptionen sind verfügbar für einzelne Stream-Archive nur.

Legen Sie den Wert für application_id auf Ihre Applications-ID. Legen Sie den Wert für json_web_token zu einem JSON-Web-Token (siehe die REST-API-Authentifizierung Dokumentation).

Weitere Archivierungsoptionen finden Sie in der Dokumentation zum Programm Archiv REST-Methode starten.

Die Antwort auf einen Aufruf der REST-Methode start archive enthält hasTranscription und transcription Eigenschaften zusätzlich zu den anderen dokumentierten Eigenschaften der Antwort:

{
  "createdAt" : 1384221730555,
  "duration" : 0,
  "hasAudio" : true,
  "hasVideo" : true,
  "id" : "b40ef09b-3811-4726-b508-e41a0f96c68f",
  "name" : "The archive name you supplied",
  "outputMode" : "individual",
  "applicationId" : "12345abc",
  "reason" : "",
  "resolution" : "640x480",
  "sessionId" : "flR1ZSBPY3QgMjkgMTI6MTM6MjMgUERUIDIwMTN",
  "size" : 0,
  "status" : "started",
  "streamMode" : "auto",
  "hasTranscription" : true,
  "transcription" : {
    "hasSummary": true,
    "primaryLanguageCode": "ja-JP",
    "reason": "",
    "status": "requested",
    "url": ""
  }
}

Siehe Abrufen des Transkriptionsstatus für Informationen zum dynamischen Abrufen der Transkriptionsdetails.

In einem automatisch archivierte Sitzungwird die Transkription nicht automatisch gestartet. Sie sollten ein zweites Archiv starten, indem Sie die multiArchiveTag für die Transkription (siehe Gleichzeitige Archive).

Die Unterstützung für Transkriptionen ist derzeit über die Vonage Video REST API verfügbar und kann über die Vonage Server SDKs aktiviert und verwaltet werden.

Abrufen des Transkriptionsstatus

Die Antwort für die REST-Methoden für Angebotsarchiv und Abrufen von Archivinformationen wird umfassen hasTranscription und transcription Eigenschaften:

{
    "id" : "b40ef09b-3811-4726-b508-e41a0f96c68f",
    "event": "archive",
    "createdAt" : 1723584124,
    "duration" : 328,
    "name" : "the archive name",
    "partnerId" : "123456abc",
    "reason" : "",
    "sessionId" : "2_MX40NzIwMzJ-flR1ZSBPERUIDIwMTN-MC45NDQ2MzE2NH4",
    "size" : 18023312,
    "status" : "uploaded",
    "hasTranscription" : true,
    "transcription": {
      "status": "available",
      "url": "URL for downloading the transcription, if available",
      "reason": "The reason for failure, if status is set to failed",
      "hasSummary": true,
      "primaryLanguageCode": "The configured language code"
    }
}

Die hasTranscription ist eine boolesche Eigenschaft, die angibt, ob die Transkription für das Archiv aktiviert ist.

Die transcription Eigenschaft ein Objekt mit den folgenden Eigenschaften:

• status (String) - Der Status der Transkription, der auf einen der folgenden Werte gesetzt werden kann:

  • "requested" - Die hasTranscription Eigenschaft wurde festgelegt auf true beim Aufruf des Startarchivs, aber die Transkription hat noch nicht begonnen.
  • "failed" - Die Transkription ist fehlgeschlagen. Prüfen Sie die reason Eigenschaft für weitere Informationen.
  • "started" - Die Transkription ist in Arbeit.
  • "available" - Die Transkription steht bei Vonage zum Download bereit. Prüfen Sie die url Eigentum.
  • "uploaded" - Die Transkription steht in dem S3-Bucket oder Azure-Container, den Sie in Ihrem Video API Account angegeben haben, zum Download bereit. Suchen Sie im Archiv-ID-Ordner in Ihrem Archivspeicherziel nach einer transcription.zip. Siehe Archivierung.

• url (String) - Die URL zum Herunterladen der Transkription, wenn die status wird eingestellt auf "available".

• reason (String) - Der Grund für das Scheitern der Transkription, wenn die status wird eingestellt auf "failed".

• hasSummary (Boolean) - Gibt an, ob eine von der KI erstellte Zusammenfassung in der Transkription enthalten ist.

• primaryLanguageCode (String) - Der für die Transkription konfigurierte Sprachcode.

Sie können auch einen Archivstatus-Callback für Ihr Video API Account. Siehe Archivstatusänderungen. Die Rückrufdaten enthalten auch hasTranscription und transcription Eigenschaften.

Format der Transkription

Die Transkription wird in Form einer komprimierten ZIP-Datei bereitgestellt. Die unkomprimierte Datei ist eine Textdatei mit JSON-Daten.

Die Transkription umfasst einzelne Textsegmente. Jedes Segment entspricht einem einzelnen Audiokanal (aus einem der Audiostreams der Sitzung).

Das JSON hat die folgenden Top-Level-Eigenschaften:

• job_id - Eine eindeutige ID für die Transkription.

• timestamp - Eine ISO 8601-Datumszeichenfolge, die angibt, wann die Transkriptionsdatei erstellt wurde.

• number_of_channels - Die Anzahl der einzelnen Audiokanäle des Archivs, die in die Transkription einbezogen wurden.

• reliability - Ein Objekt mit einer Eigenschaft: score. Die score ist eine Zahl, die die geschätzte Gesamtzuverlässigkeit der Transkription angibt (von 0 bis 1,0).

• summary - Wenn Sie die Einstellung hasSummary Eigenschaft der transcriptionProperties Objekt zu true beim Starten des Archivs ist diese Eigenschaft enthalten. Sie ist auf eine KI-generierte Zusammenfassung der Transkription eingestellt.

• confidence - Ein Objekt mit zwei Eigenschaften: overall und channels. Die overall ist die geschätzte Konfidenz der gesamten Transkription (von 0 bis 1,0). Die channels ist ein Array, das die geschätzte Konfidenz der einzelnen Kanäle in der Transkription auflistet.

• channels_metadata - Ein Array von Objekten, die jeden Audiokanal definieren. Jedes Objekt ein id die die ID des Videostroms ist. Sie können identifizierende Verbindungsdaten hinzufügen, wenn Sie ein Client-Token erstellen für jeden Benutzer. Sie können verwenden Rückrufe zur Sitzungsüberwachung um die Stream-IDs und die Verbindungsdaten für die einzelnen Stream-Verbindungen zu erhalten. Diese können Sie dann verwenden, um den Benutzer des Streams in der Transkription zu identifizieren.

• segments - Ein Objekt, das einzelne Segmente des Transkripts enthält. Jedes Segmentobjekt hat die folgenden Eigenschaften:

  • text - Der transkribierte Text des Segments.

  • formatted - Der formatierte Text (mit Interpunktion) des Segments.

  • confidence - Eine Zahl zwischen 0 und 1,0, die die geschätzte Zuverlässigkeit der Transkription des Segments angibt.

  • channel - Die Ganzzahl, die den Audiokanal für das Segment identifiziert.

• raw_data - Ein Array-Objekt für jedes Wort im Transkriptionssegment. Jedes Objekt enthält die folgenden Eigenschaften:

  • word - Das Wort.

  • confidence - Eine Zahl zwischen 0 und 1,0, die die geschätzte Sicherheit des transkribierten Wortes angibt.

  • start_ms - Der Abstand des Wortanfangs vom Beginn der Transkription in Millisekunden.

  • end_ms - Der Abstand zwischen dem Wortende und dem Beginn der Transkription in Millisekunden.

Transkriptionen herunterladen

Es gibt zwei Möglichkeiten, die Transkriptionsdatei für ein Archiv herunterzuladen: über die REST-API oder über das Developer Dashboard.

Herunterladen über die REST-API

Sie können die Transkriptionsdatei für ein bestimmtes Archiv herunterladen, indem Sie die Funktion Abrufen von Archivinformationen REST-Methode und die Überprüfung der transcription.url Eigenschaft in der Antwort. Wenn die transcription.status Eigenschaft wird auf "available" oder "uploaded"die transcription.url enthält eine URL zum Herunterladen der Transkriptionsdatei.

Verwenden Sie eine HTTP-GET-Anfrage, um die Transkriptionsdatei von der URL herunterzuladen. Zum Beispiel:

Herunterladen über das Developer Dashboard

Sie können die Transkription für einen bestimmten Anruf herunterladen, wenn die Ausweichspeicher durch Befolgen dieser Schritte aktiviert wurde:

1. Öffnen Sie das Developer Dashboard und navigieren Sie zu Video-Protokolle.
2. Wählen Sie eine Anwendung aus der Liste der Anwendungen und klicken Sie auf Suche. Optional können Sie Folgendes angeben Aufnahme-ID oder Sitzungs-ID um die Ergebnisse einzugrenzen.
3. Suchen Sie in der Ergebnisliste die entsprechende Sitzung.
4. Bewegen Sie den Mauszeiger über das Feld Status Spalte für diese Sitzung und klicken Sie auf die Download Transkription Taste.

Beschränkungen/bekannte Probleme

• Transkriptionen sind nur für einzelne Stream-Archive verfügbar, nicht für zusammengestellte Archive.

• Transkriptionen sind nicht mit verschlüsselten Archiven kompatibel.

• Diese Funktion wird derzeit von der Vonage Video REST API unterstützt, nicht von den Vonage Video Server SDKs.

• Die maximale Länge einer Abschrift beträgt 120 Minuten.

• Die Transkription nach dem Anruf entspricht nicht in vollem Umfang den Anforderungen der Regionale Medienzonen (siehe unten).

Häufig gestellte Fragen

• Wie viele Datenströme können in einer einzigen Sitzung analysiert werden?
  • Bis zu 50 Streams mit einer Höchstzahl von 120 transkribierten Minuten.
• Funktioniert die Transkription nach dem Anruf sowohl bei gerouteten als auch bei weitergeleiteten Sitzungen?
  • Die Funktion "Post-Call Transcriptions" ist für geroutete Sitzungen vorgesehen, die die Vonage Media Server verwenden.
• Wenn das Hochladen der Transkription in das vom Kunden konfigurierte S3-Bucket fehlschlägt, funktioniert dann der Wiederholungs- oder Fallback-Mechanismus ähnlich wie beim Archiv-Upload?
  • Ja, der Mechanismus für die Wiederholung von PCT funktioniert genauso wie bei regulären Archiv-Uploads.
• Muss der Kunde in Fällen, in denen die Transkription zurückfällt und in die Vonage Cloud hochgeladen wird, eine HTTP-GET-Anfrage verwenden, um den Download-Link für die Transkription zu erhalten?
  • Wenn sich der Transkriptionsstatus ändert, sollte der Kunde einen Rückruf erhalten, der die Download-URL enthält. Wenn kein Callback registriert ist, kann der Download-Link nur über eine HTTP-GET-Anfrage abgerufen werden.
• Sobald der Link zum Herunterladen der Transkription eingegangen ist, kann er direkt heruntergeladen werden. Ist die Einführung einer Authentifizierung für das Herunterladen der Transkription geplant?
  • Es ist nicht geplant, eine Authentifizierung für den Link einzuführen. Der Download-Link hat ein kurzes Verfallsfenster. Wird innerhalb dieses Zeitraums nicht auf ihn zugegriffen, muss eine neue Anfrage gestellt werden, um einen neuen Link zu erhalten.
• Obwohl mehrere Benutzer an der Sitzung teilgenommen haben, ist die Transkriptionsdatei eine einzige JSON-Datei. Wie können wir zwischen den Benutzern unterscheiden?
  • Jeder Transkriptionseintrag in der Datei ist mit einer bestimmten Kanalnummer verknüpft, die jedem Stream zugeordnet ist. Die Datei enthält außerdem channels_metadatadie zu jeder Kanal-ID die entsprechenden Stream-ID-Informationen liefert.