Format des données de conversation

Customer Experience Insights utilise les données de conversation que vous importez dans un bucket Cloud Storage. Vous pouvez fournir vos données de conversation à l'API sous forme de fichiers audio ou texte.

Données de transcription des conversations

Vos fichiers texte incluent les informations suivantes.

Conversation

Objet de premier niveau pour les données de conversation.

Champ	Type	Description
conversation_info	ConversationInfo { }	Facultatif. Métadonnées de la conversation.
entries	Entrée [ ]	Obligatoire. Messages de conversation classés dans l'ordre chronologique.

ConversationInfo

Métadonnées d'une conversation.

Champ	Type	Description
catégories	Catégorie [ ]	Facultatif. Catégories personnalisées pour les données de conversation

Catégorie

Catégorie de données de conversation. Si vous fournissez des catégories avec vos données de conversation, elles seront utilisées pour identifier les sujets de vos conversations. Si vous ne fournissez pas de catégories, le système les classe automatiquement en fonction du contenu.

Champ	Type	Description
display_name	chaîne	Obligatoire. Nom à afficher pour la catégorie.

Entrée

Données pour un seul message de conversation.

Champ	Type	Description
text	chaîne	Obligatoire. Texte de ce message de conversation.
user_id	entier	Obligatoire. Numéro qui identifie le participant à la conversation. Chaque participant doit disposer d'un user_id unique, utilisé à plusieurs reprises s'il participe à plusieurs conversations.
role	chaîne	Obligatoire. Rôle du participant à la conversation. Au choix : "AGENT", "AUTOMATED_AGENT", "CUSTOMER", "END_USER".
start_timestamp_usec	Entier	Obligatoire. L'horodatage du début de la conversation est exprimé en microsecondes de l'heure UTC depuis l'epoch Unix.

Exemple

Vous trouverez ci-dessous un exemple de fichier de données de conversation.

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