Exportando e Importando um Questionário em JSON

"Quero levar este questionário para outra conta", "quero guardar uma cópia do questionário como estava na versão que foi a campo", "recebi um arquivo JSON de questionário, como coloco isso na plataforma?" — esta página explica os dois botões que transformam um questionário num arquivo JSON e um arquivo JSON num questionário novo, e o que viaja dentro desse arquivo.

Onde encontrar

Os dois botões ficam na barra lateral Questionários (o nome de cada um aparece ao passar o mouse sobre o ícone):

Botão	Onde fica	Quando está disponível
Exportar questionário como JSON	Na coluna de botões ao lado da lista, junto dos outros botões do questionário selecionado	Com um questionário selecionado na lista
Importar questionário a partir de arquivo JSON	Na fileira de botões do topo da barra lateral, junto de Novo Questionário e Copiar	Sempre — o arquivo vira um questionário novo

Não encontrou o botão?

Cada botão só aparece para quem tem, na conta, a permissão correspondente. As permissões são definidas em Administrar permissões, no menu da conta — veja Definindo Permissões de Usuários.

Exportando

Selecione o questionário na lista e clique em Exportar questionário como JSON. A tela mostra, no título, o nome do questionário que será exportado, e um único campo:

Selecione a revisão — de qual Revisão a estrutura de perguntas será exportada. As Revisões aparecem da mais recente para a mais antiga, e a Revisão de Produção vem marcada com (Revisão de Produção).

Clique em Exportar para baixar o arquivo. O nome do arquivo traz o nome do questionário e o número da Revisão exportada.

A Revisão já vem escolhida — e é a mais recente, não a de Produção

O campo Selecione a revisão abre preenchido com a Revisão mais recente. Se o que você quer guardar ou levar é a versão que foi a campo, troque para a Revisão marcada com (Revisão de Produção) antes de exportar. Para entender a diferença, veja Níveis de Alteração e Revisão de Produção.

Só dá para exportar o que já foi publicado

A exportação parte sempre de uma Revisão. Um questionário que ainda mostra Não Publicado nas Configurações não tem nenhuma Revisão para escolher — publique-o antes (veja Publicando Revisões e Excluindo o Questionário). Da mesma forma, alterações feitas nas perguntas depois da última publicação só entram no arquivo depois de uma nova publicação.

O que vai dentro do arquivo

Assim como na cópia, o arquivo junta duas fontes: a estrutura de perguntas vem da Revisão escolhida; o resto vem do questionário do jeito que ele está no momento da exportação.

Parte	De onde vem
Perguntas, opções de resposta, pulos, restrições, recusas, consistências, vínculos e seleção condicional	Da Revisão escolhida em Selecione a revisão
Informações básicas e amostra, Data Final, valores padronizados, logo, texto de abertura do CATI, configurações de CATI com Inteligência Artificial e Endereço do Webhook para envio das entrevistas	Do questionário, como está agora
Cotas e DScripts	Do questionário, como estão agora

Ficam de fora: as coletas, a equipe, os aparelhos vinculados, os cruzamentos, os convidados externos e as Listas de Contatos do CATI.

Estar no arquivo não significa ser aplicado tal qual na importação: o Modo e o Nível de mudanças do questionário exportado são ignorados, e o questionário importado sempre começa em Teste e Alto (veja Como o questionário importado começa).

O arquivo carrega o endereço do Webhook e as configurações do questionário

O Endereço do Webhook para envio das entrevistas e as demais configurações viajam dentro do arquivo. Trate o JSON exportado com o mesmo cuidado que você teria com o próprio questionário ao compartilhá-lo com outras pessoas.

Importando

Clique em Importar questionário a partir de arquivo JSON. No diálogo que abre:

Preencha o Nome do questionário — é o nome com que o questionário novo vai aparecer na lista.
Arraste o arquivo para a área Arraste seu arquivo JSON aqui, ou, Clique para enviar (ou clique nela para escolher o arquivo). É aceito um arquivo .json por vez, de até 10 MB.
Clique em Salvar. O botão só fica disponível com o nome preenchido e o arquivo escolhido.

Enquanto o arquivo é processado, o diálogo mostra Importando questionário.... Ao final, ele fecha e o questionário novo aparece na lista Questionários.

Como o questionário importado começa

É sempre um questionário novo — a importação nunca altera um questionário que já existe, mesmo que o arquivo tenha sido exportado dele.
O Modo começa em Teste e o Nível de mudanças em Alto, qualquer que fosse o modo do questionário exportado.
As perguntas, as cotas, os DScripts e as configurações vêm do arquivo — incluindo a Data Final e o Endereço do Webhook para envio das entrevistas.
Ele não tem coletas, e não traz o histórico de Revisões: o indicador das Configurações começa em Não Publicado.

Confira a Data Final e o Webhook do questionário importado

A Data Final vem do arquivo. Se ela já passou, o questionário importado nasce com a data vencida e não fica disponível para coleta (veja Data Final).
O Endereço do Webhook para envio das entrevistas também vem do arquivo: as coletas do questionário importado vão para o mesmo destino do questionário de origem, até você trocar ou apagar esse endereço nas Configurações.

As imagens podem chegar depois

Imagens usadas em perguntas e em opções de resposta são copiadas em segundo plano, e podem aparecer só depois que o questionário importado já está na lista. Se alguma imagem estiver faltando logo após a importação, aguarde um pouco e recarregue a tela.

Para o questionário importado ficar disponível para coleta, siga os mesmos passos de um questionário novo — em especial, clicar em Publicar para gerar a primeira Revisão (veja Do questionário novo à primeira coleta).

Exportar e importar x Copiar

	Exportar e importar	Copiar
Para onde vai	Para qualquer conta em que você possa importar	Para a mesma conta
Quantos passos	Dois: baixar o arquivo e importá-lo	Um só
O que vem da Revisão escolhida	Perguntas e regras	Perguntas e regras
O que vem do estado atual	Configurações, cotas e DScripts, no momento da exportação	Configurações, cotas e DScripts, no momento da cópia
Equipe	Não viaja no arquivo	A mesma do original

Se o questionário vai ficar na mesma conta, Copiar é o caminho mais direto: um passo só, e ainda reaproveita a equipe do original — veja Copiando um Questionário.

O arquivo JSON também serve de referência técnica

A estrutura detalhada do arquivo, campo a campo, está em Estrutura JSON de Questionários — uma referência técnica, pensada para quem vai gerar ou editar esse arquivo por fora da plataforma.

Resumo prático

Antes de exportar, confira o campo Selecione a revisão: ele vem com a Revisão mais recente; para levar a versão que foi a campo, escolha a marcada com (Revisão de Produção).
Se não aparece nenhuma Revisão para escolher, o questionário ainda não foi publicado — clique em Publicar nas Configurações dele primeiro.
Depois de importar, abra as Configurações do questionário novo e confira pelo menos a Data Final e o Endereço do Webhook para envio das entrevistas, e clique em Publicar para gerar a primeira Revisão.
Refaça no questionário importado o que não viaja no arquivo: a equipe, os aparelhos, os cruzamentos, os convidados externos e as Listas de Contatos do CATI.
Se o questionário vai continuar na mesma conta, prefira Copiar: é um passo só, sem baixar e enviar arquivo, e a equipe do original vem junto.