Format der Unterhaltungsdaten

Für Customer Experience Insights werden Unterhaltungsdaten verwendet, die Sie in einen Cloud Storage-Bucket hochladen. Sie können Ihre Unterhaltungsdaten für die API entweder als Audio- oder Text-Dateien bereitstellen.

Transkriptdaten der Unterhaltung

Ihre Textdateien enthalten die folgenden Details.

Unterhaltung

Das Objekt auf oberster Ebene für Unterhaltungsdaten.

Feld	Typ	Beschreibung
conversation_info	ConversationInfo { }	Optional. Metadaten für die Unterhaltung.
entries	Eintrag [ ]	Erforderlich. Unterhaltungsnachrichten in chronologischer Reihenfolge.

ConversationInfo

Die Metadaten für eine Unterhaltung.

Feld	Typ	Beschreibung
Kategorien	Kategorie [ ]	Optional. Benutzerdefinierte Kategorien für die Unterhaltungsdaten.

Kategorie

Unterhaltungsdatenkategorie. Wenn Sie Ihren Unterhaltungsdaten Kategorien zuweisen, werden diese verwendet, um Themen in den Unterhaltungen zu identifizieren. Wenn Sie keine Kategorien angeben, kategorisiert das System die Unterhaltungen automatisch anhand der Inhalte.

Feld	Typ	Beschreibung
display_name	String	Erforderlich. Ein Anzeigename für die Kategorie.

Entry

Daten für eine einzelne Unterhaltungsnachricht.

Feld	Typ	Beschreibung
text	String	Erforderlich. Der Text dieser Unterhaltungsnachricht.
user_id	integer	Erforderlich. Eine Zahl, die den Unterhaltungsteilnehmer identifiziert. Jeder Teilnehmer sollte eine eigene user_id haben, die wiederholt verwendet wird, wenn der Teilnehmer an mehreren Unterhaltungen teilnimmt.
role	String	Erforderlich. Die Rolle des Unterhaltungsteilnehmers. Einer der folgenden Werte: „AGENT“, „AUTOMATED_AGENT“, „CUSTOMER“, „END_USER“.
start_timestamp_usec	Ganzzahl	Erforderlich. Der Zeitstempel für den Beginn dieses Unterhaltungsrunde in Mikrosekunden (Unixzeit, UTC).

Beispiel

Das folgende Beispiel zeigt eine Datei mit Unterhaltungsdaten.

{
  "conversation_info":{
    "categories":[
      {
        "display_name":"Category 1"
      }
    ]
  },
  "entries": [
    {
      "start_timestamp_usec": 1000000,
      "text": "Hello, I'm calling in regards to ...",
      "role": "CUSTOMER",
      "user_id": 1
    },
    {
      "start_timestamp_usec": 5000000,
      "text": "Yes, I can answer your question ...",
      "role": "AGENT",
      "user_id": 2
    }
  ]
}