Formato de dados de conversa

O Customer Experience Insights usa dados de conversas enviados para um bucket do Cloud Storage. É possível fornecer os dados de conversa para a API como arquivos de áudio ou texto.

Dados de transcrição de conversa

Os arquivos de texto incluem os detalhes a seguir.

Conversa

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

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

ConversationInfo

Os metadados de uma conversa.

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

Category

Categoria de dados de conversa. Se você fornecer categorias com os dados de conversa, elas serão usadas para identificar tópicos nas 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.

Entry

Dados de uma única mensagem de conversa.

Campo	Tipo	Descrição
texto	string	Obrigatório. O texto dessa 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. O papel 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 dessa conversa em microssegundos do horário UTC desde a Era 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
    }
  ]
}