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

Perguntas comuns sobre API

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 perguntas comuns sobre API

A Qualtrics tem uma variedade de produtos diferentes que permitem que nossos clientes coletem dados acionáveis em tempo real. Alguns desses produtos incluem a Pesquisa Platform, Website/App Feedback, Diretório XM e Qualtrics 360. Depois de adquirir o recurso da API da Qualtrics, você poderá usar a API para qualquer produto que faça parte da sua licença.

Plataforma de pesquisa

Tenho todos os parâmetros corretos, mas continuo recebendo uma mensagem de erro que diz “Invalid request. Parâmetro ausente ou inválido Request” Por que isso está acontecendo?

Exemplo: 

curl -X POST \API\ 
-H 'content-type: application/json' \ -H 'x-api-token: 12345678901234567890' \ 
-d '{"surveyId": "SV_1234567890", "Format": "json"}'

Os parâmetros API do Qualtrics diferenciam maiúsculas de minúsculas. Neste exemplo, seu parâmetro está sendo chamado de “Format” quando deveria ser “format” Atualize isso e você poderá executar com êxito sua solicitação API.

Gostaria de fazer o download de meus dados brutos para abrir no Excel. Qual solicitação API devo usar?
Você deverá usar a solicitação Criar exportação de resposta para iniciar o processo de exportação e especificar que o formato do arquivo de exportação de resposta deve ser CSV. Em seguida, você precisará usar a solicitação Get Response Export Progress para verificar se o arquivo está pronto, seguida pela solicitação Get Response Export File para fazer o download do arquivo CSV.
Ao usar o Create Contacts Import, quais são os diferentes métodos de postar ou enviar minha lista de contatos para o Qualtrics?
Há duas opções para carregar sua lista de contatos:

  1. Você pode definir o Content-Type como multipart/form-data e carregar seus contatos como um arquivo JSON.
  2. Você pode definir o Content-Type como application/json e publicar os contatos como uma matriz JSON no corpo da solicitação.
Estou limitado ao número de solicitações que posso fazer para minha organização? E quantas solicitações simultâneas API posso fazer ao mesmo tempo?
Consulte esta página API para obter mais informações sobre limites.
Estou usando a solicitação Importar Pesquisa e salvei meu pesquisa como um arquivo TXT. A solicitação foi bem-sucedida, mas minhas perguntas não estão aparecendo no pesquisa recém-importado. Por que isso está acontecendo?
Você precisará certificar-se de que está seguindo o formato necessário para importar pesquisas para o Qualtrics. Para saber mais sobre a formatação de TXT, consulte Preparando um arquivo TXT em formato simples e Preparando um arquivo TXT em formato avançado. Quando seu arquivo estiver formatado corretamente, a solicitação será executada com êxito.
Estou usando a solicitação Create Response Export com os parâmetros startDate e endDate. No entanto, quando vejo os dados baixados, não estou vendo o intervalo de datas previsto para respostas.
A chave para usar os parâmetros startDate e endDate é entender qual valor de data está sendo usado para avaliar a condição que você está criando (ou seja, quais datas estão sendo analisadas para avaliar a startDate que você definiu e a endDate que você definiu). Esses dois parâmetros estão usando a data em que o participante iniciou a pesquisa. Esse valor, chamado de Data de início, pode ser encontrado na guia Data & Analysis e nos dados baixados. Portanto, se você definir o parâmetro startDate como 2017-01-01 e o parâmetro endDate como 2017-01-02, fará o download das respostas que foram registradas (enviadas ou incompletas) para os participantes pesquisa pesquisa que o iniciaram no intervalo de datas de 1º de janeiro de 2017 a 2 de janeiro de 2017.

Qdica: uma resposta pesquisa não é registrada até que o participante clique no botão enviar dentro de uma pesquisa ou quando o botão respostas incompletas pesquisa o prazo foi cumprido.

Site/feedback do aplicativo

Para perguntas sobre Website/App Feedback, contato a equipe de suporte Website/App Feedback.

Diretório XM

Posso usar a API da Pesquisa Platform agora que também estou usando Diretório XM?
Sim, com certeza. Diretório XM tem algumas solicitações API que substituirão as solicitações feitas por meio da API da Pesquisa Platform, mas, na maioria das vezes, você ainda pode usar todas as solicitações API da Pesquisa Platform. As solicitações de contatos da plataforma de Pesquisa são as únicas que podem ser alteradas. Na documentação da v3, as solicitações API que não são compatíveis com os usuários Diretório XM (e vice-versa) terão um aviso.
Que funcionalidade adicional a API Diretório XM oferece que eu não tenho acesso apenas com a API da Pesquisa Platform?
A API Diretório XM fornece a você algumas solicitações exclusivas específicas do Diretório XM. Você pode usar o getBouncedContacts (API v2.4) para localizar todos os contatos em seu diretório (ou em uma lista de destinatários específica) que já tiveram uma rejeição de e-mail. A solicitação Lista Diretório Contacts pode ser usada para exportar um subconjunto de todo o seu diretório. A solicitação getIncentiveRecipients permite que você faça o download de uma lista de todos os contato do seu diretório que ganharam um incentivo específico, como uma recompensa em pontos ou uma participação em sorteios. Essas e outras solicitações estão disponíveis com a API Diretório XM.
Qual é a diferença entre o ID Contato e o ID Destinatário?
Cada solicitação API Diretório XM normalmente pede o ID do Contato. Essa ID começa com “CID_” e é seguida por uma cadeia alfanumérica exclusiva. O ID do Contato é o ID exclusivo do contato no seu diretório. Algumas solicitações API pedem o ID do Destinatário do contato. Essa ID começa com “CGC_” e é seguida por uma cadeia alfanumérica exclusiva. O ID Destinatário é o ID exclusivo do contato em uma lista de destinatários.

Para entender a diferença entre o ID Contato e o ID Destinatário, é importante lembrar que cada contato deve existir apenas uma vez no seu diretório. Portanto, um único contato pode ser encontrado em seu diretório uma vez, mas também pode ser membro de várias listas de e-mail. Se esse contato fosse membro de três listas de mala direta, ele teria um ID Contato e três IDs Destinatário, um para cada lista.

Qualtrics 360

Para perguntas sobre o Qualtrics 360, contato a equipe de suporte do Qualtrics 360.

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.