Serviço Web

Suite

Customer Experience Employee Experience Strategy & Research

Produto

Qualtrics

O que há nesta página

Sobre os serviços da Web

Às vezes, você pode querer incluir recursos mais complexos em seu pesquisa. Talvez queira incluir as 10 principais manchetes de um site de notícias em seu pesquisa, ou automatizar a distribuição de um segundo pesquisa a ser enviado por e-mail aos respondentes de um primeiro pesquisa exatamente duas horas depois. Um serviço da Web permitiria que você fizesse exatamente isso, fazendo solicitações a um URL designado.

Qdica: Esta página contém referências à API da Qualtrics, que é um característica que requer permissão especial para ser acessado. Se estiver interessado em obter acesso a esse característica, entre em contato com o administrador Marca para obter mais informações.

Atenção: A configuração de um serviço da Web geralmente requer conhecimentos avançados de programação. Embora nossa equipe de suporte tenha prazer em ajudar com os aspectos básicos da inserção de informações no serviço da Web, não podemos oferecer suporte aos aspectos de programação. Ao invés disso, você pode perguntar para nossa comunidade de usuários dedicados.

Adição de um serviço da Web

Ao editar o pesquisa, clique no ícone Fluxo da pesquisa na barra de navegação esquerda.

navegar até o fluxo da pesquisa clicando no ícone fluxo da pesquisa na barra de navegação esquerda

Clique em Adicionar abaixo ou Adicionar um novo elemento aqui.

Botões Add Below e Add a New element Here; opção Web Service no menu What do you want to add?

Selecione Web Service.

No campo URL, cole o URL de seu serviço da Web externo.

Campo para URL em um serviço da Web seguido pelo método

Qdica: você pode usar texto transportado para passar as informações pesquisa para o URL do endpoint por meio de cadeias de consulta.

Selecione um método para seu serviço da Web. Explicaremos mais sobre os diferentes métodos na seção a seguir.

Métodos

Nosso característica de serviço da Web permite que você escolha entre uma série de métodos para solicitar informações do URL especificado.

Tipo de método	Ação	Exemplo
OBTER	O serviço da Web vai até a URL e recupera as informações.	Recupere informações sobre um membro da sua lista de contatos. Consulte a chamada API Get Contato para obter mais detalhes.
POST	Vá para a URL e salve as informações lá.	Criar uma mensagem biblioteca.
COLOCAR	Atualizar ou substituir informações existentes.	Alterar um nome de usuário. Essa é uma das coisas que você pode fazer com a chamada Update User (Atualizar usuário ).
PATCH	Atualizar ou substituir informações existentes. Muito semelhante ao PUT. Embora nosso serviço da Web ofereça esse método, nossa API não usa chamadas PATCH.	Modificar dados salvos em seu servidor.
EXCLUIR	Remover informações.	Excluir um gráfico de sua biblioteca.

Se você estiver usando nossas chamadas API, a documentação informará qual método usar, conforme indicado na captura de tela abaixo.

Método listado avançar de cada chamada na documentação API

Adição de credenciais a um serviço da Web

Como etapa opcional, é possível adicionar credenciais de autorização ao serviço da Web do fluxo da pesquisa do questionário. Os serviços da Web Fluxo da pesquisa são compatíveis com métodos básicos, de chave API e OAuth 2.0, e podem compartilhar credenciais com serviços da Web em fluxos de trabalho.

Definição de credenciais

Clique em Selecionar credenciais.

selecione o botão de credenciais em um serviço da Web abaixo do método e acima dos parâmetros

Você pode escolher entre um conjunto de credenciais existentes ou clicar em Adicionar uma conta de usuário.

nova janela na qual você configura as contas de usuário

Qdica: as contas que você vê nessa janela podem incluir aquelas criadas para serviços da Web em fluxos de trabalho ou criadas por administradores Marca para uso por toda a organização.

Dê um nome para identificar suas credenciais posteriormente.

nomeação de credenciais de serviços da Web

Selecione o tipo de conexão:

Básico: Forneça um nome de usuário e uma senha.
Chave API: Use um identificador exclusivo para se autenticar em uma API.
OAuth: Autorize o acesso de terceiros aos recursos do seu servidor sem compartilhar suas credenciais.

Configure a credencial escolhida seguindo as etapas desta página com link.

Decida se deseja usar o mTLS. Saiba mais na página do link.

preenchimento e salvamento de credenciais de serviços da Web

Clique em Conectar conta.

Clique em Seguinte.

botão avançar na parte inferior da janela

Suas credenciais aparecerão em seu serviço da Web.

em vez de selecionar credenciais, o nome das credenciais de autenticação é exibido

Configuração de parâmetros de credenciais

Você pode ajustar onde suas credenciais são adicionadas na solicitação, além dos parâmetros de nome e modelo.

Clique nos três pontos avançar das credenciais.

Selecione Configurar parâmetros de credenciais.

Em Formato do parâmetro, escolha onde na solicitação as credenciais devem ser passadas:

Cabeçalho
Consulta
Corpo

Dê o nome do parâmetro.

Digite o modelo de parâmetro.

Clique em Salvar.

Substituição e remoção de credenciais

Clique nos três pontos avançar de suas credenciais para ver as seguintes opções:

menu de 3 pontos avançar do nome das credenciais do serviço da Web fluxo da pesquisa aberto

Configurar parâmetros de credenciais: Descrito acima.
Substituir: Escolha ou adicione um conjunto diferente de credenciais salvas ao serviço da Web.
Remover: Excluir as credenciais do serviço da Web. É assim que você mudaria o serviço da Web de autorizado para não autorizado.

Gerenciamento de contas

Na janela de credenciais, você pode gerenciar contas (credenciais individuais) clicando nos três pontos. Suas opções incluem:

Renomear conta
Gerenciar acesso
Remover conta
Editar conta (alterar como as credenciais são configuradas, como o tipo de autorização)

Algumas opções podem não estar disponíveis. Por exemplo, se você não criou uma conta, talvez não consiga excluí-la. Se você não for um administrador Marca, não poderá gerenciar o acesso do usuário às contas.

Gerenciamento de credenciais como administrador

Os administradores Marca podem criar credenciais de serviço da Web e controlar quais usuários da organização têm permissão para usá-las.

Para saber mais, consulte Administração extensões. A extensão é chamada WebService, sem espaços.

Parâmetros

Atualmente, há três tipos de parâmetros que você pode anexar à sua solicitação.

Um serviço da Web com os seguintes destaques: Adicionar um parâmetro de consulta, Adicionar um parâmetro de corpo e Adicionar um cabeçalho personalizado

Parâmetro de consulta: Em vez de adicionar uma query string ao final do URL do serviço da Web, coloque os parâmetros de consulta aqui.

Parâmetro do corpo: Esse parâmetro não está disponível para solicitações GET ou DELETE. Ele vem com duas opções de formatação:

application/x-www-form-urlencoded: Em vez de inserir os parâmetros do corpo na área especificada do serviço Web, adicione-os como uma query string no final do URL especificado.
application/json: Insira cada um dos parâmetros do corpo da solicitação, certificando-se de especificar o tipo e o valor. Para parâmetros aninhados, como matrizes e objetos, você pode inserir suas chaves usando a notação de pontos ou inserir os valores diretamente como JSON bruto:
- Essa imagem mostra os parâmetros do corpo usando a notação de pontos.
- Esta imagem mostra os mesmos parâmetros do corpo, mas como JSON bruto.
  
  Atenção: Cada chave e valor em um objeto JSON, bem como cada elemento em uma matriz JSON (incluindo texto transportado), deve ter aspas duplas ao redor.

Cabeçalho personalizado: Insira os cabeçalhos de URL aqui.

Qdica: os URLs de autenticação devem ser adicionados ao cabeçalho personalizado.

Se estiver usando nossas chamadas API, a documentação informará quais tipos de parâmetros devem ser incluídos. O exemplo abaixo fornece os parâmetros do corpo a serem definidos.

Na documentação API, uma seta indicando Body Params

Adição de parâmetros ao serviço da Web

Parâmetros do corpo preenchidos em um serviço da Web

Selecione qualquer uma das 3 opções Adicionar um parâmetro para enviar ao serviço da Web indicadas na seção anterior. No exemplo acima, estamos indicando os parâmetros da consulta.

Digite o nome do parâmetro na caixa Parâmetro para serviço da Web à esquerda.

Digite o valor correspondente do parâmetro na caixa Value (Valor ) à direita.

Clique no sinal de mais(+) à direita do parâmetro para adicionar outro.

Clique em Aplicar quando terminar.

Teste de seus parâmetros

Depois de colar o URL e configurar os parâmetros, você pode testar o URL para ver quais campos podem ser extraídos.

Clique em Testar URL para ver quais informações você pode extrair do Web Service externo.

Selecione os campos que deseja usar ou registrar no seu pesquisa. O nome do campo aparece à esquerda e um valor de exemplo correspondente aparece à direita.

Seleção de campos para capturar a partir do URL

Clique em Add Embedded Data (Adicionar dados incorporados ) para adicionar campos selecionados aos seus dados.

Qdica: o conjunto Dados integrados em um serviço da Web é registrado como um tipo de variável“conjunto de texto“.

Qdica: Você pode alterar os nomes dados integrados associados aos campos do seu serviço da Web na coluna Definir dados incorporados. Os nomes dados integrados estão à esquerda do sinal de igual(=), indicado por um ícone de ED verde. O lado direito não deve ser alterado. Os nomes que você definir à esquerda serão os nomes dos campos conforme aparecem em seus dados.

Se você selecionar Fire and Forget, não salvará nenhum dos dados retornados da chamada do serviço da Web. Esse característica é útil quando você não precisa salvar os dados retornados.

Opção Fire and Forget acima dos campos; Aplicar no canto inferior direito

Qdica: Fire and Forget permite que seu pesquisa faça uma solicitação a um serviço da Web sem esperar por uma resposta. Isso significa que seus respondentes poderão concluir o pesquisa completo sem nenhum atraso devido ao serviço da Web. Talvez você queira usar essa opção se tiver uma solicitação de serviço da Web que demore um pouco para ser processada, mas recomendamos que você use esse característica somente durante os testes, pois ele impedirá que dados integrados sejam salvos.

Quando terminar, clique em Aplicar.

Correção de erros de TLS

A partir de 1º de setembro de 2021, as solicitações de serviços da Web com erros de segurança da camada de transporte (TLS) falharão. O TLS é o que torna as solicitações da Web por HTTPS (em oposição ao HTTP simples) seguras, impedindo que os dados da solicitação fiquem visíveis para terceiros e garantindo que a solicitação seja enviada para o destino correto. Ignorar erros de TLS efetivamente elimina esses benefícios de segurança; essa mudança é um passo importante em nossos esforços contínuos para melhorar a segurança da plataforma Qualtrics.

Para resolver cada erro de TLS, você precisa executar uma das seguintes ações:

Corrija o erro de TLS. Devido à natureza dos erros de TLS, nossa equipe de suporte não pode fornecer orientações específicas sobre como fazer isso, mas o administrador da rede saberá como corrigir o erro.
Altere a solicitação de serviço da Web do elemento de fluxo para que seja feita por HTTP e não por HTTPS. Por exemplo, você pode alterar o URL “https://example.com” para “http://example.com”. Se optar por essa abordagem, você também deve garantir que o URL HTTP não seja redirecionado para o URL HTTPS.
Atenção: Observe que essa abordagem fará com que os dados da solicitação do serviço da Web sejam transmitidos sem criptografia.

Você pode verificar se o elemento de serviço da Web está pronto para essa alteração usando o botão de teste avançar do campo URL no elemento de fluxo. A visualização dos dados brutos na janela resultante, também mostrada abaixo, não deve mostrar nenhum erro.

Caixa de diálogo que se abre sobre o fluxo da pesquisa e diz Selecionar campos para incluir como dados integrados O serviço da Web não retornou nenhum campo. No canto inferior esquerdo da caixa de diálogo, há um botão que diz View dados brutos (Exibir dados brutos)

Atenção: Se você atualizar o elemento de serviço da Web para corrigir o erro, também deverá publicar suas alterações no pesquisa. Recomendamos que você resolva os erros o mais rápido possível para evitar sessões pesquisa em andamento usando a versão antiga pesquisa após o prazo. Se, em vez disso, você resolver o erro por meio de outro método (por exemplo, corrigindo a configuração do TLS no servidor visado pelo elemento do serviço da Web), a publicação não será necessária.

Tipos de Projetos em que esse Característica está disponível

Desde que tenha acesso aos serviços da Web como parte de sua licença, você pode adicionar um serviço da Web a qualquer tipo de fluxo da pesquisa do projeto. Isso inclui:

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.

Isto foi útil?

O feedback que você envia aqui é usado apenas para ajudar a melhorar essa página.

Isso é ótimo! Obrigado pelo seu feedback!

Obrigado pelo seu feedback!