Como implementar busca de endereço por CEP em formulário Qualtrics

Para criar um formulário na Qualtrics que retorna o logradouro através do CEP informado, vamos precisar criar um projeto de pesquisa e usar os seguintes elementos:

• Question blocks;
• Survey flow;
• Web service element;
• API de busca de CEP (exemplo: https://brasilapi.com.br).

---

1. Para iniciar, crie um novo projeto de pesquisa do zero (sem ser baseado em template);
2. Depois adicione um segundo bloco de perguntas, clicando em Adicionar Bloco;
3. No bloco 1, adicione um campo do tipo Entrada de Texto para receber o CEP;
4. No bloco 2, adicione um campo do tipo Formulário para salvar o endereço, bairro, cidade e estado

Seu formulário deve ter a estrutura da imagem abaixo:

5. Agora navegue até o Fluxo da Pesquisa, e adicione um elemento do tipo Serviço Web entre os blocos 1 e 2;
6. No campo URL, inclua o endpoint da API escolhida para realizar a busca do CEP. A título de teste, usaremos a API abaixo:

https://brasilapi.com.br/api/cep/v1/{cep}

Como {cep} é uma variável inserida pelo usuário no nosso formulário, essa string deve ser substituída por um Embedded Data da Qualtrics. Portanto, a URL a ser informada no Survey Flow é a seguinte:

https://brasilapi.com.br/api/cep/v1/${q://QID1/ChoiceTextEntryValue}

7. Na opção Método, escolha GET;
8. E depois salve o retorno da chamada como Embedded Data. A API mencionada acima, irá retornar a seguinte resposta JSON:

{
"cep": "89010025",
"state": "SC",
"city": "Blumenau",
"neighborhood": "Centro",
"street": "Rua Doutor Luiz de Freitas Melro",
"service": "viacep"
}

Portanto, guarde as variáveis que você precisa reutilizar na pesquisa como Embeded Data.

Seu Survey Flow deve ter uma estrutura similar a esta:

9. Se você chegou até aqui, está quase no final! Agora basta retornar ao seu formulário, selecionar o campo 2 e clicar em Opções predefinidas no painel à esquerda;
10. A Qualtrics exibirá uma tela onde você poderá configurar as variáveis de retorno da API como opções predefinidas do formulário:

Pronto, agora basta pré-visualizar sua pesquisa que o logradouro irá aparecer automaticamente após o usuário informar o CEP, conforme imagens abaixo.

Para facilitar, criei este repositório no GitHub onde você pode baixar o QSF da pesquisa acima e importar na sua brand Qualtrics: CLIQUE AQUI