Tutorial do Administrador

Para quem monta a pesquisa, coordena a coleta e entrega os resultados. Segue a ordem em que o trabalho acontece.

1. Visão geral: os três momentos

Toda pesquisa passa por modelar (montar o questionário), coletar (aplicativo, telefone, internet ou papel) e analisar (tabelas, cruzamentos, ficha técnica). O menu à esquerda do painel segue essa ordem; a tela Início tem um atalho para cada tarefa.

2. Entrar e cuidar do acesso

1. Abra viasonda.com.br/admin, entre com e-mail e senha.
2. Na primeira vez, vá em Equipe → Minha senha e troque a senha provisória.
3. Em Equipe → Meus códigos de recuperação → Gerar códigos, guarde os 8 códigos (imprima ou salve no gerenciador de senhas). São o seu "esqueci a senha": na tela de entrada, Esqueci minha senha → e-mail + um código + senha nova. Cada código vale uma vez.
4. Outros usuários do escritório entram por Equipe (papel admin faz tudo; gestor não mexe na equipe).

3. Montar a pesquisa (Modelador de Estudos)

1. + Nova pesquisa, dê o título.
2. + Adicionar pergunta para cada pergunta: tipo (escolha única, múltipla, aberta de texto, número, escala 0–10), enunciado, obrigatória, opções com código curto e estável (ex.: LULA, NSNR) e rótulo. O identificador (P1, P2… ou um nome seu, como SEXO) é o que aparece no SPSS.
3. Regras avançadas de cada pergunta: quando aparece (condição sobre perguntas anteriores), saltos, validação (mínimo/máximo, número de marcações), sorteio da ordem das opções, tempo mínimo na tela, e agrupamentos (nets) como "ótimo + bom".
4. Cotas da amostra: quantas entrevistas de cada perfil (ex.: 550 mulheres). Avisar só sinaliza; travar encerra a entrevista em campo quando a célula enche. Cruze perguntas para cota interligada (mulheres de 16 a 24 na capital).
5. Ponderação da amostra (RIM): a distribuição do universo (Censo/TSE) em sexo, idade, escolaridade… O produto calcula o peso de cada entrevista.
6. Ficha técnica: contratante, universo, abrangência, metodologia, fonte dos alvos, registro (TSE), responsável técnico, nível de confiança.
7. Banners padrão: os perfis que viram colunas da tabela profissional (sexo × idade × escolaridade).
8. Telefone (CATI): tentativas, horário de ligação, intervalos de rediscagem, texto de abertura.
9. Conferir questionário (avisos de qualidade) → Salvar rascunho → Publicar. Só a versão publicada vai a campo; editar depois e publicar de novo cria uma versão nova.

3.1 Grade de perguntas, palavra-chave e Livraria

Cada pergunta tem, além do enunciado: palavra-chave (nome curto do tema — aparece na grade e nos títulos das tabelas) e comentário interno (nota da equipe; nunca é mostrado ao entrevistado nem sai no relatório).

O botão ▤ Grade mostra o questionário inteiro em tabela — Código, Pergunta, Tipo, Palavra-chave, Obrigatória e Comentário — com localizar pergunta e, em cada linha, editar (leva ao cartão), guardar (manda para a Livraria) e excluir.

• ✓ Revisar textos confere a ortografia de todos os enunciados e rótulos de opção de uma vez, listando palavra por palavra com sugestão.
• 📚 Minha Livraria é a estante do escritório: perguntas guardadas (sexo, idade, escolaridade, avaliação…) para inserir em qualquer estudo, com busca e contagem de uso. A peça entra sem condição e sem saltos — eles apontavam para perguntas do estudo antigo — e sem código, para você nomear a variável.
• Conferir questionário passou a avisar também: palavra-chave repetida em duas perguntas (as duas viram a mesma coluna na tabela), palavra-chave faltando em parte das perguntas, capitalização misturada, espaço antes da pontuação, espaço duplo, pergunta sem pontuação final quando as outras têm, e obrigatoriedade que destoa do resto do questionário.

3.2 Repetir um estudo numa amostra nova

Onda seguinte, outra cidade, outro contratante com o mesmo questionário: não refaça as perguntas. Em Modelador de Estudos use 📄 Partir de outro estudo (ou Usar como modelo na linha da pesquisa). Escolha de onde copiar, dê o título novo e marque o que vem junto: cotas, ponderação, ficha técnica, banner, regras do telefone e livro de códigos das abertas.

• As perguntas e os identificadores das variáveis (SEXO, IDADE, P1…) vêm sempre e não são renumerados — é o que faz cota, ponderação e banner continuarem apontando para o lugar certo.
• Nasce um rascunho: nada vai a campo antes de você conferir e publicar.
• Não vêm as entrevistas, os links nem a contagem das cotas. A amostra nova começa do zero.
• O número de registro da ficha técnica nunca é copiado: cada pesquisa tem o seu.

Para guardar um roteiro que você usa sempre, abra a pesquisa e clique em Salvar como modelo; ele passa a aparecer em Modelos do escritório, com Usar, Renomear e Apagar. Apagar um modelo não mexe nos estudos que nasceram dele.

3.3 Escrever falando e conferir o texto

Ao clicar num campo de texto do painel aparecem dois botões embaixo dele:

• 🎤 Ditar — fale e o texto entra no campo, no lugar do cursor. Clique de novo (⏹ Parar) para encerrar. No alto da tela há a escolha de onde a fala é transcrita: no navegador (sai na hora; no Chrome/Edge o áudio passa pelos servidores do Google) ou no servidor (leva alguns segundos e nada sai da máquina — é o caminho para roteiro confidencial e o único que funciona no Firefox). A escolha fica guardada no seu aparelho.
• ✓ Conferir texto — ortografia em português. Mostra as palavras erradas com sugestões; clique numa sugestão para trocar só aquela ocorrência. Código de opção (NSNR, P12A), sigla e número não são apontados.

Nome de candidato, bairro e sigla nova aparecem como erro na primeira vez: clique em aceitar palavra e ela entra no dicionário do escritório — vale para todo mundo do instituto, em todas as pesquisas.

4. Coletar

4.1 Aplicativo (Estação de Entrevista Móvel)

1. Cadastre o entrevistador (código curto + nome) → Cadastrar e gerar kit.
2. Mande o kit de acesso pelo botão Enviar pelo WhatsApp (link do aplicativo, endereço do sistema e token; a mensagem já vai com o passo a passo). O token aparece uma vez só.
3. Acompanhe na lista: Aparelho ativado, Último uso, Entrevistas. Trocou de celular ou perdeu o token → Gerar novo token (o anterior deixa de valer).

4.2 Telefone (Estação Telefônica)

1. Aba Estação Telefônica → escolha a pesquisa publicada → cole ou envie a lista (telefone;nome;bairro;…). Repetidos são ignorados; colunas extras aparecem para o operador.
2. Os operadores entram em viasonda.com.br/cati com o e-mail do escritório ou o token de entrevistador e clicam Próximo contato. A fila nunca entrega o mesmo número a dois operadores; retornos agendados vêm primeiro; fora do horário ela não entrega.
3. Acompanhe: prontos, agendados, em atendimento, entrevistas, recusas, esgotados, entrevistas por ligação e a produtividade por operador. Devolver à fila libera um contato preso.

4.2.1 Amostra telefônica por sorteio (não precisa comprar lista)

Na Estação Telefônica, o bloco Gerar amostra por sorteio (RDD) fabrica os números: escolha a abrangência (Brasil com os 27 estados, estados escolhidos, DDDs escolhidos ou só as capitais), quantos números quer, o tipo de linha (celular, fixo ou os dois) e — se quiser repetir o sorteio depois — a semente. Clique em Ver o plano para conferir quantas ligações caem em cada estado e DDD, e em Sortear e pôr na fila para os números entrarem na fila do operador, já marcados com DDD, estado, região e tipo de linha.

• Os números saem das faixas válidas do país (celular de 9 dígitos começando em 9 com segundo dígito de 6 a 9; fixo começando em 2 a 5) e com o DDD certo de cada estado.
• A divisão entre estados é proporcional à população do Censo 2022; dentro do estado, igual entre os DDDs. Se o instituto tem a distribuição dele (eleitorado, por exemplo), use DDDs escolhidos e informe a cota de cada um — a cota manda em tudo.
• O sorteio é reproduzível: com a mesma semente sai a mesma amostra. Guarde a semente na ficha técnica — é o que permite auditar o desenho depois.
• Aproveitamento da amostra mostra, por área, quantas entrevistas cada 100 números renderam e quantos eram inválidos. É a conta que diz se o excedente sorteado vai dar conta das entrevistas contratadas.

4.3 Papel (Estação de Digitação)

Escolha a pesquisa, digite as respostas do questionário de papel e salve; a entrevista entra com origem papi e passa pelas mesmas validações.

4.4 Internet (link de resposta)

Na pesquisa publicada, Gerar link de resposta com validade, teto e textos; distribua por WhatsApp, e-mail ou QR. As respostas chegam com origem cawi e o rótulo do link como "entrevistador".

4.5 Acompanhar o campo

Gere o Link de acompanhamento para o cliente ver total, ritmo por dia, por entrevistador e cotas — nunca respostas individuais. A situação das cotas aparece embaixo do editor da pesquisa.

4.6 Mapa da Coleta: onde cada entrevista foi feita

O aplicativo registra o ponto de GPS no momento da entrevista. Em Mapa da Coleta (menu à esquerda) escolha a pesquisa e veja cada entrevista no mapa, com cor por entrevistador. Arraste para andar, use a roda ou os botões + e − para aproximar, clique numa marca para ver a entrevista (número, entrevistador, hora e precisão do aparelho); marcas com número são grupos — clique para abrir. O filtro mostra um entrevistador só, e ao vivo deixa o mapa acrescentando as entrevistas que chegam.

Os contadores dizem quantas entrevistas têm e quantas não têm localização. Sem ponto quer dizer GPS negado ao aplicativo ou aparelho sem posição na hora; questionário de papel e resposta pela internet não geram ponto.

4.7 Perfil de Casos (abrir e corrigir a entrevista)

Em Perfil de Casos está a lista de entrevistas recebidas — número do caso, entrevistador, origem, quando chegou, duração, quantas respostas e se tem localização. Há localizar (procura no número, no entrevistador e no conteúdo das respostas) e recorte por período.

• abrir mostra a entrevista pergunta por pergunta, na versão do roteiro em que ela foi coletada, e permite corrigir a resposta digitada errada. Toda correção fica no histórico do caso: pergunta, valor antes, valor depois, quem mexeu e quando.
• ⬆ Importar dados lê um CSV com uma entrevista por linha e uma coluna por pergunta — aceita o código ou o rótulo da opção (é o que volta quando alguém edita a planilha exportada), múltipla separada por |. Cada linha passa pela mesma conferência da coleta; o que não bate é listado com o motivo e o resto entra. Reimportar o mesmo arquivo não duplica a base.
• 🗑 Excluir exige confirmar a quantidade (o servidor recusa se a conta não bater) e pede o motivo. Nada é perdido: o caso vai para a ♻ Lixeira com todas as respostas e volta de lá do jeito que era — inclusive devolvendo a vaga na cota.

4.8 Integridade dos dados (antes de analisar)

Depois do campo e antes de exportar a base ou publicar número, rode a bateria em Integridade dos Dados. Escolha a pesquisa, o período e os testes (todos vêm marcados; o de fluxo é obrigatório e não desmarca), ajuste os parâmetros e clique em Executar.

O resultado sai caso a caso — número da entrevista, entrevistador, pergunta e o que está errado — separando erro (o dado está furado) de aviso (merece olhada). Dá para filtrar por teste ou só por erros e exportar para Excel.

O que é conferido: resposta em pergunta que a condição escondia e obrigatória vazia; limites, faixas e tipos; código de opção inexistente; opção 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; múltipla usada como única; entrevista de campo sem GPS; ponto fora do conjunto; e cota estourada.

5. Respostas abertas (Classificador de Abertas)

1. Escolha a pesquisa e a pergunta aberta.
2. Monte o livro de códigos: + Código; Sugerir pelas palavras (termos mais frequentes) ou ✨ Propor com IA (quando a IA estiver configurada). Cada código pode ter palavras-chave que o aplicam sozinhas.
3. Codificar por palavras-chave (e/ou ✨ com IA). Ou clique nos códigos ao lado de cada resposta — manual é sempre revisado.
4. Filtre pendentes de revisão, corrija e Aprovar todas as pendentes.

A pergunta codificada aparece no Analisador como múltipla escolha (P4_COD) — em tabelas, cruzamentos, banner, Excel e SPSS.

6. Analisar (Analisador)

1. Escolha a pesquisa. Ligue Ponderar (RIM) se ela tem ponderação — o resumo passa a mostrar n efetivo e eficiência, e a margem de erro correta.
2. Tabulação: cada pergunta com barras, colunas, pizza ou tabela (o formato fica lembrado). O recorte da base limita tudo a um grupo (ex.: só mulheres).
3. Cruzamento: uma pergunta contra outra (voto × sexo), % na linha, coluna ou total, com o teste qui-quadrado dizendo se a diferença passa do acaso.
4. Tabela profissional (banner): escolha o banner ("Perfil básico") e o que vai nas linhas. Percentual na coluna e letras: "40% B" quer dizer que 40% nesta coluna é maior, além do acaso, que a coluna B do mesmo bloco. Nets aparecem como linha; escalas ganham média. Coluna com base abaixo de 30 sai com *.
5. Ponderação aplicada: amostra × ponderado × alvo por variável, eficiência de Kish. Abaixo de 70% a amostra veio torta demais.
6. Ficha técnica: pronta com período, n por forma de coleta, margem, cotas planejado × realizado, ponderação. Imprimir / PDF para anexar ao relatório; ela lista o que falta preencher.
7. 📄 Relatório completo: com as abertas já codificadas, um clique monta o relatório inteiro — capa, sumário, ficha técnica, principais resultados (com empate técnico marcado), cada pergunta com gráfico e tabela, resultados por perfil (banner) e o questionário em anexo. Imprimir / salvar PDF ou Baixar em Word (.docx editável, com tabelas e barras). O cliente também tem os dois botões no link de resultados.
8. Exportar: CSV/Excel (uma linha por entrevista, com a coluna de peso), SPSS .sav (com rótulos, dicotomias das múltiplas e a variável PESO — use WEIGHT BY PESO), e a tabela banner em CSV no layout do relatório.

7. Dar acesso ao cliente (Portal do Cliente)

1. Aba Portal do Cliente → cadastre nome, e-mail e senha (ou sorteie).
2. Libere a pesquisa e marque o que ele vê: resultados, abertas (texto livre pode identificar pessoas), download.
3. Ele entra em viasonda.com.br/cliente. Você pode redefinir a senha dele e desligar o acesso sem apagar.

8. Programa para Windows e servidor próprio

O Brasil Dados Desktop (área de downloads) trabalha com um arquivo .sonda local e sincroniza com o servidor (aba Servidor). O sistema também se instala no servidor do instituto (install.sh); manual de instalação no INSTALL.md.

9. Problemas comuns

Tutorial do Entrevistador

Para quem coleta com o aplicativo no celular (ou pelo telefone, na estação).

1. Instalar e ativar o aplicativo

1. Abra a mensagem do escritório (kit de acesso). Toque no link do aplicativo e em Baixar o aplicativo (Android).
2. O celular avisa que o app não vem da loja: Baixar assim mesmo → abra o arquivo → Permitir desta fonte (se pedir) → Instalar → se o Play Protect reclamar, Instalar assim mesmo.
3. Abra o Brasil Dados Campo e cole o endereço do sistema e o token da mensagem. Só aqui precisa de internet.
4. Toque em Atualizar para baixar os roteiros. Pronto: a coleta funciona sem sinal.

No iPhone e no iPad

A Apple não permite instalar aplicativo fora da App Store, então no iPhone o aplicativo entra pela tela de início — e depois funciona igual: ícone próprio, tela cheia, roteiro no aparelho e coleta sem sinal.

1. Abra viasonda.com.br/campo no Safari (no Chrome do iPhone o botão de instalar não aparece).
2. Toque em Compartilhar (o quadrado com a seta para cima) e role até Adicionar à Tela de Início.
3. Abra a coleta sempre pelo ícone novo e ative com o mesmo endereço e token do kit.

2. Fazer a entrevista

1. Escolha a pesquisa e toque em Iniciar entrevista.
2. Leia a pergunta como está escrita. Uma pergunta por tela; o app pula sozinho o que não se aplica e não deixa avançar com pergunta obrigatória vazia ou resposta fora do limite.
3. Voltar corrige a anterior. Algumas perguntas têm tempo mínimo na tela — espere o contador.
4. Se aparecer "cota cheia": agradeça e encerre; aquele perfil já completou. Nada é gravado.
5. Ao terminar, a entrevista vai para a fila do aparelho. Com internet ela sobe sozinha; o contador mostra quantas ainda faltam enviar.

2.1 Ditar a resposta aberta

Nas perguntas de resposta livre aparece o botão 🎤 Ditar embaixo do campo: toque, fale a resposta da pessoa e toque em ⏹ Parar. Confira o que foi escrito antes de seguir — a transcrição erra nome próprio. Na estação telefônica isso poupa o tempo de digitar enquanto o entrevistado espera.

3. Cuidados

• Permita a localização: a entrevista grava onde foi feita (o supervisor confere o campo). Sem ela, a coleta segue, só sem coordenada.
• Não saia da conta enquanto o contador de entrevistas a enviar não estiver zerado.
• Se o escritório mudar o questionário, toque em Atualizar antes de continuar.
• Celular sem Android ou sem poder instalar: use viasonda.com.br/campo no navegador, com o mesmo token (no iPhone, adicione à tela de início).

4. Telefone (estação CATI)

1. Entre em viasonda.com.br/cati com e-mail e senha do escritório ou com o seu token.
2. Escolha a pesquisa e toque em Próximo contato. Aparece nome, telefone (toque para discar), dados da lista, texto de abertura e o histórico do número.
3. Registre o resultado: Atendeu abre a entrevista ali; Não atende / Ocupado / Caixa postal voltam sozinhos à fila depois de um tempo; Agendar retorno marca dia e hora; Recusou / Número inválido / Fora do perfil encerram; Devolver à fila libera sem contar.
4. A pessoa desligou no meio? Interromper e registre o resultado (agende, se combinou).

Tutorial do Cliente

Para quem contratou a pesquisa e acompanha o campo e os resultados pelo portal.

1. Entrar

1. Abra viasonda.com.br/cliente com o e-mail e a senha que o instituto enviou. Trocar senha fica no topo.
2. Escolha a pesquisa. Você só vê o que o instituto liberou para você.

2. O que cada aba mostra

3. Como ler

• Recorte da base (acima das abas) limita tudo a um grupo — ex.: só evangélicos. Ponderar (RIM) aplica os pesos que corrigem a amostra para o universo; a margem de erro mostrada já considera isso.
• Letras na tabela: "40% B" significa que 40% nesta coluna é maior, além do acaso, que na coluna B do mesmo bloco (95% de confiança). Coluna com * tem base pequena: leia com cautela.
• Margem de erro vale para o total; recortes e colunas menores têm margens maiores.
• Respostas abertas (texto livre) só aparecem se o instituto liberar; normalmente você as vê já codificadas em categorias.

4. Link de acompanhamento (sem senha)

Se o instituto deixou o mapa ligado, o link e o portal mostram Onde as entrevistas foram feitas: cada ponto é uma entrevista, no lugar em que o aparelho registrou. Arraste para andar, aproxime para separar os pontos e clique numa marca para ver a hora e o entrevistador. O mapa acompanha o campo ao vivo; o conteúdo das respostas nunca aparece.

O instituto pode enviar dois tipos de link sem senha: o de acompanhamento (só o andamento do campo) e o de resultados (gráficos, cruzamentos e tabela banner das perguntas liberadas, com recorte da base). Abrem em qualquer celular; guarde o link, ele é a sua chave.