Conector de saída Qualtrics

Sobre o Conector de saída da Qualtrics

O conector de saída Qualtrics permite que você execute as seguintes ações em sua conta Qualtrics:

• Disparar um evento de fluxo de trabalho JSON e usar dados do XM Discover em fluxos de trabalho Qualtrics.
• Exporte respostas com enriquecimentos do XM Discover do XM Discover e importe-os para um conjunto de dados de pesquisa do Qualtrics.

Requisitos

Antes de configurar a conexão, você precisará das seguintes informações da sua conta Qualtrics:

• Seu ID do datacenter da Qualtrics.
• Seu token da API do Qualtrics.
• Seu ponto de extremidade de API de exportação do XM Discover.

Trabalhos de evento JSON

Para acionar um evento JSON com o Conector de saída da Qualtrics, você precisará do ponto de acesso do evento JSON. Você pode copiar o ponto de extremidade clicando em Copiar URL ao editar o evento JSON em seu fluxo de trabalho do Qualtrics.

Tarefa Exportar respostas

Se você exportar respostas para um conjunto de dados de pesquisa Qualtrics, verifique se seus dados atendem aos seguintes requisitos:

• Seu conjunto de dados de pesquisa deve ter campos que correspondam aos enriquecimentos do XM Discover que você gostaria de exportar. Se esses campos não existirem, você pode adicioná-los como dados integrados ou criá-los usando campos personalizados.
• Os documentos que você exporta do XM Discover devem ter um campo que corresponda ao ID da pesquisa para a qual você deseja importar respostas.

Criação de um job de conector de saída Qualtrics

1. Na página Trabalhos, clique em Novo trabalho.
   
2. Selecione o conector Qualtrics Outbound.
   
3. Dê um nome ao seu job para poder identificá-lo.
   
4. Selecione o projeto para o qual os dados devem ser carregados.
5. Dê uma descrição ao seu cargo para que você saiba o seu objetivo.
6. Clique em Seguinte.
7. Escolha o tipo de dados da Qualtrics que você deseja exportar:
   
   • Pesquisa: exporte dados de resposta para importar para um conjunto de dados de pesquisa.
   • Evento JSON: exporte dados para acionar um evento de fluxo de trabalho JSON.
8. Clique em Seguinte.
9. Use a lista suspensa para selecionar uma conexão Qualtrics existente ou escolha Adicionar novo para criar uma nova.
   
   Qdica: para editar ou remover uma conexão existente, vá para as configurações da sua conta.
10. Ao adicionar uma nova conexão, forneça o seguinte:
    • Nome da conexão: dê um nome à conexão para que você possa identificá-la mais tarde.
    • ID do datacenter da Qualtrics: insira seu ID do datacenter da Qualtrics.
    • Token da API do Qualtrics: insira o token da API da sua conta do Qualtrics.
11. Se você quiser que a conexão expire após um período de tempo, ative a opção Enviar notificações de expiração. Use o campo Data de vencimento para escolher quando as credenciais vencem. Na caixa Dias anteriores à expiração, insira até quando antes você gostaria de ser notificado sobre a expiração da conexão, até 100 dias.
12. Clique em Seguinte.
13. Forneça seu ponto de extremidade da API de exportação do XM Discover.
    
14. Clique em Seguinte.
15. Escolha o nível de dados que você deseja exportar:
    
    • Frases: Use dados em nível de sentença.
    • Documentos: use dados no nível do documento.
      Qdica: as etapas restantes na página Configuração da consulta são opcionais e ajudarão você a restringir os dados exportados.
16. Forneça uma consulta depesquisa para filtrar os dados de saída. Use a mesma sintaxe usada para procurar dados no Designer. Deixe este campo em branco para incluir todos os dados.
    Exemplo: você pode especificar um ou mais IDs de pesquisa para atualizar apenas os registros de pesquisa selecionados usando a seguinte sintaxe:Surveyid:sv_01
17. Insira o nome do filtro do seu projeto que você gostaria de aplicar aos dados de saída. Deixe este campo em branco se você não quiser filtrar seus dados.
18. Escolha quais registros você deseja importar:
    • Carregar novos registros: registros que foram criados desde a última execução do job de saída.
    • Carregar registros novos e atualizados: registros que foram criados ou atualizados desde a última execução do job de saída.
    • Carregar registros atualizados: registros que foram atualizados desde a última execução do job de saída.
19. Utilize o menu drop-down para selecionar os modelos de classificação que você quer incluir em seus dados. Marque o campo de seleção Todos os modelos para incluir os dados de classificação de todos os modelos disponíveis no projeto.
20. Selecione como deseja que as classificações afetem a filtragem de dados:
    • Ignorar: nenhuma filtragem é aplicada com base nos modelos selecionados.
    • Classificado atualmente: retorna os registros que foram classificados pelo(s) modelo(s) selecionado(s) durante a execução de classificação mais recente.
    • Sempre classificado: retorna os registros que foram classificados pelo(s) modelo(s) selecionado(s) em qualquer momento.
21. Escolha as opções de exportação adicionais que você gostaria de usar:
    • Se devem ser retornados IDs de categoria (verdadeiro) em vez de nomes de categoria (falso): exportar IDs de categoria em vez de nomes de categoria
    • Filtra os resultados aplicando a consulta de filtro com todos os caminhos de nós finais: adiciona vários modelos com o parâmetro “leaf_only flag” à chamada de API de exportação.
    • Ignorar valores vazios: ignore a atualização de um documento de pesquisa se todos os seus valores de saída estiverem vazios.
22. Clique em Seguinte.
23. O próximo passo depende de se você está exportando dados de pesquisa ou enviando dados para um ponto de extremidade JSON para acionar um fluxo de trabalho:
    • Pesquisa: escolha a pesquisa para a qual deseja exportar dados e clique em Avançar.
      
      Em seguida, selecione o atributo XM Discover que contém seu ID da pesquisa Qualtrics.
      
      Qdica: Somente os documentos com ID de pesquisa que correspondam à pesquisa selecionada na etapa anterior serão atualizados.
    • Evento JSON: insira o ponto de extremidade JSON do evento JSON.
      
24. Mapeie campos do XM Discover para o Qualtrics. Clique na caixa vazia e escolha o atributo do XM Discover que você gostaria de enviar para a Qualtrics.
    
25. Selecione o tipo de dados como o campo deve ser exportado, que corresponde ao tipo de variável de dados integrados do campo na Qualtrics:
    
    • Não mapear: nenhum tipo de variável especificado.
    • Atributo de número: tipo de variável Número.
    • Atributo de texto: tipo de variável de conjunto de texto.
    • Atributo de data: tipo de variável de data.
    • Verbatim: tipo de variável de texto.
26. Insira o nome do campo incorporado da Qualtrics que deve ser preenchido com os valores do atributo XM Discover selecionado.
27. Use os sinais de mais ( + ) e menos ( – ) para adicionar e remover campos conforme necessário.
28. Clique em Seguinte.
29. Se desejar, você pode adicionar um filtro de conector para filtrar os dados de entrada a fim de limitar quais dados são importados.
    
30. Você também pode limitar o número de registros importados em um único job inserindo um número na caixa Indicar limite de registros. Insira “Todos” se quiser importar todos os registros.
    Qdica: Para dados conversacionais, o limite é aplicado com base em conversas em vez de linhas.
31. Clique em Seguinte.
32. Escolha quando você deseja ser notificado. Consulte Notificações de job para mais informações.
    
33. Clique em Seguinte.
34. Selecione quando seu job é executado. Você pode efetuar um pull único ou configurar um pull de dados recorrente. Consulte Escalonamento do job para mais informações.
    
35. Clique em Seguinte.
36. Revise sua configuração. Se você precisar modificar uma configuração específica, clique no botão Editar para ir para essa etapa na configuração do conector.
    
37. Clique em Concluir para salvar o trabalho.

Depois que a tarefa for salva, os dados especificados serão exportados para a Qualtrics com base na programação definida. Se você estiver acionando um evento JSON, certifique-se de criar o resto do seu fluxo de trabalho, o que inclui adicionar condições para limitar quando o fluxo de trabalho é executado e as tarefas para determinar a saída do fluxo de trabalho.