Exportação de Dados

A Exportação de Dados reúne as informações do seu hub — pessoas cadastradas, campanhas, iniciativas e os projetos originados delas — em um único arquivo digital, no formato JSON. Esse arquivo pode ser guardado como backup, aberto em ferramentas de análise (como planilhas com suporte a JSON) ou usado para levar dados da plataforma para outro sistema da empresa.

Ele pode ser gerado a qualquer momento, sob demanda, ou de forma automática e recorrente, em uma frequência definida por quem administra o hub.

Quem pode usar

O acesso à tela de exportação é restrito por dois motivos ao mesmo tempo:

Papel de usuário — apenas pessoas com o papel Administrador (ou Superadministrador) enxergam a opção “Exportação de Dados” no menu.
Plano contratado — o recurso também precisa estar habilitado no plano do hub. Se não estiver, o item some do menu e a tela avisa que a exportação não está disponível no plano atual.

Se você não encontra a opção no menu, um desses dois motivos explica.

Como as informações são organizadas

O arquivo exportado segue a mesma lógica que você já vê nas telas da plataforma: cada informação fica guardada dentro da informação maior a que pertence. Essa ordem é sempre a mesma, em qualquer exportação:

Pessoas + Campanhas → Iniciativas → Projetos

Dentro de cada iniciativa, também vêm: avaliador atual, histórico de avaliadores, equipe da iniciativa, respostas do formulário, comentários, notas de avaliação, histórico de etapas e os projetos originados dela.

Não é possível escolher exportar só uma parte (por exemplo, “só pessoas” ou “só projetos”): toda exportação traz essa estrutura completa do hub, respeitando o período escolhido.

Passo a passo para exportar

Acesse “Exportação de Dados” no menu lateral. A opção só aparece para quem tem o papel de Administrador.
Na aba “Histórico”, clique no botão “Exportar Dados”.
Escolha o período dos dados, ou selecione “Todo o período” para trazer tudo sem filtro de data (veja detalhes abaixo).
Escolha o destino do arquivo:
- Baixar Diretamente — o arquivo JSON é baixado direto para o seu computador.
- Enviar para Bucket — o arquivo também é enviado a um armazenamento externo (AWS S3, Azure ou Google Cloud) já configurado previamente pela equipe técnica da empresa.
Confirme a exportação. Ao concluir, a mensagem “Arquivo JSON baixado com sucesso!” indica que deu tudo certo.
Consulte o histórico. Toda exportação — manual ou automática — fica registrada na aba “Histórico”, com data, período usado, quantidade de registros e um botão para baixar novamente.

Filtrando por período

O campo Período, na hora de exportar, define quais iniciativas entram no arquivo. As opções disponíveis são: Todo o período, Este mês, Este trimestre, Este ano, Mês passado, Trimestre passado, Ano passado, ou Adicionar período, para escolher datas específicas em um calendário.

O que “estar dentro do período” realmente significa

O filtro não olha apenas a data em que a iniciativa foi criada. Uma iniciativa entra na exportação de um período se qualquer atividade aconteceu nela dentro daquela janela de tempo: submissão, edição, mudança de etapa, resposta de formulário, avaliação lançada, comentário, anexo enviado, mudança na equipe ou atualização de um projeto vinculado.

Na prática: a mesma iniciativa pode aparecer em mais de um arquivo exportado, em períodos diferentes, sempre que houver alguma movimentação nela — isso é esperado, não é duplicidade. Campanhas sem nenhuma iniciativa com atividade no período escolhido simplesmente não aparecem no arquivo daquela exportação.

Nota: todas as datas e horários do arquivo exportado são mostrados em UTC (horário de Greenwich), não no horário de Brasília. Um evento registrado às 09h em Brasília, por exemplo, aparece como 12h no arquivo — Brasília está 3 horas atrás de UTC.

Exportações automáticas

Além da exportação manual, é possível configurar exportações recorrentes, que enviam o arquivo direto para um armazenamento externo (bucket), sem precisar de ação manual a cada vez.

Isso é acompanhado na aba Monitor, onde ficam visíveis:

a frequência configurada — diária, semanal, mensal ou anual — e o horário de disparo;
o status geral do agendamento: “Operacional” ou “Com Erros”;
a data da última e da próxima exportação prevista;
um log com as últimas 10 exportações realizadas.

Configurar um novo agendamento exige os dados de acesso ao armazenamento externo, normalmente fornecidos pela equipe de TI da empresa.

Nota: não existe envio por e-mail. Os únicos destinos possíveis de um arquivo exportado são o download direto no navegador ou o armazenamento externo configurado.

Entendendo o arquivo JSON

O arquivo gerado está no formato JSON — um jeito padronizado e universal de escrever informação em texto simples, que pode ser aberto por praticamente qualquer sistema, planilha ou ferramenta de análise:

Chaves { } agrupam um registro — por exemplo, tudo o que descreve uma pessoa.
Colchetes [ ] indicam uma lista de vários registros — por exemplo, a lista de todas as pessoas do hub.
Cada informação aparece como campo: valor, por exemplo "full_name": "João Silva".

O arquivo é organizado com recuo (indentação), o que facilita a leitura mesmo em um editor de texto simples, e usa a codificação UTF-8, que preserva corretamente acentos e caracteres do português.

O nome do arquivo sempre segue o padrão quiker-{nome-do-hub}-{data-e-hora}.json.

Como cada tipo de dado aparece

Tipo	O que representa	Exemplo
Texto	Palavras, nomes, e-mails ou códigos. Aparece sempre entre aspas.	`"João Silva"`
Número	Quantidades e valores. Usa ponto para separar decimais, nunca vírgula, e nunca vem entre aspas.	`150000.00`
Verdadeiro ou falso	Uma resposta do tipo sim/não. Aparece como `true` ou `false`, sem aspas.	`true`
Data	Um dia do calendário, sem horário. Sempre no formato ano-mês-dia.	`"2024-02-15"`
Data e hora	Um instante exato, sempre em UTC. A letra `Z` no final indica esse fuso horário.	`"2024-03-10T09:00:00Z"`
Lista	Vários itens do mesmo tipo, um atrás do outro, entre colchetes.	`[ {…}, {…} ]`
Vazio / não informado	Quando não existe valor para aquele campo. Aparece escrito como `null`, sem aspas.	`null`

Alguns campos de texto, como id, são apenas identificadores internos — servem para ligar uma informação à outra dentro do próprio arquivo, não são feitos para leitura direta.

Onde estão as instruções de cada campo

Este guia explica como usar a exportação e como interpretar o formato geral do arquivo. Mas o significado de cada campo, um por um — o que é stage_name, o que é weight dentro de uma avaliação, o que significa cada status — está descrito em um documento à parte: o Dicionário de Dados, acessível pela página Documentação no menu ou pelo botão “Ver Documentação” na tela de exportação (com opção de baixar em PDF).

O dicionário segue a mesma organização do arquivo exportado (Pessoas, Campanhas, Iniciativas e tudo o que existe dentro de uma iniciativa). Para cada grupo de informação, existe uma tabela com quatro colunas: Campo (nome exato no arquivo), Tipo (um dos tipos acima), Descrição (o que representa) e Exemplo (valor de referência).

Avisos importantes

Fuso horário — todo horário do arquivo está em UTC, 3 horas à frente do horário de Brasília.
Iniciativas repetidas entre arquivos — ao exportar por período, a mesma iniciativa pode aparecer em mais de um arquivo sempre que tiver atividade recente. Isso é esperado, não é duplicidade.
Sem envio por e-mail — a exportação nunca chega por e-mail; ela é baixada na hora ou enviada a um armazenamento externo já configurado.
Link de download temporário — o botão de baixar novamente uma exportação já concluída gera um link válido por apenas 1 hora.
Dados sensíveis — por lidar com informações pessoais, o acesso é restrito a Administradores e cada exportação fica registrada para fins de auditoria.