Visão geral dos formatos de dados XM Discover

Sobre os formatos de dados XM Discover

XM Discover é compatível com três formatos de dados distintos, que você pode carregar usando tipos de arquivos diferentes.

Os conectores a seguir suportam o carregamento de dados por meio de arquivos:

• Conector de entrada de upload de arquivos ad hoc
• Conector de entrada de arquivos
• Conector de entrada do XM Discover Link
  Qdica: o conector de entrada XM Discover Link lida com uploads de dados por meio de chamadas API em que os dados são apresentados no formato JSON.

Feedback individual

O formato de feedback individual é usado para documentos que apresentam dados como uma única linha ou objeto “plano”. Cada documento pode conter vários campos literais, mas geralmente eles vêm de um único autor (por exemplo, quando uma pesquisa contém mais de uma pergunta aberta).

Você pode carregar documentos de feedback individuais por meio de:

• Arquivos Excel e CSV
• Arquivos JSON

Interações digitais

O formato de interações digitais é usado para documentos que contêm dados de conversação, como bate-papos.

As interações digitais devem seguir o formato de conversação do Qualtrics, que ajuda o sistema a entender os principais detalhes, como falantes, sequências e eventos de conversação. Um formato de conversação semelhante é usado para transcrições de chamadas.

Você pode fazer upload de interações digitais por meio de:

• Arquivos Excel e CSV
• Arquivos JSON

Transcrições de chamadas

O formato de transcrições de chamadas é usado para documentos que contêm dados de conversação, como chamadas de suporte.

As transcrições de chamadas devem seguir o formato de conversação do Qualtrics, que ajuda o sistema a entender os principais detalhes, como falantes, sequências e eventos de conversação. Um formato de conversação semelhante é usado para interações digitais.

Você pode carregar transcrições de chamadas por meio de:

• Arquivos Excel e CSV
• Arquivos JSON
• Arquivos WebVTT

Erros de arquivo Amostra

Vários trabalhos do Connector permitem que você faça upload de arquivos amostra (como uploads de arquivos ad-hoc, arquivos ou trabalhos de link do XM Discover ). Se o arquivo amostra estiver mal configurado, você verá uma mensagem de erro solicitando a correção de qualquer problema. Esta seção aborda os diferentes erros possíveis e como corrigi-los.

Erros de CSV e Excel

Os erros a seguir são possíveis para arquivos amostra CSV e Excel (XLS, XLSX):

• O arquivo deve ter a propriedade obrigatória “REQUIRED_FIELD“: Está faltando um campo obrigatório. Consulte a documentação desse conector específico para obter mais informações sobre os campos necessários para essa conexão e certifique-se de que o campo listado esteja incluído em seu arquivo amostra.
• Valores de participantType inconsistentes para ID participantId: cada participante em uma conversa pode ter apenas um valor de participantType definido. Revise seu arquivo amostra para verificar se há algum participante que tenha vários participantTypes.
• O número de colunas não corresponde aos cabeçalhos: Cada coluna deve ter um cabeçalho e o número de colunas em cada linha deve ser igual.
• Row ROW_NUMBER da coluna COLUMN_NAME deve corresponder ao formato data-hora ISO 8601 YYYY-MM-DDThh:mm:ss.sZ: Para datas, use o formato ISO 8601 com precisão de segundos.

Erros JSON

Os seguintes erros são possíveis para arquivos JSON:

• Erro em JSON_DATA_PATH: deve ser uma cadeia de caracteres de formato data-hora ISO 8601 YYYY-MM-DDThh:mm:ss.sZ: para datas, use o formato ISO 8601 com precisão de segundos.
• Error at JSON_DATA_PATH: should be a string of value AGENT, CLIENT, or TYPE_UNKNOWN: The participantType at the specified path is invalid. Somente os valores a seguir devem ser usados:
  • AGENT indica um representante da empresa ou um chatbot.
  • CLIENT indica um cliente.
  • TYPE_UNKNOWN indica um participante não identificado.
• Erro em JSON_DATA_PATH: deveria ser DATA_TYPE: O valor do campo é o tipo de dados errado. Certifique-se de que o tipo de dados corresponda ao que está no mapeamento de dados do seu conector.
• Erro em JSON_DATA_PATH: deveria ter a propriedade REQUIRED_FIELD: Está faltando um campo obrigatório. Consulte a documentação desse conector específico para obter mais informações sobre os campos necessários para essa conexão e certifique-se de que o campo listado esteja incluído em seu arquivo amostra.
• Erro em JSON_DATA_PATH: Participante com ID participantId não pode ser encontrado nos participantes: As IDs Participante devem corresponder a uma das IDs fornecidas na lista de participantes. Certifique-se de que o ID listado esteja incluído em seu arquivo amostra.