Conector de entrada para upload de arquivo ad hoc
Sobre o conector Upload de arquivo ad hoc
Você pode usar o conector de entrada de upload de arquivo ad-hoc para carregar dados do cliente de um único arquivo usando 1 dos formatos suportados (planilha do Excel, arquivo simples, JSON ou WebVTT) no XM Discover.
Carregar dados no XM Discover
Antes de começar
Antes de configurar um job usando o conector de entrada de upload de arquivo ad hoc, certifique-se de que você tem os dados do cliente relevantes preparados em 1 dos seguintes formatos de arquivo suportados:
- Arquivos de texto delimitados (CSV)
- Arquivos Microsoft Excel (XLS, XLSX)
- Arquivos JavaScript Object Notation (JSON)
- Arquivos Web Video Text Track (VTT)
Para obter informações sobre os requisitos de formatação de dados para combinações de arquivos e formatos de dados, consulte Visão geral dos formatos de dados do XM Discover.
Configurar a conexão
Criação de uma tarefa de conector de upload de arquivo ad-hoc
Depois de configurar a conexão, siga estas etapas para criar um job de conector de entrada de upload de arquivo ad-hoc e configure os dados que são enviados para o XM Discover:
- Etapa 1: fornecer nome do job
- Etapa 2: especificar projeto e descrição
- Passo 3: Selecionar arquivo
- Etapa 4: Mapear campos de dados desejados para o XM Discover
- Etapa 5: Substituição e redação de dados (opcional)
- Etapa 6: Especificar limite de filtro e registro
- Etapa 7: Notificação e configuração (opcional)
- Etapa 8: Configurar opções adicionais para job
- Etapa 9: Confirmar todas as configurações de job
Etapa 1: fornecer nome do job
Insira um nome de job reconhecível na caixa Nome do job na parte superior esquerda da página.
Etapa 2: especificar projeto e descrição
- Na página Especificar projeto e descrição, selecione o projeto para o qual os dados devem ser carregados a partir do menu suspenso de projetos.
- Clique em Seguinte.
Etapa 3: Selecionar arquivo
- Na página Selecionar arquivo, marque 1 dos seguintes campos de seleção para selecionar o tipo de arquivo que contém os dados que devem ser carregados:
- Arquivos de texto delimitados (CSV)
- Arquivos Microsoft Excel (XLS, XLSX)
- Arquivos JavaScript Object Notation (JSON)
- Arquivos Web Video Text Track (VTT)
- Aplique as opções de configuração para o tipo de arquivo selecionado:
- Arquivos de texto delimitados (CSV): para mais informações, consulte o Configurações de arquivos de texto delimitados (CSV) Dados integrados.
- Arquivos do Microsoft Excel (XLS, XLSX): para mais informações, consulte o Configurações de arquivos do Microsoft Excel Dados integrados.
- Arquivos JavaScript Object Notation (JSON): Para obter mais informações, consulte o Configurações de arquivos JavaScript Object Notation (JSON) Dados integrados.
- Arquivos Web Video Text Track (VTT): Para mais informações, consulte o Configurações de arquivos de rastreamento de texto de vídeo da Web (VTT) Dados integrados.
- Clique no botão Clique para selecionar arquivo para upload e aponte para o arquivo de dados ou solte seu arquivo na tela cinza.
- Aguarde até que o sistema carregue o arquivo e exiba uma visualização.
Qdica: Se você vir uma mensagem de erro e o conteúdo do arquivo bruto em vez da visualização, poderá haver um problema com as opções de arquivo selecionadas. Para obter informações sobre mensagens de erro para falha na validação de arquivos de amostra carregados por meio do conector de carregamento de arquivo ad hoc, consulte Erros de arquivo de amostra. - Certifique-se de que os dados estão corretos.
- Clique em Seguinte.
Etapa 4: Mapear os campos desejados para o XM Discover
- Na página Mapear campos desejados na descoberta XM, selecione a guia MAPEAMENTO DE FONTE para conectar campos de dados de origem a campos de dados em seu projeto XM Discover.
- Na seção Mapeamento de origem padrão, configure os campos de dados padrão que todos os documentos no XM Discover compartilham. Para obter informações sobre o mapeamento de origem padrão, consulte Mapeamento de origem padrão Dados integrados.
- Na seção Mapeamento de origem, configure quaisquer campos de dados adicionais do arquivo. Para obter informações sobre a configuração de campos de dados conversacionais, consulte Campos de dados conversacionais Dados integrados.
Qdica: Para obter mais informações sobre mapeamento de dados, consulte Configuração do mapeamento de dados. - Clique em Seguinte.
Etapa 5: Substituição e redação de dados (opcional)
- Na página Substituição e redação de dados, você pode fornecer regras de substituição e ocultação para ocultar dados confidenciais ou substituir automaticamente determinadas palavras e frases no feedback e nas interações do cliente.
Qdica: Para obter mais informações sobre substituição de dados e redação, consulte Substituição e redação de dados. - Clique em Seguinte.
Etapa 6: Especificar limite de filtro e registro
- Na página Indicar filtro, você pode definir uma condição de filtro para um job carregar somente registros que o satisfaçam (opcional).
Qdica: Para obter mais informações sobre como aplicar um filtro, consulte Filtro de conector. - Você pode indicar um limite de registros na caixa Indicar limite de registros. Como alternativa, você pode deixar o limite de registros como padrão Tudo se quiser que todos os registros sejam retornados em um único push.
Qdica: O limite de registros é um limite por execução da tarefa. Se você definir o mesmo como 1.000, o job será executado em qualquer programação que você definir e será interrompido após chamar 1.000 registros. Se você defini-lo como diário, isso significa que ele será executado uma vez por dia e você obterá até 1.000 registros para cada dia.Qdica: Para dados conversacionais, o limite é aplicado com base em conversas em vez de linhas.
- Clique em Seguinte.
Etapa 7: Configuração de notificação (opcional)
- Na página Configuração de notificação, você pode selecionar as notificações que os observadores de um trabalho devem receber se ocorrer qualquer um dos eventos listados a seguir.
- Notificar quando nenhum registro for carregado no projeto.
- Notificar quando valores consecutivos ausentes forem encontrados.
- Notificar quando a execução do job falhar.
- Notificar quando a execução do job tiver êxito parcial.
- Notificar quando o job terminar com um timeout.
- Notificar o suporte quando este job falhar.
Qdica: você pode selecionar qualquer combinação de notificações ou decidir não escolher nenhuma notificação. Neste caso, as observações de um job não recebem notificações.Qdica: Para obter mais informações sobre as definições de configuração de notificações, consulte Notificações de trabalho.
- Clique em Seguinte.
Etapa 8: Configurar opções adicionais para job
- Na página Configurar opções adicionais para job, na seção Tratamento de documentos novos e existentes, escolha como o sistema deve tratar documentos duplicados selecionando 1 dos seguintes campos de seleção na seção Tratamento de documentos novos e existentes:
- Rejeitar duplicados para documentos existentes e criar novos registros para novos documentos.
- Atualizar atributos estruturados para documentos existentes e criar novos registros para novos documentos.
- Atualize atributos estruturados para documentos existentes e não crie registros para novos documentos.
Atenção: cada documento deve ter um ID natural exclusivo para que o sistema possa lidar com documentos duplicados que tenham IDs naturais idênticos.Qdica: Para obter mais informações sobre modos de detecção de duplicatas, consulte Detecção de duplicatas.
- Clique em Seguinte.
Etapa 9: Confirmar todas as configurações de job
- Na página Confirmar todas as configurações do trabalho, você pode visualizar um resumo de todas as configurações de um trabalho e editar as configurações, se necessário, antes de executar o carregamento de dados.
- Para executar o upload de dados, clique no botão Concluir quando estiver pronto para executar o upload de dados. Será exibida uma mensagem de confirmação confirmando que a tarefa foi enviada com êxito. Quando você clica em Concluir, acontece o seguinte:
- Os pulls únicos são executados imediatamente.
- A menos que você tenha ativado a opção “Criar tarefa, mas não extrair dados”, os pull programados são executados imediatamente e, em seguida, definidos para serem executados de acordo com a programação que você definiu.
Atenção: os jobs de upload de arquivo ad hoc são executados somente uma vez e não podem ser programados.
Para mais informações sobre a monitorização de jobs, consulte Síntese de página de jobs.
Configurações de arquivos de texto delimitados (CSV)
Você pode aplicar as opções de configuração para arquivos de texto delimitados (CSV) na página Selecionar arquivo.
- Selecione o sistema de codificação usado no arquivo a partir do menu.
- Insira o caractere utilizado para delimitar entradas de dados no arquivo na caixa Caractere de delimitação.
Qdica: Digite apenas 1 caractere.Qdica: o delimitador padrão é uma vírgula que pode ser usada em arquivos CSV. - Insira o caractere utilizado para incluir cada campo de dados no arquivo na caixa de caracteres Embalagem.
Qdica: Digite somente 2 caracteres.Qdica: marque a caixa de seleção Caractere de embalagem se os caracteres de embalagem forem opcionais.
- Selecione o formato de dados:
- Chat: selecione esta opção para carregar interações digitais com várias linhas de diálogo entre dois ou mais participantes.
- Chamada: selecione esta opção para carregar transcrições de chamada com várias linhas de diálogo entre dois ou mais participantes.
- Feedback: selecione esta opção para carregar documentos apresentados como uma única linha ou objetos “planos”.
- Interações digitais e transcrições de chamadas precisam seguir um formato predefinido. Dependendo do formato de dados selecionado, você pode clicar no link aqui para baixar 1 dos seguintes modelos com dados de amostra depois de selecionar o formato de dados:
- Modelo de chat para interações digitais: este é um modelo de arquivo CSV de amostra com o mínimo de campos obrigatórios/convenções de nomes para ingerir dados como uma interação digital. Você pode utilizar este modelo para identificar como mapear os seus tipos de campo de file delimitados existentes nesses requisitos. Se desejar, você pode adicionar campos adicionais que gostaria de incluir no arquivo carregado como parte de sua análise. Para mais informações, consulte Interações digitais no formato CSV.
- Modelo de chamada para transcrições de chamada: este é um modelo de arquivo CSV de amostra com o mínimo de campos obrigatórios/convenções de nomenclatura para ingerir dados como uma chamada de áudio. Você pode utilizar este modelo para identificar como mapear os seus tipos de campo de file delimitados existentes nesses requisitos. Se desejar, você pode adicionar campos adicionais que gostaria de incluir no arquivo carregado como parte de sua análise. Para mais informações, consulte Transcrições de chamada em formato CSV.
- Modelo de feedback para quaisquer dados não conversacionais. Para obter mais informações, consulte Feedback individual no formato CSV.
Configurações de arquivos do Microsoft Excel
Você pode aplicar as opções de configurações para arquivos do Microsoft Excel na página Selecionar arquivo.
- Selecione o formato de dados:
- Chat: selecione esta opção para carregar interações digitais com várias linhas de diálogo entre 2 ou mais participantes.
- Chamada: selecione esta opção para carregar transcrições de chamada com várias linhas de diálogo entre 2 ou mais participantes.
- Feedback: selecione esta opção para carregar documentos apresentados como uma única linha ou objetos “planos”.
- Interações digitais e transcrições de chamadas precisam seguir um formato predefinido. Dependendo do formato de dados selecionado, você pode clicar no link aqui para baixar 1 dos seguintes modelos com dados de amostra depois de selecionar o formato de dados:
- Modelo de chat para interações digitais: este é um modelo de arquivo Excel de amostra com o mínimo de campos obrigatórios e convenções de nomes para ingerir dados como uma interação digital. Você pode usar este modelo para identificar como mapear seus tipos de campo de arquivo do Excel existentes para esses requisitos. Se desejar, você pode adicionar campos adicionais que gostaria de incluir no arquivo carregado como parte de sua análise. Para mais informações, consulte Interações digitais no formato Excel.
- Modelo de chamada para transcrições de chamada: este é um modelo de arquivo Excel de amostra com os campos mínimos obrigatórios e convenções de nomes para ingerir dados como uma chamada de áudio. Você pode usar este modelo para identificar como mapear seus tipos de campo do Excel existentes para esses requisitos. Se desejar, você pode adicionar campos adicionais que gostaria de incluir no arquivo carregado como parte de sua análise. Para mais informações, consulte Chamada de certificados em formato Excel.
- Modelo de feedback para quaisquer dados não conversacionais. Para mais informações, consulte Feedback individual no formato Excel.
Configurações de arquivos JavaScript Object Notation (JSON)
Você pode aplicar as configurações para arquivos JavaScript Object Notation (JSON) na página Select File.
- Se seu arquivo JSON contiver os dados do documento XM Discover dentro de uma matriz específica no arquivo JSON, insira o nome da matriz na qual esses dados estão contidos na caixa do caminho JSON.
Qdica: Deixe esta caixa em branco se seus documentos estiverem localizados no nível do nó raiz. - Selecione o formato de dados:
- Chat: selecione esta opção para carregar interações digitais com várias linhas de diálogo entre 2 ou mais participantes.
- Chamada: selecione esta opção para carregar transcrições de chamada com várias linhas de diálogo entre 2 ou mais participantes.
- Feedback: selecione esta opção para carregar documentos apresentados como uma única linha ou objetos “planos”.
- Selecione o tipo de modelo a partir do menu do modelo.
- Interações digitais e transcrições de chamadas precisam seguir um formato predefinido. Dependendo do tipo de modelo selecionado, você pode clicar no link aqui para baixar 1 dos seguintes modelos com dados de amostra:
- Modelo de chat para interações digitais: este é um modelo de arquivo JSON de amostra com os campos mínimos necessários e convenções de nomes para ingerir dados como uma interação digital. Você pode usar este modelo para identificar como mapear seus tipos de campo de arquivo JSON existentes para esses requisitos. Se desejar, você pode adicionar campos adicionais que gostaria de incluir no arquivo carregado como parte de sua análise. Para mais informações, consulte Interações digitais no formato JSON.
- Modelo de chat do Amazon Connect: você pode usar esse modelo se planeja carregar um arquivo JSON da plataforma de bate-papo do Amazon Connect.
- Modelo de chamada para transcrições de chamada: este é um modelo de arquivo JSON de amostra com os campos mínimos obrigatórios e convenções de nomes para ingerir dados como uma chamada de áudio. Você pode utilizar este modelo para identificar como mapear seus tipos de campo JSON existentes para esses requisitos. Se desejar, você pode adicionar campos adicionais que gostaria de incluir no arquivo carregado como parte de sua análise. Para mais informações, consulte Transcrições de chamada no formato JSON.
- Modelo de chamada Verint: Você pode selecionar este modelo se planeja carregar uma transcrição de áudio da plataforma Verint.
- Modelo de chamada CB VTT: você pode selecionar este modelo se planeja carregar uma transcrição de áudio do XM Discover.
- Modelo de feedback para quaisquer dados não conversacionais. Para mais informações, consulte Feedback individual no formato JSON.
- Modelo de feedback do Dynamics 365: você pode selecionar esse modelo se planeja carregar um arquivo da plataforma Microsoft Dynamics 365.
Configurações de arquivos de rastreamento de texto de vídeo da Web (VTT)
Chamada é o único formato de dados disponível para arquivos Web Video Text Track (VTT). Clique no link aqui na página Selecionar arquivo para baixar um modelo WebVTT (Zoom) com dados de amostra.
Este é um modelo de arquivo WebVTT de amostra com o mínimo de campos obrigatórios e convenções de nomes para ingerir dados. Você pode utilizar este modelo para identificar como mapear seus tipos de campo de arquivo WebVTT existentes para esses requisitos. Se desejar, você pode adicionar campos adicionais que gostaria de incluir no arquivo carregado como parte de sua análise. Para mais informações, consulte Transcrições de chamada no formato WebVTT.
Mapeamento de origem padrão
Estes são os campos de dados padrão para o conector de entrada de arquivos ad hoc:
- O tipo de feedback ajuda você a identificar dados com base em seu tipo. Isso é útil para relatórios quando seu projeto contém diferentes tipos de dados (por exemplo, pesquisas e feedback de mídias sociais). Por padrão, o valor deste atributo é definido para chamar transcrições de chamada, chat para interações digitais ou feedback para feedback individual. Use a transformação personalizada para definir um valor personalizado, definir uma expressão ou mapeá-la para um determinado campo.
- A fonte de ajuda você a identificar dados obtidos de uma fonte específica. Isso pode ser qualquer coisa que descreva a origem dos dados, como o nome de uma pesquisa ou uma campanha de marketing móvel. Por padrão, o valor desse atributo está definido como Upload de arquivo ad hoc. Use a transformação personalizada para definir um valor personalizado, definir uma expressão ou mapeá-la para um determinado campo.
- document_date é o campo de data principal associado a um documento. Esta data é usada em relatórios, tendências, alertas do XM Discover e assim por diante. Para Data do documento, você pode selecionar qualquer campo de data dos seus dados na coluna Nome do campo.
Como alternativa, você pode definir uma data específica adicionando um campo personalizado.
Para mais informações, consulte Definir uma data de documento específica para obter detalhes. - natural_id serve como um identificador exclusivo de um documento. É altamente recomendado ter um ID único para cada documento para processar duplicados corretamente. Para ID natural, você pode selecionar qualquer campo de texto ou numérico de seus dados na coluna Nome do campo.
Como alternativa, você pode gerar IDs automaticamente adicionando um campo personalizado. Para mais informações, consulte Geração automática de IDs naturais. - feedback_provider ajuda você a identificar dados obtidos de um provedor específico. Para uploads de arquivos, o valor deste atributo é definido como Upload de arquivo ad hoc.
- job_name ajuda você a identificar dados com base no nome do job utilizado para carregar os mesmos. Você pode modificar o valor deste atributo durante a configuração por meio do campo Nome do job que é exibido na parte superior de cada página durante a configuração.
- loadDate indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente.
Qdica: Para obter mais informações sobre mapeamento de dados, consulte Configuração do mapeamento de dados.
Campos de dados conversacionais
Na seção Mapeamento de origem, você pode configurar os seguintes campos de dados conversacionais.
- richVerbatim: Para dados conversacionais (como interações de chamada e chat), o XM Discover usa um formato conversacional na íntegra para o campo richVerbatim. Este formato suporta a ingestão de metadados específicos do diálogo necessários para desbloquear a visualização conversacional (turnos do falante, silêncio, eventos conversacionais, etc.) e enriquecimentos (hora de início, duração, etc.). Este campo literal inclui campos “filhos” para rastrear o lado do cliente e do representante da conversa:
- clientVerbatim
- agentVerbatim
- Desconhecido
Qdica: Transformações não são suportadas para campos textuais conversacionais.Qdica: O mesmo texto não pode ser usado para diferentes tipos de dados conversacionais. Se você quiser que seu projeto hospede vários tipos de conversa, use pares separados de conversações textuais por tipo de conversa.
- clientVerbatim (para dados conversacionais): rastreia o lado do cliente da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:
- clientVerbatimChat para interações digitais
- clientVerbatimCall para interações de chamada
Qdica: você pode mapear este campo para um campo literal diferente, se necessário.
- agentVerbatim (para dados conversacionais): rastreia o lado do representante (agente) da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:
- agentVerbatimChat para interações digitais
- agentVerbatimChamada para interações de chamada
Qdica: você pode mapear este campo para um campo literal diferente, se necessário.
- desconhecido (para dados conversacionais): rastreia o lado desconhecido da conversa em interações de chamada e chat. Por padrão, este campo é mapeado para:
- unknownVerbatimChat para interações digitais
- unknownVerbatimCall para interações de chamada
Qdica: você pode mapear este campo para um campo literal diferente, se necessário.