Visão geral dos formatos de dados do XM Discover
Sobre formatos de dados do XM Discover
O XM Discover suporta 3 formatos de dados distintos que você pode carregar usando diferentes tipos de arquivo.
Os seguintes conectores suportam o carregamento de dados por meio de arquivos:
- Conector de entrada para upload de arquivo ad hoc
- Conector de entrada de arquivos
- Conector de entrada do link do XM Discover
Qdica: o conector de entrada XM Discover Link processa carregamentos de dados por meio de chamadas de 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 um objeto de linha única ou “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 mediante:
Interações digitais
O formato de interações digitais é utilizado para documentos que contêm dados conversacionais, como chats.
As interações digitais devem seguir o formato conversacional Qualtrics que ajuda o sistema a compreender os principais detalhes, como palestrantes, sequências e eventos conversacionais. Um formato de conversação semelhante é usado para transcrições de chamadas.
Você pode carregar interações digitais por meio de:
Transcrições de chamada
O formato de transcrições de chamada é usado para documentos que contêm dados conversacionais, como chamadas de suporte.
As transcrições de chamadas devem seguir o formato conversacional Qualtrics que ajuda o sistema a compreender os principais detalhes, como palestrantes, sequências e eventos conversacionais. Um formato de conversação semelhante é utilizado para interações digitais.
Você pode carregar transcrições de chamadas por meio de:
Erros de arquivo de amostra
Várias tarefas de conector permitem que você carregue arquivos de amostra (como uploads de arquivos ad-hoc, arquivos ou jobs de link do XM Discover). Se o arquivo de amostra estiver configurado incorretamente, você verá uma mensagem de erro solicitando que você corrija quaisquer problemas. Esta seção aborda os diferentes erros possíveis e como corrigi-los.
Erros de CSV e Excel
Os seguintes erros são possíveis para arquivos de 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 para esse 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 está incluído em seu arquivo de amostra.
- Valores de participantType inconsistentes para o código de participantId: cada participante de uma conversação só pode ter um valor de participantType definido. Revise seu arquivo de amostra para todos os participantes que tenham vários tipos de participante.
- 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.
- A linha ROW_NUMBER da coluna COLUMN_NAME deve corresponder ao formato de data e hora ISO 8601 AAAA-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 string de formato de data e hora ISO 8601 AAAA-MM-DDThh:mm:ss.sZ: Para datas, use o formato ISO 8601 com precisão de segundos.
- Erro em JSON_DATA_PATH: deve ser uma string de valor AGENT, CLIENT ou TYPE_UNKNOWN: o participantType no caminho especificado é inválido. Só devem ser utilizados os seguintes valores:
- 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: deve ser DATA_TYPE: o valor do campo é do tipo de dados incorreto. Verifique se o tipo de dados corresponde ao que está no mapeamento de dados do seu conector.
- Erro em JSON_DATA_PATH: deve ter a propriedade REQUIRED_FIELD: está faltando um campo obrigatório. Consulte a documentação para esse 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 está incluído em seu arquivo de amostra.
- Erro em JSON_DATA_PATH: o participante com o código do participante não foi encontrado nos participantes: os códigos do participante devem corresponder a um dos códigos fornecidos na lista de participantes. Certifique-se de que o ID listado está incluído em seu arquivo de amostra.