Brasil Dados · Central de Ajuda

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.

O ciclo do trabalho, em uma linha: monta o questionário → confere e publica → coleta (celular, telefone, papel ou internet) → acompanha o campo → confere a integridade dos dados → classifica as respostas abertas → analisa e pondera → entrega relatório e acesso ao cliente. Cada seção desta ajuda segue essa ordem.

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 estudoCom o que se faz no Brasil DadosSituação
Eleitoral e intenção de votoPergunta 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écnicocompleto
Opinião pública e socialEscalas, múltipla com teto, saltos condicionais, banner por perfil, significância entre colunascompleto
Satisfação de clientes e NPSEscala 0–10, agrupamentos (nets) para promotor/neutro/detrator, aberta “por quê?” com classificador, tendência entre ondascompleto
Tracking (produto, marca, política)Estudo contínuo com ondas: o mesmo questionário volta a campo e a leitura de tendência sai prontacompleto
Clima organizacionalLink de resposta pela internet (uma por aparelho), anonimato por não coletar identificação, banner por área/tempo de casacompleto
Imagem corporativa e conhecimento de marcaEspontânea + estimulada, ordem sorteada das opções, nets, cruzamento com perfilcompleto
Teste de conceito e de embalagemSorteio da ordem das opções, blocos com condição para monadic/sequencial, escalas de compra e gostocompleto — 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 umcompleto
Painel de consumidoresBase de participantes importada, link de resposta por pessoa, estudo contínuo para as ondascompleto
Auditoria de loja e cliente ocultoQuestionário de observação com GPS e mapa, com foto, áudio e vídeo como respostacompleto
Qualitativa com roteiro estruturadoAbertas 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 abertasparcial
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éscimocompleto
Conjoint (preço e canibalização)Desenho de escolha com atributos e níveisainda não
Como ler “parcial”: a pesquisa é possível, mas falta uma ferramenta que muda o resultado — em auditoria de loja, a foto; em qualitativa, o áudio e a leitura por tema. Preferimos dizer isso do que empurrar um recurso pela metade.

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

Modelador de Estudos → + Nova pesquisa → + Adicionar pergunta
O que é

O editor de cada pergunta: identificador da variável, tipo, enunciado, obrigatoriedade, opções de resposta com código e rótulo.

Para que serve

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ê.

Como se usa
  1. Escolha o tipo: escolha única, escolha múltipla, aberta de texto, aberta de número ou escala 0–10.
  2. Escreva o enunciado exatamente como será lido — o entrevistador lê o que está escrito.
  3. 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.
  4. Em opções, use código curto e estável (A, NSNR, LULA) e rótulo em linguagem de entrevista.
  5. Marque exclusiva em “Nenhuma delas” e fixa em “Não sabe” (fixa não entra no sorteio de ordem).
Cuidado: não troque o código de uma opção depois de começar a coleta — as respostas já gravadas continuam com o código antigo e as duas viram categorias diferentes na tabela.
O que não faz: não exibe imagem, áudio ou vídeo como estímulo, e não grava mídia como resposta.

⚙ 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

Dentro de cada pergunta → mais opções
O que é

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).

Para que serve

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.

Como se usa
  • 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”). FIM encerra.
  • 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.
Cuidado: tempo mínimo conta desde que a pergunta apareceu na tela, não a cada opção marcada. Valores altos prendem o entrevistador.
O que não faz: não sorteia a ordem de blocos de perguntas (só das opções dentro da pergunta).

Grade de perguntas, palavra-chave e comentário

Modelador → ▤ Grade
O que é

A visão de tabela do questionário: Código, Pergunta, Tipo, Palavra-chave, Obrigatória e Comentário, com busca.

Para que serve

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.

Como se usa
  1. Clique em ▤ Grade para abrir a tabela; digite em localizar para filtrar por código, texto, tema ou comentário.
  2. Em cada linha: editar leva ao cartão da pergunta, guardar manda para a Livraria, excluir remove.
  3. ✓ Revisar textos passa o corretor em todos os enunciados e rótulos de opção de uma vez.
Cuidado: duas perguntas com a mesma palavra-chave viram a mesma coluna no relatório. Dê nomes que se distinguem — “Senador espontâneo” e “Senador estimulado”.

Minha Livraria (perguntas guardadas)

Modelador → 📚 Minha Livraria
O que é

A estante de perguntas do escritório: sexo, idade, escolaridade, renda, avaliação de governo — as suas, no seu jeito de perguntar.

Para que serve

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.

Como se usa
  1. Para guardar: na grade, clique em guardar na linha da pergunta e dê um nome (“Escolaridade — padrão IBGE”).
  2. Para usar: abra a Livraria, busque e clique em inserir. A pergunta entra no fim do questionário.
  3. Dê o nome da variável à pergunta inserida — ela vem sem código de propósito.
Cuidado: a peça guardada perde condição e saltos. Eles apontavam para perguntas do estudo antigo e, inseridos em outro questionário, quebrariam a entrevista. Refaça a condição no estudo novo.

Partir de outro estudo (modelo)

Modelador → 📄 Partir de outro estudo · ou “Usar como modelo” na lista
O que é

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.

Para que serve

Repetir o mesmo desenho em outra cidade, outro contratante ou outra onda, sem remontar nada.

Como se usa
  1. Escolha a origem (pesquisa da casa ou modelo do escritório) e dê o título novo.
  2. Marque o que trazer: cotas, ponderação, ficha técnica, banner, regras do telefone, livro de códigos.
  3. Clique em Criar rascunho, confira e publique.
  4. Para guardar um roteiro que você usa sempre: abra a pesquisa e clique em Salvar como modelo.
O que vem e o que não vem
  • 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.
Quando NÃO usar: para outra rodada do mesmo estudo, prefira o estudo contínuo com ondas — assim a tendência sai pronta em vez de você comparar dois estudos separados.

Tipo de estudo: período único ou ondas

Modelador → Tipo de estudo
O que é

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).

Para que serve

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.

Como se usa
  1. Marque Contínuo e crie as ondas com código curto (P1, AGO26) e nome (“1ª rodada — agosto”).
  2. Marque em campo na onda que está sendo coletada agora e publique.
  3. Ao abrir a rodada seguinte, mude a onda “em campo” e publique de novo.
  4. No Analisador, o bloco Tendência entre ondas mostra a variação com a base de cada rodada.
Cuidado: o código da onda vira a variável TEMPO na base. Não mude depois de coletar, e não repita código — duas ondas com o mesmo código viram uma só na tendência.
O que não faz: não recalcula peso entre ondas automaticamente — a ponderação é do estudo, e vale para todas as rodadas.

Sujeito do estudo

Modelador → Sujeito do estudo
O que é

Unidade de análise (pessoas ou coisas) e o nome do sujeito no singular e no plural.

Para que serve

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.

Como se usa

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

Modelador → Cotas da amostra
O que é

Quantas entrevistas de cada perfil o estudo aceita — inclusive perfil cruzado (mulher × 25 a 34 × capital).

Para que serve

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.

Como se usa
  1. Escolha a variável e o valor (SEXO = F), o limite e a ação.
  2. Avisar só sinaliza; travar encerra a entrevista em campo quando a célula enche.
  3. Para cota interligada, acrescente pares no cruzamento da mesma célula.
  4. Publique: a situação da amostra aparece no editor e no acompanhamento, com barra por célula.
Como a trava funciona de verdade: a contagem é do banco, não da tela. Duas entrevistas na última vaga, exatamente uma entra. Cota de avisar continua contando depois de cheia — é assim que o supervisor vê “6 de 5”.

Ponderação da amostra (RIM)

Modelador → Ponderação da amostra
O que é

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.

Para que serve

Corrigir amostra com mulheres demais ou jovens de menos, sem precisar do cruzamento entre as variáveis — só das margens (Censo, TSE, PNAD).

Como se usa
  1. Escolha a variável de perfil e informe a % de cada categoria no universo (tem de somar 100).
  2. Repita para as outras variáveis (sexo, idade, escolaridade, região).
  3. Ajuste piso e teto de peso se precisar (padrão 0,3 e 3).
  4. No Analisador, ligue a chave Ponderar (RIM): tabela, cruzamento e recorte saem ponderados.
Leia a eficiência: o produto mostra o n efetivo (Kish) e a margem de erro sobre ele. Eficiência abaixo de 70% quer dizer amostra torta demais — o caminho é voltar ao campo, não aumentar o peso.

Ficha técnica

Modelador → Ficha técnica
O que é

Contratante, universo, abrangência, metodologia, fonte dos alvos, número de registro, responsável técnico e nível de confiança.

Para que serve

É 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.

Cuidado: em pesquisa eleitoral, registro e responsável técnico são obrigação legal. Preencha antes de publicar número.

Banner padrão

Modelador → Banners
O que é

O conjunto de perguntas de perfil que vira as colunas da tabela profissional (sexo × idade × escolaridade × região).

Para que serve

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

Modelador → Conferir questionário → Salvar rascunho → Publicar
O que é

Duas coisas diferentes: a conferência avisa o que custa caro (mesmo quando é permitido) e a publicação recusa o que está formalmente errado.

Para que serve

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.

Como se usa
  1. Conferir questionário — leia os avisos; nenhum deles impede publicar.
  2. ✓ Revisar textos — ortografia de todos os enunciados e rótulos.
  3. Salvar rascunho — pode salvar quantas vezes quiser; rascunho não vai a campo.
  4. Publicar — congela uma versão. Só a versão publicada é coletada.
Publicar de novo no meio do campo é seguro: cada entrevista se prende à versão em que foi coletada, e as conferências de dados usam a versão dela. O que não se deve fazer é trocar código de opção ou nome de variável.

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

viasonda.com.br/campo · aplicativo em /aplicativo · painel: Estação de Entrevista Móvel
O que é

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.

Para que serve

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.

Como se usa
  1. No painel, cadastre o entrevistador (código e nome) e envie o kit de acesso pelo WhatsApp: link do aplicativo + token.
  2. Ele abre o aplicativo, cola o token e toca em Atualizar para baixar os roteiros publicados.
  3. Uma pergunta por tela, seguindo condições e saltos; o botão Voltar existe. O GPS é registrado quando ele autoriza.
  4. Ao terminar, a entrevista vai para a fila do aparelho e sobe sozinha ao reconectar.
Senha do aparelho

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.

Atualização do aplicativo

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.

Cuidado: o token aparece uma única vez — guarde a mensagem do kit. Se perder, gere outro. E cota que trava encerra a entrevista antes de começar, ainda no aparelho.
O que não faz: não lê código de barras. (Foto, áudio e vídeo como resposta e a gravação da entrevista já existem — veja Foto, áudio e vídeo na entrevista.)

Estação Telefônica (CATI)

viasonda.com.br/cati · painel: Estação Telefônica
O que é

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.

Para que serve

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.

Como se usa
  1. Ponha números na fila: gere por sorteio ou importe a lista do cliente.
  2. 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ê.
  3. 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.
  4. Ele registra: atendeu (entrevista), não atende, ocupado, caixa postal, agendar, recusa, número inválido, fora do perfil.
  5. Não atende, ocupado e caixa postal voltam à fila sozinhos depois do intervalo; recusa e inválido encerram.
Cuidado: a fila é atômica — dois operadores nunca recebem o mesmo número. Quem fecha o navegador no meio retoma o contato que já tinha.
O que não faz: não disca por VoIP nem grava a ligação. A discagem é no aparelho do operador.

Gerador de amostra telefônica (RDD)

Estação Telefônica → Gerar amostra por sorteio (RDD)
O que é

O fabricante da lista: sorteia números dentro das faixas válidas do Brasil, com o DDD certo de cada estado.

Para que serve

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.

Como se usa
  1. Escolha a abrangência: Brasil (27 estados), estados escolhidos, DDDs escolhidos ou só as capitais.
  2. Diga quantos números e o tipo de linha (celular, fixo ou os dois em 80–20).
  3. Informe uma semente se quiser poder repetir o sorteio depois (ex.: onda1-2026).
  4. Ver o plano: confira quantas ligações caem em cada estado e DDD antes de gerar.
  5. Sortear e pôr na fila: os números entram marcados com DDD, estado, região e tipo de linha.
  6. Guarde a semente na ficha técnica — é o que permite auditar o desenho depois.
Como a divisão é feita
  • 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.
O que o sorteio não garante: que o número exista — em RDD a maioria não existe, e é por isso que se gera excedente (o painel de Aproveitamento da amostra mostra quanto está rendendo); nem o município de quem atende, porque DDD é área e a portabilidade leva número para outro estado. Confirme a cidade com pergunta de triagem no começo do questionário.

Link de resposta pela internet (CAWI)

Modelador → pesquisa publicada → Link de resposta
O que é

Um endereço que a própria pessoa abre e responde, sem login.

Para que serve

Clima organizacional, satisfação de clientes, painel — qualquer coleta em que você tem o contato mas não vai ligar nem visitar.

Como se usa
  1. Publique a pesquisa (link de rascunho não existe: a resposta precisa de uma versão a que se prender).
  2. Gere o link com identificação da origem (“E-mail de clientes”, “WhatsApp da associação”) — dá para ler cada origem em separado depois.
  3. Defina teto de respostas, data limite, uma resposta por aparelho e os textos de abertura e agradecimento.
  4. Envie o link. Você pode desligar um link a qualquer momento sem mexer nos outros.
A cota vale aqui também: perfil com célula cheia é recusado no link, senão ele seria a porta dos fundos da amostra.

Estação de Digitação (PAPI)

painel: Estação de Digitação
O que é

A tela para digitar questionário de papel, seguindo o mesmo roteiro e as mesmas validações da coleta eletrônica.

Para que serve

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.

Como se usa
  1. Escolha a pesquisa e o entrevistador que fez a entrevista no papel.
  2. Digite pergunta por pergunta; o ditado por voz ajuda nas abertas.
  3. Finalize. A entrevista entra na base com origem “papel”.
  4. Para volume grande, use importar dados em Perfil de Casos com a planilha digitada fora.

Foto, áudio e vídeo na entrevista

Modelador → tipos Foto / Áudio / Vídeo; Gravação da entrevista; app de campo e link de resposta; Perfil de Casos; Analisador
O que é

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".

Assinatura na tela

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.

Gravação da entrevista

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.

Onde se vê

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

Modelador → Regras de contradição; coleta (todas as portas); Integridade dos dados
O que é

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).

Detalhe

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

Modelador → editar → Publicar (versão nova)
Como funciona

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.

O que pensar antes

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)

link de resposta aberto no computador do local
O que é

Não é um módulo separado: é o link de resposta aberto num computador ou tablet parado em recepção, evento ou loja.

Como se usa
  1. Gere um link de resposta com identificação do ponto (“Recepção — hotel”).
  2. Desmarque uma resposta por aparelho — no quiosque, muitas pessoas usam o mesmo aparelho.
  3. Abra o navegador em tela cheia no aparelho do local.
O que não faz: não há modo quiosque com senha de saída nem reinício automático entre respondentes.

Supervisão do campo

Professor Brasil Dados

painel: botão 🎓 Professor (canto inferior direito)
O que é

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.

Modo guia e modo IA

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

painel: grupo "Brasil Dados — fornecedor" (só aparece para a organização fornecedora)
O que é

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).

Como funciona por baixo

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

painel: Supervisionar e analisar → Produção
O que é

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.

Como ler

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

painel: Supervisão e Auditoria · Estação Telefônica (fila “Reentrevista — …”)
O que é

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.

Reentrevista

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.

Como se usa

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.

Cuidado: entrevista sem telefone fica marcada “conferir à mão”; dois casos com o mesmo número, só o primeiro entra na fila. A pergunta do telefone não é obrigatória para o entrevistado — mas um entrevistador com muitas entrevistas “sem telefone” é, ele mesmo, um sinal.

Acompanhamento do campo

Modelador → pesquisa → Link de acompanhamento · portal do cliente
O que é

Total de entrevistas, ritmo por dia, produção por entrevistador e situação das cotas — atualizando sozinho.

Para que serve

Saber se o campo vai fechar no prazo e onde está o gargalo. E dar ao cliente uma janela honesta sem abrir a base.

Como se usa

Gere o link de acompanhamento (sem senha, abre no celular) e envie. Só números agregados: nenhuma resposta individual aparece.

Mapa da Coleta

painel: Mapa da Coleta · no mesmo link do cliente
O que é

Cada entrevista no mapa, no ponto em que o aparelho registrou, com cor por entrevistador.

Para que serve

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.

Como se usa
  1. Escolha a pesquisa. Arraste para andar, roda ou botões + e − para aproximar.
  2. Clique numa marca para ver a entrevista (número, entrevistador, hora, precisão do aparelho); marca com número é grupo — clique para abrir.
  3. Filtre por entrevistador e deixe ao vivo ligado para o mapa ir recebendo as entrevistas que chegam.
  4. 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.
Privacidade: ponto e horário apontam onde a pessoa foi entrevistada. Num link sem senha, quem tiver o endereço vê. Decida por cliente.
O que não faz: telefone, papel e internet não geram ponto — o contador mostra quantas entrevistas ficaram sem localização.

Integridade dos Dados

painel: Integridade dos Dados
O que é

Uma bateria de 16 testes sobre o que já foi coletado, com resultado caso a caso.

Para que serve

Rodar antes de exportar a base ou publicar número. É o passo que separa “recebi as entrevistas” de “posso assinar o resultado”.

Como se usa
  1. Escolha a pesquisa e o período; deixe todos os testes marcados na primeira rodada.
  2. Ajuste os parâmetros: duração mínima e máxima, preenchimento mínimo, distância aceita do conjunto, iguais seguidas.
  3. Executar. O painel por teste mostra verde no que passou; a grade lista os achados.
  4. Filtre por teste ou só por erros, e exporte para Excel para a equipe corrigir.
  5. Corrija no Perfil de Casos e rode de novo.
O que é conferido
  • 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.
Erro × aviso: erro é dado furado (código que não existe, obrigatória vazia); aviso merece olhada (linha reta, duração longa). O produto separa os dois em vez de gritar igual para tudo.

Perfil de Casos

painel: Perfil de Casos
O que é

A entrevista, uma a uma: lista com busca, editor de respostas, importação, exclusão com lixeira e histórico de quem mexeu.

Para que serve

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.

Como se usa
  1. Localizar procura no número do caso, no entrevistador e no conteúdo das respostas.
  2. abrir mostra a entrevista na versão do roteiro em que foi coletada; corrija e Salvar correção.
  3. Toda correção entra no histórico do caso: pergunta, antes, depois, quem e quando.
  4. ⬆ Importar dados: CSV com uma entrevista por linha e uma coluna por pergunta (aceita código ou rótulo; múltipla com |).
  5. 🗑 Excluir pede a confirmação da quantidade e o motivo; o caso vai para a ♻ Lixeira e volta de lá do jeito que era.
Cota acompanha a correção: trocar o sexo de um caso move a ocupação da célula. O contador da amostra continua dizendo a verdade.
Reimportar o mesmo arquivo não duplica — a identidade da linha sai do próprio conteúdo. É a proteção para quem não sabe se a importação anterior terminou.

Processar as respostas abertas

Classificador de Abertas

painel: Classificador de Abertas
O que é

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.

Para que serve

“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.

Como se usa
  1. Escolha a pesquisa e a pergunta aberta. Os contadores mostram total, codificadas, pendentes de revisão e sem código.
  2. 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).
  3. Codificar por palavras-chave aplica as regras às respostas sem código.
  4. 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.
  5. Revise na lista de respostas e Aprovar todas as pendentes quando estiver satisfeito.
Revisão humana não é enfeite: a IA (quando ligada) marca o que fez e com quanta confiança, e nada entra como definitivo sem alguém aprovar. Sem chave de IA no servidor, palavras-chave e classificação manual funcionam igual.
O que não faz ainda: não unifica grafias antes de classificar (“marcos rocha”, “Rocha”, “Coronel Marcos” como a mesma pessoa) — isso está na fila de construção.

Analisador

Tabulação

painel: Analisador
O que é

A frequência de cada pergunta: n e %, com a base sendo quem respondeu aquela pergunta.

Para que serve

É a leitura de sempre — e a primeira conferência de sanidade dos dados. Múltipla escolha é desmembrada opção por opção.

Como se usa

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.

Numéricas

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

Analisador → Cruzamentos
O que é

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.

Para que serve

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

Modelador → pesquisa → Links do cliente → Feed da base
O que é

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.

Como se usa

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.

Cuidado

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)

Modelador → pesquisa publicada → Link de resposta pela internet → Painel de participantes
O que é

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.

Como se usa

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".

O que não faz

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)

Modelador → pergunta de escala → Regras avançadas → "ler como NPS"; Analisador
O que é

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.

Onde aparece

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)

Modelador → tipo "MaxDiff (melhor / pior)"; todas as portas de coleta; Analisador
O que é

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.

Como se lê

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.

Regras avançadas

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)

Modelador → pergunta → "repetir para cada item marcado em"; todas as portas de coleta; Analisador; Perfil de Casos; importação
O que é

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.

Como se lê

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.

Regras avançadas

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)

Pesquisas → "⬆ Importar XLSForm"; Modelador → "⬇ XLSForm"
O que é

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.

O que vai e o que volta

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.

Regras avançadas

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

Analisador → TURF (escritório e portal do cliente)
O que é

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.

Para que serve

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.

O que não faz

Não simula preço nem canibalização — para isso é conjoint, que não existe ainda.

Tabela profissional (banner)

Analisador → Tabelas
O que é

A tabela de mesa de trabalho: perguntas nas linhas, perfis nas colunas, agrupamentos (nets) e letras de significância.

Para que serve

É o formato que instituto entrega e que analista espera — a leitura “coluna B é maior que a coluna C” sem precisar de outro programa.

Leia as letras com a base: a letra indica diferença significativa contra a coluna marcada. Coluna com base pequena tende a não acusar diferença — não é ausência de diferença, é falta de caso.

Tendência entre ondas

Analisador → Tendência entre ondas (só em estudo contínuo)
O que é

A mesma pergunta rodada a rodada, em gráfico de linhas e em tabela, com a base de cada onda.

Para que serve

Tracking: ver o movimento, não só o retrato. É o número que o cliente cobra na segunda rodada em diante.

Compare com a base à vista: ondas têm bases diferentes, e uma variação de dois pontos com n=300 por onda pode ser oscilação. O produto mostra o n de cada ponto justamente para isso.

Exportar a base

Analisador → Exportar CSV · Exportar SPSS (.sav)
O que é

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.

Para que serve

Continuar a análise onde o cliente quiser, sem ficar preso ao produto — e alimentar dashboard próprio.

Antes de exportar, rode a Integridade. Base exportada com problema volta como retrabalho — e às vezes como número publicado errado.

Relatório completo (PDF, Word, Excel e PowerPoint)

Analisador → 📄 Relatório completo
O que é

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.

Para que serve

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.

Como se usa
  1. Confira a ficha técnica e o nome do sujeito (é o que aparece na capa e no “N = …”).
  2. Decida se a leitura sai ponderada.
  3. Gere. Para PDF, use imprimir → salvar como PDF na página do relatório.

Entregar ao cliente

Portal do Cliente

viasonda.com.br/cliente · painel: Portal do Cliente
O que é

Área com e-mail e senha, por pessoa, com permissão por pesquisa: andamento, resultados, cruzamentos, tabelas, mapa e download.

Para que serve

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.

Como se usa
  1. Cadastre o cliente e defina a senha inicial (ele troca depois).
  2. Libere pesquisa por pesquisa, marcando o que ele pode ver: andamento, resultados, respostas abertas, exportar.
  3. Revogue a liberação quando o contrato daquela pesquisa terminar.

Escrever falando e conferir o texto

Ditado por voz

botão 🎤 nos campos de texto do painel, da digitação e da estação telefônica
O que é

Escrever falando, em dois caminhos: no navegador (sai na hora) ou no servidor (transcrição local, nada sai da máquina).

Para que serve

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.

Como se usa
  1. Clique no campo e depois em 🎤 Ditar; fale; clique em ⏹ Parar.
  2. No alto da tela, escolha onde transcrever: no navegador (rápido) ou no servidor (privado).
  3. Confira o texto: transcrição erra nome próprio.
Diferença que importa: no Chrome e no Edge, o caminho “navegador” envia o áudio para os servidores do Google. Roteiro antes de publicar traz nome de candidato e de contratante — para esses casos, use o caminho no servidor, que também é o único que funciona no Firefox.
O que não faz: não grava a entrevista inteira nem transcreve áudio enviado de fora (ainda).

Corretor de texto

botão ✓ Conferir texto nos campos · ✓ Revisar textos na grade
O que é

Ortografia em português com dicionário do sistema, mais o dicionário do escritório — as palavras que só existem na sua pesquisa.

Para que serve

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.

Como se usa
  1. No campo, clique em ✓ Conferir texto; clique numa sugestão para trocar só aquela ocorrência.
  2. Nome de candidato, bairro ou sigla nova: clique em aceitar palavra — vale para todo o escritório, em todas as pesquisas.
  3. Para conferir o questionário inteiro de uma vez, use ✓ Revisar textos na grade.
O que não faz: não corrige gramática nem estilo — é ortografia. Código de opção (NSNR, P12A) e sigla não são apontados de propósito.

Administração e instalação

Equipe e papéis

painel: Equipe
O que é

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.

Como se usa
  • 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

faixa no alto do painel · Ajuda: /api/licenca
O que é

Um arquivo de licença assinado, com cliente e validade, lido pela instalação.

Como funciona

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.md
O que é

O produto instalado na máquina, na rede ou no servidor do instituto: Node, PostgreSQL, serviço do sistema e vhost.

Para que serve

Dado de pesquisa é confidencial. Instalado, o estudo não passa por servidor de terceiro, funciona com internet ruim e o backup é seu.

Como se usa
  1. sudo ./install.sh --dominio pesquisa.suaempresa.com.br --admin-email você@… --admin-senha …
  2. Para ditado e corretor no servidor: sudo deploy/instalar-voz.sh (ou --com-voz na instalação).
  3. Instale a licença e emita o certificado HTTPS com o certbot.
  4. 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

/planos (pública) · painel: Comercial
O que é

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.

Para que serve

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.

Como se usa
  1. Em Comercial → Planos e preços, defina valor mensal, anual e limites. Plano sem preço aparece como “valor sob combinação”.
  2. Acompanhe cada pedido pela situação: novo → contato feito → em teste → proposta → assinado (ou perdido).
  3. Use anotar para guardar o que foi conversado.
Preço vazio é melhor que preço inventado: a página diz “sob combinação” em vez de mostrar um número que você não confirmou.

Acesso de avaliação (o teste da ferramenta)

painel: Comercial → criar teste
O que é

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.

Para que serve

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.

Como se usa
  1. Na linha do interessado, clique em criar teste e informe o prazo (dias) e o teto de entrevistas.
  2. O painel devolve a mensagem pronta com endereço, usuário e senha — copie ou envie pelo WhatsApp. A senha aparece uma vez só.
  3. Acompanhe em Assinaturas e testes: quanto falta de prazo e quantas entrevistas já foram usadas.
  4. Fechou negócio? virou contrato — a coleta fica sem teto e você registra valor e forma de pagamento.
Como a trava funciona
  • 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.
Por que a leitura não trava: tomar de volta o trabalho de quem estava avaliando é a pior forma de vender. O que acaba é o direito de coletar mais.

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.