Formato de dados de conversa

O Customer Experience Insights usa dados de conversas que você envia para um bucket do Cloud Storage. É possível fornecer os dados da conversa à API como arquivos de áudio ou texto.

Dados de transcrição da conversa

Seus arquivos de texto incluem os seguintes detalhes:

Conversa

O objeto de nível superior para dados de conversa.

Campo	Tipo	Descrição
conversation_info	ConversationInfo { }	Opcional. Metadados da conversa.
entries	Entrada [ ]	Obrigatório. As mensagens de conversa em ordem cronológica.

ConversationInfo

Os metadados de uma conversa.

Campo	Tipo	Descrição
categories	Categoria [ ]	Opcional. Categorias personalizadas para os dados da conversa.

Categoria

Categoria de dados de conversa. Se você fornecer categorias com os dados da conversa, elas serão usadas para identificar tópicos nas suas conversas. Se você não fornecer categorias, o sistema vai categorizar automaticamente as conversas com base no conteúdo.

Campo	Tipo	Descrição
display_name	string	Obrigatório. Um nome de exibição para a categoria.

Entrada

Dados de uma única mensagem de conversa.

Campo	Tipo	Descrição
texto	string	Obrigatório. O texto desta mensagem de conversa.
user_id	integer	Obrigatório. Um número que identifica o participante da conversa. Cada participante precisa ter um único user_id, usado repetidamente se ele participar de várias conversas.
papel	string	Obrigatório. A função do participante da conversa. Uma destas opções: "AGENT", "AUTOMATED_AGENT", "CUSTOMER", "END_USER".
start_timestamp_usec	integer	Obrigatório. O carimbo de data/hora do início desta rodada de conversa em microssegundos do horário UTC desde a época Unix.

Exemplo

Confira a seguir um exemplo de arquivo de dados de conversa.

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