Configurando uma tarefa de link do XM Discover

Sobre o XM Discover Link Connector

Você pode usar o conector XM Discover Link para enviar dados XM para o XM Discover por meio de um ponto de acesso da API REST e, ao mesmo tempo, aproveitar todos os recursos oferecidos pela estrutura de conectores, como mapeamento de campos, transformações, filtros, observação de tarefas e assim por diante.

O conector XM Discover Link permite ingerir dados no ritmo desejado, enquanto outros conectores extraem os dados de acordo com uma programação.

Formatos de dados suportados

O conector XM Discover Link suporta o carregamento dos seguintes tipos de dados:

• Feedback individual
• Interações digitais
• Transcrições de chamada

Todos os documentos são fornecidos no formato JSON que depende do tipo de dados.

Para saber mais sobre os formatos de dados suportados pelo XM Discover, consulte Visão geral dos formatos de dados do XM Discover.

Veja como o conector XM Discover Link funciona:

1. O primeiro passo no uso do conector XM Discover Link é configurar um trabalho de processamento e configurar parâmetros e mapeamentos para futuras chamadas de API. Para obter detalhes, consulte Criação de uma tarefa de link do XM Discover.
2. Assim que um job de processamento for configurado, você pode executar chamadas de API por meio do job de processamento adequado, referenciando o respectivo ID. Todas as informações do ponto de extremidade de API são fornecidas no resumo do trabalho de processamento. Para obter detalhes, consulte Informações do ponto de acesso de API.

Configurando a conexão

Antes de começar

Antes de configurar uma tarefa XM Discover Link, recomendamos preparar um arquivo de amostra com dados do cliente no formato JSON usando um dos seguintes tipos de dados:

1. Feedback individual: Para obter detalhes, consulte Feedback individual em formato JSON.
2. Interações digitais: para detalhes, consulte Interações digitais no formato JSON.
3. Transcrições de chamadas: Para mais detalhes, consulte Chamar transcrições em formato JSON.

Para configurar a conexão:

1. Iniciar sessão nos conectores.
2. Clique no botão Novo trabalho no canto superior direito da página Trabalhos.
3. Na página Conectores, vá para a seção SELECIONAR UMA FONTE.
4. Clique no botão Link do XM Discover.

Criação de uma tarefa de conector de entrada do XM Discover Link

Depois de configurar a conexão, siga estas etapas para criar um trabalho de conector de entrada XM Discover Link e configurar os dados a serem enviados para o XM Discover.

• Etapa 1: fornecer nome do job
• Etapa 2: especificar projeto e descrição
• Etapa 3: Modo de autorização
• Etapa 4: Selecionar arquivo de amostra
• Etapa 5: Mapear os campos desejados para o XM Discover
• Etapa 6: Substituição e redação de dados (opcional)
• Etapa 7: Especificar filtro (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 da página.

Etapa 2: especificar projeto e descrição

1. 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.
   Qdica: você tem a opção de inserir uma observação sobre a tarefa na caixa Descrição do cargo. A descrição do cargo que você insere na caixa “Descrição do cargo” só pode ser acessada na lista Conectores e não é carregada como parte dos dados de uma tarefa.
2. Clique em Seguinte.

Etapa 3: Modo de autorização

Na página Modo de autorização, selecione o modo de autorização que você planeja usar para as chamadas API:

• Chave de API: use tokens de API gerados pelo XM Discover. Para saber mais sobre tokens de API, consulte Tokens API.
• OAUTH 2.0: use o ID do cliente e a chave secreta do cliente fornecidos pelo serviço de autenticação XM Discover. Entre em contato com seu gerente de sucesso do cliente Qualtrics para solicitar esse método.

Etapa 4: Selecionar arquivo de amostra

1. Na página Selecionar arquivo de amostra, em Escolher formato de dados, selecione o tipo de dados a serem processados por este job:
   • Bate-papo: Processe interações digitais com várias linhas de diálogo entre dois ou mais participantes. As interações digitais precisam seguir um formato predefinido; você pode baixar um modelo depois de selecionar o formato de dados.
   • Chamada: Carregar transcrições de chamadas com várias linhas de diálogo entre dois ou mais participantes. As transcrições de chamadas precisam seguir um formato predefinido; você pode baixar um modelo depois de selecionar o formato de dados.
   • Feedback: processar documentos apresentados como objetos de linha única ou “planos”.
2. No menu suspenso Modelo, selecione um modelo a ser usado.
   Qdica: as opções disponíveis do modelo são diferentes dependendo do formato de dados escolhido.

   Formato de dados	Opções de modelo
   Chat	Chat (padrão): use para dados de interações digitais padrão. Amazon Connect: Use para interações digitais específicas ao Amazon Connect Chat.
   Chamada	Chamada (default): utilização para dados de transcrição de chamada padrão. Verint: Use para transcrições de chamada específicas para Verint. Qdica: Para saber mais sobre o formato de arquivo de exportação da Análise de interação da Verint, consulte a documentação da Verint.
   Feedback	Nenhum (padrão): não aplique nenhum modelo. Dynamics 365: Use para dados do Microsoft Dynamics.

3. Na caixa de caminho JSON, indique o caminho JSON para um subconjunto de JSON que contenha nós de documento.
   Qdica: Deixe em branco se os documentos estiverem localizados no nível do nó raiz.
4. Clique no botão Clique para selecionar arquivo para upload e aponte para o arquivo de amostra ou solte seu arquivo na tela cinza.
5. Aguarde até que o XM Discover carregue o arquivo de amostra e mostre a visualização abaixo.
   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 formato de dados selecionadas. Para informações sobre mensagens de erro para falha na validação de arquivos de amostra, consulte Erros de arquivo de amostra.
6. Certifique-se de que os dados estão corretos.
7. Clique em Seguinte.

Etapa 5: Mapear os campos desejados para o XM Discover

1. 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.
2. Na seção Mapeamento de origem padrão, configure os campos de dados padrão que todos os documentos no XM Discover compartilham. A tabela a seguir fornece uma visão geral das opções de campo de dados padrão para o conector de entrada XM Discover Link.
   

   Nome do campo	Editável?	Descrição
   feedback_type	Sim	O tipo de feedback ajuda você a identificar dados com base no respectivo 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 está definido como: “chamada” para transcrições de chamadas “chat” para interações digitais “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.
   fonte	Sim	A fonte 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 deste atributo está definido como “Link de descoberta XM”. Use a transformação personalizada para definir um valor personalizado, definir uma expressão ou mapeá-la para um determinado campo.
   richVerbatim (para dados conversacionais)	Não	Para dados conversacionais (como interações de chamada e chat), o XM Discover usa um formato conversacional literal 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 acompanha o lado do cliente da conversa. agentVerbatim rastreia o lado (do agente) do representante da conversa. desconhecido rastreia o lado desconhecido da conversa. Notas sobre conversações textuais: Transformações não são suportadas para campos textuais conversacionais. 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)	Sim	Monitora o lado do cliente da conversa nas interações de chamada e chat. Por padrão, este campo é mapeado para: clientVerbatimChat para interações digitais clientVerbatimCall para interações de chamada Você pode mapeá-lo para um campo literal diferente, se necessário.
   agentVerbatim (para dados conversacionais)	Sim	Monitora o lado do representante da conversa nas interações de chamada e chat. Por padrão, este campo é mapeado para: agentVerbatimChat para interações digitais agentVerbatimCall para interações de chamada Você pode mapeá-lo para um campo literal diferente, se necessário.
   desconhecido (para dados conversacionais)	Sim	Monitora o lado desconhecido da conversa nas interações de chamada e chat. Por padrão, este campo é mapeado para: unknownVerbatimChat para interações digitais unknownVerbatimCall para interações de chamada Você pode mapeá-lo para um campo literal diferente, se necessário.
   document_date	Sim	Data do documento é 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, selecione uma das seguintes opções: conversationTimestamp (para dados conversacionais): data e hora para toda a conversa. Se os dados de origem contiverem outros campos de data, você pode definir um deles como Data do documento selecionando-o a partir do menu drop-down na coluna Nome do campo. Você também pode definir uma data específica adicionando um campo personalizado. Para obter detalhes, consulte Definição de uma data do documento específica.
   natural_id	Sim	O ID natural serve como identificador único de um documento e permite o processamento correto de duplicados. Para ID natural, selecione uma das seguintes opções: conversationId (para dados conversacionais): um ID exclusivo para toda a conversação. Selecione qualquer campo de texto ou numérico de seus dados na coluna Nome do campo. Gere IDs automaticamente adicionando um campo personalizado. Para obter detalhes, consulte Geração automática de IDs naturais.
   feedback_provider	Não	O provedor de feedback ajuda você a identificar dados obtidos de um provedor específico. Para uploads de XM Discover Link, o valor deste atributo está definido como “XM Discover Link”.
   job_name	Sim	O nome do job ajuda você a identificar dados com base no nome do job utilizado para carregá-lo. Você pode modificar o valor deste atributo na caixa Nome do job na parte superior da página.
   data de carregamento	Não	A data de carregamento indica quando um documento foi carregado no XM Discover. Este campo é definido automaticamente.

3. Na seção Mapeamento de origem, configure o restante dos campos de dados.
   Qdica: esta seção contém mapeamentos para os campos de origem fornecidos por meio do arquivo de amostra. Se você não forneceu um arquivo de amostra, precisará criar mapeamentos manualmente. Para mais informações sobre o mapeamento de dados, consulte Configuração do mapeamento de dados.
4. Clique em Seguinte.

Etapa 6: Substituição e redação de dados (opcional)

1. 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.
2. Clique em Seguinte.

Etapa 7: Especificar filtro (opcional)

1. Na página Indicar filtro, você pode definir uma condição de filtro para que o job carregue somente os dados que correspondem ao filtro.
   Qdica: Para obter mais informações sobre a filtragem de dados de entrada, consulte Filtro de conector.
2. Clique em Seguinte.

Etapa 8: Configurar opções adicionais para job

1. Na página Configurar opções adicionais para job, escolha como o XM Discover deve tratar documentos duplicados selecionando um dos seguintes modos de detecção de duplicatas na seção Processamento 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 duplicados.
2. Clique em Seguinte.

Etapa 9: Confirmar todas as configurações de job

1. 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.
2. Clique no botão Concluir para criar o trabalho XM Discover Link.
3. Depois que a tarefa XM Discover Link é criada, você pode usá-la para executar chamadas de API. Para obter detalhes, consulte Informações do ponto de acesso de API.

Como obter informações do ponto de acesso de API

Depois de configurar um trabalho XM Discover Link, você precisa obter as informações do ponto de extremidade de API necessárias para começar a carregar dados usando essa tarefa.

1. Iniciar sessão nos conectores.
2. Certifique-se de que a guia JOBS esteja aberta.
3. Localize a tarefa XM Discover Link adequada usando filtros ou pesquisa.
4. Expanda o menu de ações ao lado do trabalho e selecione Resumo.
5. No canto superior direito da janela Detalhes do job: nome do job, clique no link Documentação da API para abrir a Documentação da API de job. A tabela abaixo fornece detalhes das informações do ponto de acesso da API necessárias para começar a carregar dados usando um job XM Discover Link: