Ir para o conteúdo principal
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Fontes de importação de arquivos para automações

Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

Sobre fontes de importação de arquivos para automações

Com as automações de importação de contato e de colaborador, você pode simplificar o gerenciamento do seu diretório. Quando a automação estiver programada para ser executada, ela processará todos os arquivos designados que ainda não foram processados pela automação, inclusive os arquivos recém-carregados. No entanto, antes de fazer isso, a automação precisa saber de onde extrair seus arquivos.

A origem do arquivo para automações de importação de contato e de colaborador pode ser:

  1. Serviço de Arquivos Qualtrics
  2. Seu servidor SFTP
  3. Armazenamento de arquivos OAuth (Google Drive ou Dropbox)
Qdica: antes de se preocupar com uma fonte de importação de arquivos, certifique-se de ter concluído a Etapa 1 (para contatos, para funcionários) da automação.

Serviço de Arquivos Qualtrics

A primeira opção do serviço de arquivo Qualtrics é selecionada na etapa de configuração da fonte de importação

O Qualtrics File Service é uma API de armazenamento de arquivos segura que permite que você faça o upload de arquivos para que essa automação seja importada. Você pode carregar um arquivo em um ponto de extremidade HTTPS, que será fornecido em uma caixa cinza (mostrada abaixo), como dados de formulário de várias partes.

o ponto de extremidade HTTPS

Quando a automação estiver programada para ser executada, ela processará todos os arquivos que ainda não foram processados pela automação, inclusive os recém-carregados.

Para usar o Qualtrics File Service, você precisará chamar o endpoint HTTPS fornecido. Se o arquivo for gerado a partir do sistema, você deverá fornecer a documentação API e o exemplo de implementação a seguir à sua equipe de TI ou de engenharia de software para integração com o nosso serviço.

Exemplo: Este exemplo está no formato cURL. Consulte a página de suporte Visão geral API para saber como gerar um token de API.
Para usuários de Mac e Unix:

curl -X POST -H "X-API-TOKEN: [SEU TOKEN DE API]" \
-F 'file=@/path/to/import/file/sample-file.txt' \
https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files

Para usuários do Windows:

curl -X POST -H "X-API-TOKEN: [YOUR TOKEN DE API]" ^
-F "file=@/path/to/import/file/sample-file.txt" ^
https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files

Exemplo: Este é um exemplo de solicitação. Consulte a página de suporte Visão geral API para saber como gerar um token de API.

POST https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files HTTP/1.1  
Content-Type: multipart/form-data
X-API-TOKEN: [YOUR TOKEN DE API]
 
-----------------------------
Content-Disposition: form-data; name="upfile"; filename="sample-file.txt"
Content-Type: text/plain
 
[FILE DATA]
-----------------------------

Gerenciar manualmente os arquivos carregados com a API

Você também pode gerenciar manualmente os arquivos carregados usando a API do Qualtrics. Os links a seguir explicam como interagir com a API do Qualtrics File Service:

Às vezes, essas chamadas API solicitarão um automationId. O Qualtrics fornecerá a você essas informações, formatadas como AU_XXXXX.

ID da UA dentro da caixa cinza

Avançar etapas – Automação da importação de Contato Diretório XM

Agora que você terminou de configurar o arquivo Qualtrics Service como sua fonte de importação, é hora de terminar de criar sua automação de importação de contato.

Avançar etapas – Automação da importação de pessoas Diretório Colaborador

Servidor SFTP

Você pode querer integrar seus próprios registros contato com o Qualtrics usando o protocolo SFTP (Secure File Transfer Protocol). Por exemplo, você pode querer importar conteúdo de um arquivo hospedado diariamente e, em seguida, importar e programar distribuições pesquisa para esses contatos, tudo com os métodos de transferência mais seguros e protegidos.

Quando a automação estiver programada para ser executada, ela processará todos os arquivos que ainda não foram processados pela automação, inclusive os recém-carregados. Quando um arquivo é processado, ele é removido do servidor SFTP.

Qdica: As automações do Qualtrics precisam “tocar” (ou seja, acessar) o arquivo várias vezes em seu servidor antes que ele seja transferido com sucesso para o Qualtrics. Verifique se o seu servidor SFTP está configurado para permitir vários toques nos arquivos. Se o seu servidor estiver configurado para excluir o arquivo após um toque, a automação falhará.

Na etapa Configure Import Source (Configurar fonte de importação ), há duas opções de SFTP: Nome de usuário e senha e Nome de usuário e chave SSH.

  1. Na etapa Configurar fonte de importação, selecione um dos servidores SFTP.
    O SFTP é selecionado na etapa de configuração da origem de importação
  2. Clique em Continuar.
  3. Digite o URL do host.
    O botão Continue fez com que as avançar etapas dos campos fossem exibidas na tela

    Qdica: o URL geralmente se assemelha a sftp.example.com.
  4. Digite o nome de usuário. Isso diferencia maiúsculas de minúsculas.
  5. Digite a porta. Isso é opcional. 22 é inserido como padrão.
  6. Clique em Continuar.

Dependendo de você ter selecionado a senha ou a chave SSH, as avançar etapas serão diferentes.

Configuração via nome de usuário e senha

  1. Digite sua senha.
    Senha do servidor sftp.

    Qdica: se o host, o nome de usuário e a porta exatos já tiverem sido fornecidos, não será solicitada uma senha.
  2. Clique em Continuar.
Qdica: se tiver problemas para estabelecer uma conexão SFTP, consulte Solução de problemas de SFTP para obter orientação adicional.

Configuração via nome de usuário e nome de usuário; chave SSH

  1. Se ainda não houver uma chave presente, selecione a opção Generate New SSH Key Pair (Gerar novo par de chaves SSH).
    Gerar par de chaves SSH

    Qdica: a opção Gerar novo par de chaves SSH ainda está presente mesmo que uma chave já tenha sido gerada. Essa opção poderá ser selecionada se o usuário quiser criar uma nova chave, mas isso não será necessário se as mesmas credenciais de SFTP forem usadas para a nova automação. O par de chaves é compartilhado em todas as automações que usam as mesmas credenciais SFTP em uma única conta de usuário.
  2. Clique em Baixar a chave pública.
    Faça o download da chave pública.
  3. Carregue a chave pública em seu servidor SFTP.
Qdica: suporte da Qualtrics não pode ajudar na configuração do servidor SFTP. Se tiver problemas com a chave SSH, consulte Autenticação de chave SSH para obter orientação adicional ou contato o provedor de serviços SFTP.

Cifras suportadas

A conexão a um servidor SFTP requer uma série de handshakes SSH para coordenar a criptografia usada entre o servidor e a automação. Para estabelecer uma conexão, o servidor SFTP precisará ter pelo menos uma cifra para cada tipo de cifra que corresponda a uma cifra suportada por automações. Abaixo está a lista de cifras suportadas por automações agrupadas pelo tipo de cifra.

Cifras de troca de chaves compatíveis:

  • curve25519-sha256@libssh.org
  • diffie-hellman-group14-sha1
  • diffie-hellman-group1-sha1
  • diffie-hellman-group-exchange-sha256
  • ecdh-sha2-nistp256
  • ecdh-sha2-nistp384
  • ecdh-sha2-nistp521

Cifras Mac compatíveis:

  • hmac-sha2-256
  • hmac-sha2-512

Cifras de criptografia compatíveis:

  • aes128-ctr
  • aes192-ctr
  • aes256-ctr
  • aes128-cbc
  • Arcfour256
  • Arcfour128
  • Arcfour
  • 3des-cbc

Suítes de cifras compatíveis:

  • chacha20-poly1305@openssh.com: O Chacha20 é um algoritmo de criptografia simétrica, enquanto o Poly1305 é uma cifra de autenticação.
  • aes128-gcm@openssh.com: Advanced Encryption Standard (AES) com uma chave de 128 bits usando o Galois/Counter Mode (GCM).

Se o servidor SFTP não for compatível com as cifras apropriadas, recomendamos o uso de uma das outras fontes de importação apresentadas nesta página.

Avançar etapas – Automação da importação de Contato Diretório XM

Agora que você terminou de configurar um servidor SFTP como fonte de importação, é hora de concluir a criação da automação da importação de contato.

Avançar etapas – Automação da importação de pessoas Diretório Colaborador

Google Drive e Dropbox

Você pode usar sua conta do Google Drive ou do Dropbox como armazenamento de arquivos para suas automações de importação de contato. Suas informações de login para esses serviços permanecerão privadas; o OAuth File Storage permite que as informações conta um usuário final sejam usadas pelo Qualtrics, sem expor a senha do usuário. Essas informações conta são usadas para conectar-se ao armazenamento de arquivos do Automations no Diretório XM, comportando-se de forma semelhante a uma configuração de SFTP.

Quando a automação estiver programada para ser executada, ela processará todos os arquivos que ainda não foram processados pela automação, inclusive os recém-carregados. Quando um arquivo é processado, ele é removido do armazenamento de arquivos do OAuth.

  1. Na etapa Configurar fonte de importação, selecione Google Drive ou Dropbox.
    Na tela Configure Import Source (Configurar fonte de importação), podemos ver as opções Google Drive e Dropbox.
  2. Clique em Continuar.
  3. Você precisará fazer login na sua conta do Google ou do Dropbox clicando em Fazer login. Isso o redirecionará para uma nova janela na qual você poderá fazer login via OAuth.
    Aqui vemos o botão Sign In para o File Storage.
  4. Quando o login for bem-sucedido, você será redirecionado para concluir a configuração ou, se desejar, trocar de conta para outro usuário OAuth. Você também pode remover a conta OAuth clicando em Alterar na fonte de dados e selecionando uma fonte de dados alternativa.
    Aqui vemos opções para alternar contas e alterar fontes de dados.
  5. Vá para a seção Select Import File source ( Selecionar fonte do arquivo de importação ) depois de configurar sua fonte de importação. Você poderá declarar o caminho da pasta aqui (por exemplo, “FolderName/Folder2”).
    Selecione a página de edição Import File (Importar arquivo), que inclui um espaço para especificar a origem da importação como um Folder Path (Caminho da pasta)

Avançar etapas – Automação da importação de Contato Diretório XM

Agora que você terminou de configurar um servidor SFTP como fonte de importação, é hora de concluir a criação da automação da importação de contato.

Avançar etapas – Automação da importação de pessoas Diretório Colaborador

 

Muitas das páginas neste site foram traduzidas do inglês original usando tradução automática. Embora na Qualtrics tenhamos feito nossa diligência prévia para obter as melhores traduções automáticas possíveis, a tradução automática nunca é perfeita. O texto original em inglês é considerado a versão oficial, e quaisquer discrepâncias entre o inglês original e as traduções automáticas não são juridicamente vinculativas.