Ferramenta por ferramenta
Cada bloco abaixo responde quatro coisas na mesma ordem: o que é, para que serve, como se usa e o que ela não faz. Quem quer ver as telas passo a passo tem os tutoriais com capturas; quem vai formar equipe tem o programa de treinamento.
Que pesquisas dá para fazer
O Brasil Dados é um sistema de pesquisa por questionário — quantitativa, com abertura para qualitativa. A tabela diz o que já dá para fazer hoje e com quais ferramentas.
| Tipo de estudo | Com o que se faz no Brasil Dados | Situação |
|---|---|---|
| Eleitoral e intenção de voto | Pergunta espontânea (aberta) e estimulada (fechada), rejeição, cenários de 2º turno como blocos com condição, cotas cruzadas, ponderação RIM, ficha técnica com registro, relatório com empate técnico | completo |
| Opinião pública e social | Escalas, múltipla com teto, saltos condicionais, banner por perfil, significância entre colunas | completo |
| Satisfação de clientes e NPS | Escala 0–10, agrupamentos (nets) para promotor/neutro/detrator, aberta “por quê?” com classificador, tendência entre ondas | completo |
| Tracking (produto, marca, política) | Estudo contínuo com ondas: o mesmo questionário volta a campo e a leitura de tendência sai pronta | completo |
| Clima organizacional | Link de resposta pela internet (uma por aparelho), anonimato por não coletar identificação, banner por área/tempo de casa | completo |
| Imagem corporativa e conhecimento de marca | Espontânea + estimulada, ordem sorteada das opções, nets, cruzamento com perfil | completo |
| Teste de conceito e de embalagem | Sorteio da ordem das opções, blocos com condição para monadic/sequencial, escalas de compra e gosto | completo — sem exibir imagem na tela ainda |
| Omnibus (vários clientes no mesmo campo) | Um estudo com blocos por cliente e o link de resultados liberando só as perguntas de cada um | completo |
| Painel de consumidores | Base de participantes importada, link de resposta por pessoa, estudo contínuo para as ondas | completo |
| Auditoria de loja e cliente oculto | Questionário de observação com GPS e mapa, com foto, áudio e vídeo como resposta | completo |
| Qualitativa com roteiro estruturado | Abertas longas, ditado por voz, gravação do áudio da entrevista e classificador de abertas com livro de códigos; falta a análise temática das abertas | parcial |
| Prioridade de atributos (MaxDiff) e portfólio (TURF) | Pergunta melhor–pior com telas sorteadas e escore; alcance e frequência das combinações, com caminho de acréscimo | completo |
| Conjoint (preço e canibalização) | Desenho de escolha com atributos e níveis | ainda não |
Modelador de Estudos
Onde o questionário nasce. Tudo o que está aqui vale para qualquer forma de coleta: o mesmo roteiro roda no celular, no telefone, no papel e na internet.
Perguntas
O editor de cada pergunta: identificador da variável, tipo, enunciado, obrigatoriedade, opções de resposta com código e rótulo.
Definir o que será perguntado e como a resposta entra na base. O código da opção é o que aparece na tabulação e no SPSS; o rótulo é o que o entrevistado ouve ou lê.
- Escolha o tipo: escolha única, escolha múltipla, aberta de texto, aberta de número ou escala 0–10.
- Escreva o enunciado exatamente como será lido — o entrevistador lê o que está escrito.
- Dê à variável um nome que você reconheça depois (
SEXO,P12A,VOTO_GOV). O sistema só numera pergunta nova; nome já existente nunca é trocado. - Em opções, use código curto e estável (
A,NSNR,LULA) e rótulo em linguagem de entrevista. - Marque exclusiva em “Nenhuma delas” e fixa em “Não sabe” (fixa não entra no sorteio de ordem).
⚙ Propriedades da pergunta
Cada caixa de pergunta no Modelador tem o painel ⚙ Propriedades da pergunta, com quatro grupos: Comportamento (visível no questionário, ocultar o código, manter os dados nas próximas ondas, validar dado único, reprodução sonora), Mensuração (tipo: nominal, ordinal, escalar, numérica, texto; variável de cruzamento; variável de controle; dado pessoal protegido; dado por padrão), Interface de captura (automático, botões de opção ou menu suspenso; colunas) e Modalidades (ordem inversa em casos pares, indentar, ofuscar). O que já mora na própria pergunta — obrigatória, ordem aleatória (em Regras avançadas) e a opção fixa (NS/NR, Nenhum, Outro, sempre no fim) — vale como parte deste painel.
As regras são conferidas na hora, na própria caixa, e de novo pelo servidor ao salvar: ordem aleatória e ordem inversa não convivem; pergunta oculta não pode ser obrigatória; dado pessoal protegido não entra em cruzamento; menu suspenso trava as colunas em 1; mensuração ordinal bloqueia o sorteio das opções. Só o que difere do padrão é gravado no documento.
Regras avançadas da pergunta
Condição (quando a pergunta aparece), saltos (para onde vai depois), validação (mínimos, máximos, número de marcações, tamanho do texto), sorteio da ordem das opções, tempo mínimo na tela e agrupamentos (nets).
Fazer o questionário se comportar como o roteiro manda, sem depender de o entrevistador lembrar. Quem não deve ver a pergunta não a vê; quem responde fora da faixa é barrado na hora.
- Condição: “aparece se P3 = A ou B”. Só pode olhar perguntas anteriores.
- Saltos: por opção (“se marcou NÃO, vá para P10”) ou padrão (“depois desta, vá para P12”).
FIMencerra. - Validação: faixa de número, inteiro, mínimo e máximo de marcações, tamanho do texto.
- Sorteio de opções: tira o viés de ordem em lista de candidatos ou marcas; marque fixa nas saídas para elas ficarem no fim.
- Nets: “ótimo + bom”, “promotores”, “rejeição total” — a soma sai pronta na tabela.
Grade de perguntas, palavra-chave e comentário
A visão de tabela do questionário: Código, Pergunta, Tipo, Palavra-chave, Obrigatória e Comentário, com busca.
Conferir o questionário inteiro de uma vez — é onde se enxerga pergunta sem obrigatoriedade, tema repetido e enunciado fora do padrão. A palavra-chave é o nome curto do tema e aparece nos títulos das tabelas; o comentário é nota interna da equipe e nunca sai para o entrevistado nem para o relatório.
- Clique em ▤ Grade para abrir a tabela; digite em localizar para filtrar por código, texto, tema ou comentário.
- Em cada linha: editar leva ao cartão da pergunta, guardar manda para a Livraria, excluir remove.
- ✓ Revisar textos passa o corretor em todos os enunciados e rótulos de opção de uma vez.
Minha Livraria (perguntas guardadas)
A estante de perguntas do escritório: sexo, idade, escolaridade, renda, avaliação de governo — as suas, no seu jeito de perguntar.
Parar de redigitar (ou de copiar um estudo inteiro só para pegar uma pergunta). A estante se ordena pelo uso, então o que você mais usa fica no alto.
- Para guardar: na grade, clique em guardar na linha da pergunta e dê um nome (“Escolaridade — padrão IBGE”).
- Para usar: abra a Livraria, busque e clique em inserir. A pergunta entra no fim do questionário.
- Dê o nome da variável à pergunta inserida — ela vem sem código de propósito.
Partir de outro estudo (modelo)
Criar um estudo novo a partir de uma pesquisa que já existe ou de um modelo guardado, escolhendo peça por peça o que vem junto.
Repetir o mesmo desenho em outra cidade, outro contratante ou outra onda, sem remontar nada.
- Escolha a origem (pesquisa da casa ou modelo do escritório) e dê o título novo.
- Marque o que trazer: cotas, ponderação, ficha técnica, banner, regras do telefone, livro de códigos.
- Clique em Criar rascunho, confira e publique.
- Para guardar um roteiro que você usa sempre: abra a pesquisa e clique em Salvar como modelo.
- Vêm sempre: perguntas e os nomes das variáveis, sem renumerar.
- Nunca vêm: entrevistas, links e a contagem das cotas — a amostra nova começa do zero.
- Nunca vem: o número de registro da ficha técnica. É de uma pesquisa específica.
Tipo de estudo: período único ou ondas
A escolha entre ad-hoc (o questionário vai a campo uma vez) e contínuo (o mesmo questionário volta a campo em ondas).
Tracking. Marcando contínuo, cada entrevista fica com a onda em que foi feita e o Analisador lê a tendência — sem duplicar o estudo a cada rodada.
- Marque Contínuo e crie as ondas com código curto (
P1,AGO26) e nome (“1ª rodada — agosto”). - Marque em campo na onda que está sendo coletada agora e publique.
- Ao abrir a rodada seguinte, mude a onda “em campo” e publique de novo.
- No Analisador, o bloco Tendência entre ondas mostra a variação com a base de cada rodada.
Sujeito do estudo
Unidade de análise (pessoas ou coisas) e o nome do sujeito no singular e no plural.
O relatório e o painel do cliente passam a dizer “N = 1.200 eleitores” em vez de “1.200 respostas”. Muda a leitura de quem recebe.
Preencha os dois nomes (eleitor/eleitores, cliente/clientes, empresa/empresas). Metade preenchida deixaria o texto desigual, então o sistema só usa quando os dois estão lá.
Cotas da amostra
Quantas entrevistas de cada perfil o estudo aceita — inclusive perfil cruzado (mulher × 25 a 34 × capital).
Fazer a amostra sair como planejada, e não como o campo achou mais fácil. É a diferença entre uma amostra e um monte de entrevistas.
- Escolha a variável e o valor (SEXO = F), o limite e a ação.
- Avisar só sinaliza; travar encerra a entrevista em campo quando a célula enche.
- Para cota interligada, acrescente pares no cruzamento da mesma célula.
- Publique: a situação da amostra aparece no editor e no acompanhamento, com barra por célula.
Ponderação da amostra (RIM)
Raking: ajusta o peso de cada entrevista, por iterações, até a amostra reproduzir as distribuições do universo em cada variável de perfil.
Corrigir amostra com mulheres demais ou jovens de menos, sem precisar do cruzamento entre as variáveis — só das margens (Censo, TSE, PNAD).
- Escolha a variável de perfil e informe a % de cada categoria no universo (tem de somar 100).
- Repita para as outras variáveis (sexo, idade, escolaridade, região).
- Ajuste piso e teto de peso se precisar (padrão 0,3 e 3).
- No Analisador, ligue a chave Ponderar (RIM): tabela, cruzamento e recorte saem ponderados.
Ficha técnica
Contratante, universo, abrangência, metodologia, fonte dos alvos, número de registro, responsável técnico e nível de confiança.
É o que o relatório publica e o que o registro em órgão competente exige na pesquisa eleitoral. O nível de confiança escolhido aqui é o usado na margem de erro de toda a análise.
Banner padrão
O conjunto de perguntas de perfil que vira as colunas da tabela profissional (sexo × idade × escolaridade × região).
Não remontar o cabeçalho da tabela a cada rodada. Guardado no estudo, o banner sai igual em toda leitura e no relatório.
Conferir questionário e publicar
Duas coisas diferentes: a conferência avisa o que custa caro (mesmo quando é permitido) e a publicação recusa o que está formalmente errado.
Achar antes do campo o que só apareceria depois: código de opção repetido (junta duas respostas numa linha da tabela), fechada obrigatória sem saída NS/NR, saída entrando no sorteio, salto por cima de obrigatória, múltipla sem teto, entrevista longa demais, palavra-chave repetida, espaço antes da pontuação, obrigatoriedade que destoa do resto.
- Conferir questionário — leia os avisos; nenhum deles impede publicar.
- ✓ Revisar textos — ortografia de todos os enunciados e rótulos.
- Salvar rascunho — pode salvar quantas vezes quiser; rascunho não vai a campo.
- Publicar — congela uma versão. Só a versão publicada é coletada.
Coleta: as quatro portas
O mesmo questionário publicado atende as quatro formas de coletar. Não há roteiro separado por método, e os dados caem na mesma base — com a origem marcada, para você poder ler cada uma em separado.
Aplicativo de campo (CAPI) — celular e tablet, com ou sem internet
A entrevista pessoal no aparelho do entrevistador. Funciona no navegador (instala como aplicativo, inclusive no iPhone, por Compartilhar → Adicionar à Tela de Início) e como APK Android.
Coleta domiciliar e em ponto de fluxo, onde a internet falha. Baixa os roteiros, coleta offline e sincroniza quando encontra sinal — sem perder entrevista e sem duplicar.
- No painel, cadastre o entrevistador (código e nome) e envie o kit de acesso pelo WhatsApp: link do aplicativo + token.
- Ele abre o aplicativo, cola o token e toca em Atualizar para baixar os roteiros publicados.
- Uma pergunta por tela, seguindo condições e saltos; o botão Voltar existe. O GPS é registrado quando ele autoriza.
- Ao terminar, a entrevista vai para a fila do aparelho e sobe sozinha ao reconectar.
Todo aparelho pede senha para abrir (chave da organização, ligada de fábrica em Estação de Entrevista Móvel → Senha do aplicativo). Se você não definiu uma no botão "Senha do app" do entrevistador, ele mesmo cria a dele ao ativar o aparelho — precisa de internet só nessa hora; depois a senha vale sem sinal. Esqueceu? Você redefine no painel (ou apaga: ele cria outra na próxima abertura com internet). Ele nunca troca a própria senha depois de criada — é o que impede um celular na mão errada de se apropriar do acesso.
Desde o 2.0 o aplicativo se atualiza como um site: publicou-se a parte web nova no servidor (telas + motor), o aparelho baixa o pacote na próxima abertura com internet, confere a integridade, troca e reabre — sem instalar nada, e continua funcionando sem sinal porque o pacote fica guardado no celular. Se a versão baixada não arrancar, na segunda abertura ele volta sozinho para a anterior. Só quando muda a parte nativa (um plugin, uma permissão) é que aparece a faixa Atualizar agora com o APK — e aí o Android pede a confirmação do pesquisador. Nos dois casos as entrevistas, os roteiros e a senha continuam no aparelho. Os questionários alterados também chegam sozinhos, a cada 5 minutos, fora de entrevista.
Estação Telefônica (CATI)
A tela do operador: a fila entrega um número por vez, ele disca, registra o resultado da chamada e, se atenderam, faz a entrevista ali mesmo.
Pesquisa por telefone com equipe em casa ou em call center, sem discador proprietário — o operador entra pelo navegador com e-mail do escritório ou token de entrevistador.
- Ponha números na fila: gere por sorteio ou importe a lista do cliente.
- Defina as regras no Modelador → Telefone: máximo de tentativas, horário de ligação, intervalo de rediscagem por situação e o texto de abertura que o operador lê.
- O operador clica em Próximo contato: a fila entrega um número que ninguém mais está ligando, e agendamentos combinados vêm primeiro.
- Ele registra: atendeu (entrevista), não atende, ocupado, caixa postal, agendar, recusa, número inválido, fora do perfil.
- Não atende, ocupado e caixa postal voltam à fila sozinhos depois do intervalo; recusa e inválido encerram.
Gerador de amostra telefônica (RDD)
O fabricante da lista: sorteia números dentro das faixas válidas do Brasil, com o DDD certo de cada estado.
Fazer pesquisa telefônica nacional sem comprar base. Lista comprada cobre só quem está em cadastro e é frágil diante da LGPD; o sorteio é o padrão da telefônica probabilística.
- Escolha a abrangência: Brasil (27 estados), estados escolhidos, DDDs escolhidos ou só as capitais.
- Diga quantos números e o tipo de linha (celular, fixo ou os dois em 80–20).
- Informe uma semente se quiser poder repetir o sorteio depois (ex.:
onda1-2026). - Ver o plano: confira quantas ligações caem em cada estado e DDD antes de gerar.
- Sortear e pôr na fila: os números entram marcados com DDD, estado, região e tipo de linha.
- Guarde a semente na ficha técnica — é o que permite auditar o desenho depois.
- Entre estados: proporcional à população do Censo 2022, ou aos pesos que você informar (eleitorado, por exemplo).
- Dentro do estado: igual entre os DDDs. Se você tem a distribuição, use DDDs escolhidos e informe a cota de cada um — a cota manda em tudo.
Link de resposta pela internet (CAWI)
Um endereço que a própria pessoa abre e responde, sem login.
Clima organizacional, satisfação de clientes, painel — qualquer coleta em que você tem o contato mas não vai ligar nem visitar.
- Publique a pesquisa (link de rascunho não existe: a resposta precisa de uma versão a que se prender).
- Gere o link com identificação da origem (“E-mail de clientes”, “WhatsApp da associação”) — dá para ler cada origem em separado depois.
- Defina teto de respostas, data limite, uma resposta por aparelho e os textos de abertura e agradecimento.
- Envie o link. Você pode desligar um link a qualquer momento sem mexer nos outros.
Estação de Digitação (PAPI)
A tela para digitar questionário de papel, seguindo o mesmo roteiro e as mesmas validações da coleta eletrônica.
Campo em papel — que segue existindo em zona rural, presídio, escola e onde não se leva aparelho. O digitador não precisa saber programar nada: a tela recusa o que o roteiro recusa.
- Escolha a pesquisa e o entrevistador que fez a entrevista no papel.
- Digite pergunta por pergunta; o ditado por voz ajuda nas abertas.
- Finalize. A entrevista entra na base com origem “papel”.
- Para volume grande, use importar dados em Perfil de Casos com a planilha digitada fora.
Foto, áudio e vídeo na entrevista
Três tipos de pergunta que registram um arquivo: foto (câmera ou galeria; reduzida no aparelho para ~200–400 KB), áudio (gravação curta, até 3 minutos) e vídeo (até 8 MB). No aplicativo de campo os arquivos entram na fila offline (IndexedDB) e sobem antes da resposta quando há internet; no link de resposta sobem na hora do envio. Por telefone e na digitação a pergunta fica "sem registro".
Tipo de pergunta Assinatura na tela: o entrevistado assina com o dedo, a imagem sobe junto com a entrevista e aparece no Perfil de Casos. É a parte da cadeia de provas que ninguém forja em lote — os modelos eleitorais já trazem a pergunta ASSINATURA (opcional) no fim. Não se aplica por telefone.
Marcando Gravar o áudio da entrevista no roteiro, o aplicativo grava a conversa inteira (com aviso na tela; peça o consentimento) e sobe o áudio junto — ele aparece no Perfil de Casos, embaixo das respostas.
No Analisador, a pergunta resume "com registro / sem registro" e mostra a galeria (até 40 arquivos, com o nº da entrevista); no Perfil de Casos cada arquivo abre e baixa. Os arquivos ficam no banco (entram no backup). Mídia não entra em cruzamento nem no banner.
Regras de contradição
Combinações de respostas que não fazem sentido — menor de 16 que votou, avalia ótimo mas diz que a cidade piorou, renda zero e carro importado. Você declara a regra (perguntas, comparadores, valores, E/OU) uma vez; o mesmo motor avisa o entrevistador na hora (ou barra o avanço, se a regra for de bloquear) e a Integridade lista os casos já coletados, com gravidade erro (bloquear) ou aviso (avisar).
A regra só dispara quando todas as perguntas envolvidas foram respondidas. O aviso aparece na pergunta que fecha a contradição, não em toda tela. Na digitação, bloquear impede salvar; avisar pede confirmação.
Mudar o questionário com o campo rodando
Publicar de novo congela uma versão nova (v2, v3…). As entrevistas já feitas ficam presas à versão em que foram coletadas — o servidor confere cada uma contra o roteiro dela. O aplicativo de campo troca de roteiro ao abrir com internet ou ao tocar em Atualizar; uma entrevista em andamento termina na versão em que começou. O painel avisa quantas entrevistas já existem antes de publicar.
Acrescentar pergunta ou opção é seguro (as antigas ficam em branco ali). Remover pergunta ou opção deixa dado órfão: a análise mostra o código no lugar do rótulo; prefira desativar por condição a apagar. Trocar o sentido de uma pergunta mantendo o id mistura duas coisas na mesma coluna — crie um id novo.
Quiosque (autoaplicada em computador fixo)
Não é um módulo separado: é o link de resposta aberto num computador ou tablet parado em recepção, evento ou loja.
- Gere um link de resposta com identificação do ponto (“Recepção — hotel”).
- Desmarque uma resposta por aparelho — no quiosque, muitas pessoas usam o mesmo aparelho.
- Abra o navegador em tela cheia no aparelho do local.
Supervisão do campo
Professor Brasil Dados
Quem ensina a usar o produto dentro do produto. Me mostre esta tela percorre a tela em que você está com um holofote em cada botão, na ordem certa, explicando o que cada um faz. E você pode perguntar como se faz qualquer coisa: a resposta vem do material da ajuda (Central de Ajuda, Tutoriais e Tutorial do processo), com os links das seções usadas.
Sem chave de IA configurada, o Professor trabalha em modo guia: monta a resposta com as seções da ajuda que mais batem com a pergunta. Com a chave configurada no servidor (a mesma do Classificador de Abertas), passa ao modo IA: conversa como um professor, mas só com o que está na ajuda — nunca inventa botão ou tela que não existe.
Duas administrações: a do produto e a da equipe Brasil Dados
Tudo que o instituto cliente usa — Modelar, Coletar, Supervisionar e analisar, Portal do Cliente, Equipe, Suporte, Tutoriais — é o produto licenciado. O que serve para vender e cuidar da licença fica num grupo à parte, no fim do menu, que só a equipe Brasil Dados vê: Comercial (interessados, planos, assinaturas), Clientes e instalações (cada organização: assinatura, ferramentas liberadas, usuários, entrevistadores, pesquisas, entrevistas, último acesso, chamados) e Chamados dos clientes (a fila de atendimento de todas as organizações, com o retrato técnico anexado — responda daqui e o cliente vê na aba Suporte dele).
A organização dona do produto tem a marca fornecedor. Sem ela, o servidor recusa as rotas comerciais e de atendimento (mesmo para um admin) e o painel esconde o grupo. Numa instalação on-premise ninguém é fornecedor: a área some inteira e o cliente vê só o produto.
Produção
A tela de quem manda no campo: numa olhada, o que cada pesquisa, cada estação (aplicativo, telefone, internet, digitação), cada aparelho e cada entrevistador está produzindo — hoje, ontem, nos últimos 7 dias e no total —, onde (o estado pelo GPS das entrevistas e a posição atual do celular) e quanto falta da amostra (a meta é deduzida das cotas; cotas cheias e vagas). Atualiza sozinha a cada 30 segundos.
Os indicadores do alto dizem o ritmo do dia e quantas entrevistas ainda estão dentro dos aparelhos (feitas e não enviadas — o número que o supervisor cobra às 17h). Na tabela de entrevistadores, quem tem aparelho mostra online/sem notícia, a versão do aplicativo, a bateria, onde está e a fila; quem trabalha por telefone, internet ou digitação aparece sem aparelho. A última coluna traz a taxa de confirmação da fiscalização. Filtre por pesquisa para ver só um campo.
Supervisão e Auditoria — fiscalização de 20% e reentrevista por telefone
Sorteia uma fatia da amostra (20% por padrão, mais os casos que a Integridade apontou) para conferir com o próprio entrevistado. É o único teste que responde se a pessoa existiu e falou aquilo — todo o resto olha para o dado. Cada caso fecha como confirmada, divergente, não localizado ou recusou, e o placar por entrevistador mostra a taxa de confirmação.
Em vez de ligar caso a caso pelo painel, mande a fatia para a fila do CATI: o produto cria uma pesquisa curta (“foi entrevistado?” + as perguntas escolhidas), põe os telefones na fila e o operador liga como liga para qualquer outra. Quando a ligação termina, o batimento compara resposta a resposta com a entrevista original e fecha o caso sozinho. Recusa, número inválido ou ninguém atendendo também fecham o caso — como recusou ou não localizado.
1) No Modelador, bloco Reentrevista: diga em que pergunta o entrevistado deixa o telefone (e o nome) e quais respostas conferir — os modelos eleitorais já trazem NOME e TELEFONE no fim. 2) Em Supervisão, escolha a pesquisa e a fatia e clique em Sortear e mandar para a fila. 3) Na Estação Telefônica aparece “Reentrevista — nome da pesquisa”; o operador usa a mesma tela de sempre. 4) De volta à Supervisão, cada caso mostra o telefone, a situação na fila e o botão batimento com o que bateu e o que não bateu. 5) Quando o roteiro grava o áudio da entrevista (Modelador → “Gravar o áudio”), o caso ganha ▶ ouvir a entrevista: ouvir por amostragem é a conferência que não depende de achar a pessoa — e o placar mostra quantas entrevistas de cada entrevistador subiram com áudio.
Acompanhamento do campo
Total de entrevistas, ritmo por dia, produção por entrevistador e situação das cotas — atualizando sozinho.
Saber se o campo vai fechar no prazo e onde está o gargalo. E dar ao cliente uma janela honesta sem abrir a base.
Gere o link de acompanhamento (sem senha, abre no celular) e envie. Só números agregados: nenhuma resposta individual aparece.
Mapa da Coleta
Cada entrevista no mapa, no ponto em que o aparelho registrou, com cor por entrevistador.
Ver se o campo andou onde devia — e enxergar entrevista feita fora da área, todas no mesmo endereço ou a sequência que não fecha com o deslocamento. É supervisão e é prova do serviço para o contratante.
- Escolha a pesquisa. Arraste para andar, roda ou botões + e − para aproximar.
- Clique numa marca para ver a entrevista (número, entrevistador, hora, precisão do aparelho); marca com número é grupo — clique para abrir.
- Filtre por entrevistador e deixe ao vivo ligado para o mapa ir recebendo as entrevistas que chegam.
- Ao gerar o link do cliente, a chave com mapa decide se ele vê isso também — e dá para pôr ou tirar depois, sem trocar o endereço.
Integridade dos Dados
Uma bateria de 16 testes sobre o que já foi coletado, com resultado caso a caso.
Rodar antes de exportar a base ou publicar número. É o passo que separa “recebi as entrevistas” de “posso assinar o resultado”.
- Escolha a pesquisa e o período; deixe todos os testes marcados na primeira rodada.
- Ajuste os parâmetros: duração mínima e máxima, preenchimento mínimo, distância aceita do conjunto, iguais seguidas.
- Executar. O painel por teste mostra verde no que passou; a grade lista os achados.
- Filtre por teste ou só por erros, e exporte para Excel para a equipe corrigir.
- Corrija no Perfil de Casos e rode de novo.
- Fluxo (obrigatório): resposta em pergunta que a condição escondia; obrigatória que apareceu e ficou vazia.
- Limites, faixas e tipos; código de opção inexistente; exclusiva marcada com outras; limite de marcações.
- Resposta fora da trilha percorrida; “Outro” marcado sem o texto; texto sem conteúdo (teclado batido).
- Duração fora do aceitável e entrevista sem hora de término; questionário pouco preenchido; respostas em linha reta.
- Questionários idênticos (possível repetição, com o número do outro caso); múltipla usada como única.
- Entrevista de campo sem GPS; ponto fora do conjunto; cota estourada.
Perfil de Casos
A entrevista, uma a uma: lista com busca, editor de respostas, importação, exclusão com lixeira e histórico de quem mexeu.
Resolver o que a Integridade apontou, digitar caso que veio de fora e tirar da base a entrevista que não deveria estar lá — com registro, porque o instituto assina o número.
- Localizar procura no número do caso, no entrevistador e no conteúdo das respostas.
- abrir mostra a entrevista na versão do roteiro em que foi coletada; corrija e Salvar correção.
- Toda correção entra no histórico do caso: pergunta, antes, depois, quem e quando.
- ⬆ Importar dados: CSV com uma entrevista por linha e uma coluna por pergunta (aceita código ou rótulo; múltipla com
|). - 🗑 Excluir pede a confirmação da quantidade e o motivo; o caso vai para a ♻ Lixeira e volta de lá do jeito que era.
Processar as respostas abertas
Classificador de Abertas
O livro de códigos de cada pergunta aberta e a classificação de cada resposta — à mão, por palavra-chave, ou pela IA quando o servidor tem chave configurada.
“Por que votaria nele?” é texto livre; o relatório precisa de “Honestidade 32%, Experiência 21%”. Classificar transforma texto em categoria e a pergunta ganha uma irmã virtual NOME_COD, que a tabulação, o cruzamento, o banner e o SPSS leem como qualquer fechada.
- Escolha a pesquisa e a pergunta aberta. Os contadores mostram total, codificadas, pendentes de revisão e sem código.
- Monte o livro: Sugerir pelas palavras mostra as expressões mais frequentes; + Código cria a categoria à mão (código curto, rótulo e palavras-chave que aplicam sozinhas).
- Codificar por palavras-chave aplica as regras às respostas sem código.
- Se houver IA configurada, ✨ Codificar com IA classifica o resto no seu livro, com grau de confiança — e tudo entra como pendente de revisão.
- Revise na lista de respostas e Aprovar todas as pendentes quando estiver satisfeito.
Analisador
Tabulação
A frequência de cada pergunta: n e %, com a base sendo quem respondeu aquela pergunta.
É a leitura de sempre — e a primeira conferência de sanidade dos dados. Múltipla escolha é desmembrada opção por opção.
Escolha a pesquisa. Ligue Ponderar (RIM) para a leitura sair ponderada. Use o recorte para ler um subgrupo (só mulheres, só a capital) — o peso é calculado sobre a base inteira e o recorte é aplicado depois, senão cada recorte inventaria uma ponderação própria.
Escala e número trazem, além da distribuição, a estatística descritiva: média, mediana, moda, desvio-padrão, mínimo, máximo, quartis (Q1/Q3) e percentis 10 e 90 — ponderados quando a chave Ponderar está ligada. Vão para o relatório em PDF, Word, Excel e PowerPoint.
Cruzamento
Uma pergunta contra outra (voto × sexo), com percentual na linha, na coluna ou no total, e qui-quadrado com p-valor. Com uma camada (terceira pergunta), o mesmo cruzamento é repetido dentro de cada categoria dela — voto × sexo dentro de cada faixa de idade — e o total vem no fim para comparar. É a leitura em três dimensões (OLAP) sem sair da tela.
Achar onde a diferença está — e saber se ela é diferença mesmo. O qui-quadrado é sempre calculado sobre a contagem bruta, mesmo com a leitura ponderada: teste de significância se faz com caso, não com peso.
Feed da base para Power BI, Excel e Planilhas
Um endereço fixo (/api/publico/base/<token>.csv, .json ou .xlsx) que entrega a base da pesquisa — uma linha por entrevista, só as perguntas que você liberou, rótulos em vez de códigos, e a coluna peso quando a pesquisa pondera. O cliente atualiza o painel dele quando quiser e sempre recebe o que já entrou.
Power BI: Obter dados → Web → colar o endereço .csv. Excel: Dados → Da Web. Google Planilhas: =IMPORTDATA("…csv"). Sistemas: o .json devolve registros com números como número. O servidor responde 304 quando nada mudou (ETag), então atualizar é barato.
Quem tem o endereço lê a base: trate como senha, libere só as perguntas que podem sair (abertas com dado pessoal ficam de fora) e desligue o link quando o contrato acabar.
Painel de participantes (um link por pessoa)
Para painel de consumidores, clima organizacional e amostra de clientes: importe a lista (nome, e-mail, telefone e colunas extras) e cada pessoa recebe um endereço próprio (/p/…). Só ela responde, uma vez só, e o escritório vê quem já respondeu, quem foi convidado e quem falta.
Gere um link de resposta (é ele que dá os textos, o prazo e a origem na base). Cole a lista ou escolha o arquivo; repetidos (mesmo e-mail ou telefone) não entram de novo. Convide por e-mail direto do painel (quando o servidor tem SMTP) com {{nome}} e {{link}}, ou pelo WhatsApp de cada linha, ou exporte a lista com os links para a sua mala direta. Cobre quem falta filtrando "ainda não responderam".
Não guarda quem respondeu o quê junto do nome na análise: a resposta entra na base como qualquer outra (origem internet), e o vínculo com a pessoa fica só no painel, para controle de retorno. Não manda SMS.
NPS (Net Promoter Score)
Uma escala 0–10 ("quanto recomendaria?") lida na convenção do NPS: promotores (9–10), neutros (7–8) e detratores (0–6). O índice é % promotores − % detratores, de −100 a +100.
Na tabulação (faixa colorida e índice), na tabela profissional (três linhas de percentual com letras de significância e a linha do índice), e nos relatórios em PDF, Word, Excel e PowerPoint. Ponderado quando a chave está ligada.
MaxDiff (melhor / pior)
Um tipo de pergunta para priorizar atributos: as opções são os itens (preço, qualidade, entrega…) e cada entrevistado vê várias telas com poucos itens (padrão 4), marcando em cada uma o mais e o menos importante. O desenho das telas é sorteado por entrevista de forma balanceada e reproduzível — o servidor reconstrói o que a pessoa viu sem guardar nada além da resposta.
Para cada item: exibições, vezes escolhido como melhor e como pior, o escore (melhor − pior por exibição, de −100 a +100) e os pontos (participação, soma 100). A tabulação mostra a barra de pontos e a tabela; Word, Excel e PowerPoint levam os mesmos números. A MaxDiff não entra em cruzamento nem na tabela por perfil (não é uma escolha por pessoa) — para comparar grupos, use o recorte da base.
Itens por tela (2 a 6) e número de telas (padrão 3 × itens ÷ itens por tela). Pergunta obrigatória só aceita a resposta com todas as telas marcadas.
Loop de perguntas (repetir por item marcado)
A mesma pergunta feita uma vez para cada item que o entrevistado marcou numa escolha múltipla anterior: "Quais marcas conhece?" e, para cada marca marcada, "Como avalia {item}?". Escreva {item} no enunciado onde o nome do item deve entrar; sem isso o nome vai ao fim. Vale para escolha única e múltipla, escala, número e texto. Se nenhum item foi marcado, a pergunta nem aparece.
Na análise cada item vira uma pergunta própria, com o id da mãe e o código do item: AVAL_A, AVAL_B… Elas entram na tabulação, no cruzamento, na tabela por perfil, no CSV, no SPSS e nos relatórios como qualquer pergunta fechada — a base de cada uma são os entrevistados que marcaram aquele item. A pergunta-mãe guarda o mapa inteiro e é o que se edita no Perfil de Casos; a importação lê as colunas AVAL_A, AVAL_B e remonta a mãe.
A base tem de ser uma múltipla anterior; a pergunta repetida não pode ter salto por opção nem ser base de outro loop. Condição, cota, ponderação, banner e contradição não apontam para a pergunta-mãe (o valor dela é um mapa): na análise, use as perguntas por item. A Integridade confere item a item — item marcado e sem resposta aparece como "Beta: Esta pergunta é obrigatória".
XLSForm — importar e exportar (ODK, KoboToolbox, SurveyCTO)
O XLSForm é o formato universal de questionário como planilha (abas survey, choices e settings), usado por ODK, KoboToolbox e SurveyCTO. Quem vem dessas plataformas traz o acervo sem redigitar: importa o arquivo e nasce um rascunho no Modelador. E qualquer pesquisa do Brasil Dados sai como XLSForm para rodar lá ou para o cliente conferir num formato que ele conhece.
Tipos (escolha única/múltipla, texto, número inteiro/decimal, escala 0–10 como range, foto, áudio, vídeo), obrigatoriedade, validação (mínimo/máximo, caracteres, marcações, opção exclusiva), condições de exibição (relevant), sorteio de opções, o loop por item marcado (begin_repeat com count-selected) e os saltos por opção (viram relevant nas perguntas puladas). Rótulos por idioma: prefere o português. Grupos são achatados; metadados do aparelho, cálculos, geoponto e notas são ignorados com aviso.
O que o XLSForm não sabe dizer vira aviso na hora de exportar: MaxDiff (sai como nota com os itens), tempo mínimo na tela, salto padrão e opção fixa no sorteio. Na importação, condição com and e or misturados, regex e listas em arquivo externo ficam de fora — com aviso para montar no Modelador. Ids com mais de 12 caracteres ou com hífen são ajustados e avisados.
TURF — alcance de combinações
Para uma pergunta de escolha múltipla (sabores que compraria, canais que usa, atributos que valoriza): o alcance de uma combinação é a % de pessoas que marcaram ao menos um dos itens; a frequência é quantos itens da combinação cada pessoa marcou, em média.
Decidir portfólio: com três sabores, quais três atingem mais gente? A tela mostra o caminho de acréscimo (o item que mais soma alcance a cada passo) e as dez melhores combinações de cada tamanho até o limite escolhido (1 a 5). Opção marcada como exclusiva ("nenhum") fica de fora.
Não simula preço nem canibalização — para isso é conjoint, que não existe ainda.
Tabela profissional (banner)
A tabela de mesa de trabalho: perguntas nas linhas, perfis nas colunas, agrupamentos (nets) e letras de significância.
É o formato que instituto entrega e que analista espera — a leitura “coluna B é maior que a coluna C” sem precisar de outro programa.
Tendência entre ondas
A mesma pergunta rodada a rodada, em gráfico de linhas e em tabela, com a base de cada onda.
Tracking: ver o movimento, não só o retrato. É o número que o cliente cobra na segunda rodada em diante.
Exportar a base
A base em duas formas: CSV com rótulos (abre no Excel) e arquivo .sav do SPSS com nomes de variável, rótulos de variável e de valor, dicotomias para múltipla e a variável de peso.
Continuar a análise onde o cliente quiser, sem ficar preso ao produto — e alimentar dashboard próprio.
Relatório completo (PDF, Word, Excel e PowerPoint)
O documento pronto, gerado pelo próprio produto: capa, ficha técnica, principais resultados com empate técnico, pergunta a pergunta com gráfico e tabela, tabela banner por perfil e o questionário em anexo.
Entregar em horas o que costuma levar dias de PowerPoint. Sai em PDF (impressão), em Word (editável, para o instituto acrescentar a leitura dele), em Excel (ficha, resultados e tabela por perfil com os percentuais como número, para somar e fazer gráfico) e em PowerPoint (um slide por pergunta com gráfico nativo, editável no próprio programa). A base também sai em Excel de verdade, com aba Dicionário.
- Confira a ficha técnica e o nome do sujeito (é o que aparece na capa e no “N = …”).
- Decida se a leitura sai ponderada.
- Gere. Para PDF, use imprimir → salvar como PDF na página do relatório.
Entregar ao cliente
Links sem senha
Dois endereços que abrem no celular sem login: um mostra o andamento do campo (e o mapa, se você deixar), o outro mostra resultados das perguntas que você liberar.
Atender o cliente ansioso sem abrir a base e sem criar conta para ele. O link é a chave: quem tem, vê.
- Gere o link com um rótulo que identifique o destinatário (“Cliente X”).
- No link de resultados, marque quais perguntas entram (as estimuladas e o perfil, por exemplo) e se sai ponderado.
- Para tirar o acesso, revogue — o endereço morre na hora.
Portal do Cliente
Área com e-mail e senha, por pessoa, com permissão por pesquisa: andamento, resultados, cruzamentos, tabelas, mapa e download.
Cliente que acompanha várias pesquisas e precisa de acesso nominal — e do qual você quer poder tirar o acesso de uma pesquisa sem tirar das outras.
- Cadastre o cliente e defina a senha inicial (ele troca depois).
- Libere pesquisa por pesquisa, marcando o que ele pode ver: andamento, resultados, respostas abertas, exportar.
- Revogue a liberação quando o contrato daquela pesquisa terminar.
Escrever falando e conferir o texto
Ditado por voz
Escrever falando, em dois caminhos: no navegador (sai na hora) ou no servidor (transcrição local, nada sai da máquina).
Montar questionário mais rápido e, principalmente, digitar resposta aberta sem parar a conversa — no telefone e na digitação de papel isso muda o ritmo do trabalho.
- Clique no campo e depois em 🎤 Ditar; fale; clique em ⏹ Parar.
- No alto da tela, escolha onde transcrever: no navegador (rápido) ou no servidor (privado).
- Confira o texto: transcrição erra nome próprio.
Corretor de texto
Ortografia em português com dicionário do sistema, mais o dicionário do escritório — as palavras que só existem na sua pesquisa.
Achar o “eputado estadual” antes de o questionário ir a campo. Erro de digitação em enunciado sai impresso na tela do entrevistado e no anexo do relatório.
- No campo, clique em ✓ Conferir texto; clique numa sugestão para trocar só aquela ocorrência.
- Nome de candidato, bairro ou sigla nova: clique em aceitar palavra — vale para todo o escritório, em todas as pesquisas.
- Para conferir o questionário inteiro de uma vez, use ✓ Revisar textos na grade.
Administração e instalação
Equipe e papéis
Usuários do escritório (admin e gestor), redefinição de senha, códigos de recuperação e o cadastro de entrevistadores com token de aparelho.
- Admin faz tudo, inclusive mexer em usuários e apagar dados.
- Gestor monta estudo, acompanha e analisa.
- Entrevistador entra só no aplicativo de campo ou na estação telefônica, com token.
- Cliente entra apenas no portal, no que foi liberado para ele.
- Esqueceu a senha: use os códigos de recuperação (Equipe → Meus códigos) — não depende de e-mail configurado.
Licença e modo de avaliação
Um arquivo de licença assinado, com cliente e validade, lido pela instalação.
Sem licença válida, o produto fica em modo de avaliação: monta e testa o questionário, mas não publica para campo. Com licença, tudo liberado até a data de expiração — que aparece na faixa do painel.
Instalação no seu servidor
install.sh · deploy/instalar-voz.sh · INSTALL.mdO produto instalado na máquina, na rede ou no servidor do instituto: Node, PostgreSQL, serviço do sistema e vhost.
Dado de pesquisa é confidencial. Instalado, o estudo não passa por servidor de terceiro, funciona com internet ruim e o backup é seu.
sudo ./install.sh --dominio pesquisa.suaempresa.com.br --admin-email você@… --admin-senha …- Para ditado e corretor no servidor:
sudo deploy/instalar-voz.sh(ou--com-vozna instalação). - Instale a licença e emita o certificado HTTPS com o certbot.
- Confira o backup diário e leve uma cópia para fora da máquina.
Vender e avaliar
Página de planos e pedidos de avaliação
A página pública com os planos, o que o cliente recebe ao contratar e o formulário de pedido de avaliação. O que é preenchido lá cai na aba Comercial do painel.
Atender quem chega pelo site sem depender de planilha nem de memória: cada pedido fica registrado com empresa, contato, cidade, plano de interesse e o que a pessoa contou.
- Em Comercial → Planos e preços, defina valor mensal, anual e limites. Plano sem preço aparece como “valor sob combinação”.
- Acompanhe cada pedido pela situação: novo → contato feito → em teste → proposta → assinado (ou perdido).
- Use anotar para guardar o que foi conversado.
Acesso de avaliação (o teste da ferramenta)
Um espaço fechado para o interessado experimentar: organização própria, usuário administrador, uma pesquisa de demonstração já com entrevistas dentro, e prazo e teto combinados.
Vender software de pesquisa por descrição não funciona. Com o acesso pronto, o instituto abre a tabela, o mapa e o relatório no primeiro minuto — com dados.
- Na linha do interessado, clique em criar teste e informe o prazo (dias) e o teto de entrevistas.
- O painel devolve a mensagem pronta com endereço, usuário e senha — copie ou envie pelo WhatsApp. A senha aparece uma vez só.
- Acompanhe em Assinaturas e testes: quanto falta de prazo e quantas entrevistas já foram usadas.
- Fechou negócio? virou contrato — a coleta fica sem teto e você registra valor e forma de pagamento.
- As entrevistas da demonstração não consomem o teto: a cota é do teste de quem está avaliando.
- Fim do prazo ou teto atingido para a coleta — e só ela. Leitura, análise e exportação do que já foi coletado continuam liberadas.
- Organização sem assinatura (a instalação vendida) não é travada por aqui: lá quem controla é a licença assinada.
Dúvidas que aparecem sempre
Perguntas frequentes
- Posso mudar o questionário com o campo rodando? Sim — publique de novo. Cada entrevista fica presa à versão em que foi coletada. Só não troque código de opção nem nome de variável.
- Perdi o token do entrevistador. Gere outro no cadastro dele. O antigo deixa de valer.
- O aplicativo não sincroniza. A fila do aparelho guarda as entrevistas; ao voltar o sinal elas sobem sozinhas. Reenvio não duplica.
- A cota travou e o entrevistador reclamou. A trava é o desenho da amostra funcionando. Se foi engano, mude o limite e publique de novo.
- Apaguei uma entrevista sem querer. Perfil de Casos → ♻ Lixeira → restaurar. Volta com as respostas e com a vaga na cota.
- O relatório saiu com número diferente da tabela. Confira se as duas leituras estão ponderadas do mesmo jeito e se o recorte é o mesmo.
- Preciso de base de telefone. Não compre: gere por sorteio na Estação Telefônica.
- Onde vejo o que mudou num caso? No histórico do próprio caso: pergunta, antes, depois, quem e quando.