# Pesquisas

> O módulo de espaço Pesquisas. Como a equipe cria um espaço de uma pesquisa ou de várias, monta o questionário em seções no editor que já é a tela de resposta (de um modelo NPS, satisfação, evento, curso, eNPS ou em branco), abre para quem tem acesso ao espaço com um convite por e-mail e/ou pelo link público sem login, identificada ou anônima, e lê o resultado com filtros e CSV.

A **pesquisa** é um questionário da equipe, com várias perguntas organizadas em **seções**, para quem tem acesso a um espaço da comunidade e/ou para qualquer pessoa com o **link público**. Serve para medir o NPS da comunidade, a satisfação com um evento ou um curso, o eNPS de uma empresa, ou o que mais a equipe quiser perguntar, sem Google Forms nem Typeform, com o resultado consolidado dentro da comunidade.

**Pesquisas** é um [módulo de espaço](/conceitos/modulos), na aba **Comunidade** de **Adicionar Espaço**. Toda pesquisa mora num espaço de Pesquisas, e **quem tem acesso ao espaço é o público dela**.

## Pesquisa ou enquete

| | [Enquete](/espacos/enquetes) | Pesquisa |
|---|---|---|
| O que é | Uma pergunta, de 2 a 10 opções, publicada como post | Um questionário: seções, até 100 perguntas, 5 tipos de pergunta |
| Onde aparece | No Feed ou num espaço de Conteúdo, com reações e comentários | Num espaço de Pesquisas, numa tela própria de resposta, em etapas; nada vai para o Feed |
| Quem responde | Quem vê o post | Quem tem acesso ao espaço e/ou qualquer pessoa com o link público, sem login |
| Anonimato | A equipe vê quem votou em quê | Identificada ou anônima, escolhida antes de abrir |
| Resultado | Barras no próprio post | Painel por seção, NPS, filtros e CSV |

Para uma pergunta rápida no dia a dia, a enquete. Para um feedback estruturado, a pesquisa.

## Para que serve

| Comunidade | Pesquisa |
|---|---|
| Evento | A pesquisa de satisfação do evento, respondida pelo link também por quem não é membro |
| Escola online | O feedback de um curso: conteúdo, instrutor, aplicabilidade |
| Coworking | O NPS dos residentes, uma vez por semestre |
| Empresa | O eNPS da equipe, anônimo |

## Como funciona

### O espaço: uma pesquisa ou várias

Ao criar o espaço, **Como o espaço funciona** pergunta:

| Modo | Como fica |
|---|---|
| **Várias pesquisas** (o padrão) | Uma lista de pesquisas. A equipe vê todas, com os filtros **Todas**, **Rascunhos**, **Agendadas**, **Abertas** e **Encerradas** (a agendada mostra *Abre em…*), e cria com **Nova pesquisa**; o membro vê as que pode responder, com **Responder** ou **Respondida**, e a marca **Obrigatória** nas obrigatórias |
| **Uma pesquisa** | O espaço é uma pesquisa: quem abre cai direto nela. A equipe vê o editor (ou o resultado, depois de aberta); o membro, o formulário. Vazio, mostra **Criar pesquisa** para a equipe |

**Uma pesquisa** só vale com no máximo uma pesquisa no espaço (rascunhos e encerradas contam): trocar para ele com duas ou mais é recusado, e uma segunda pesquisa também. O modo muda depois nas configurações do espaço.

**O espaço nasce com a pesquisa.** Em **Uma pesquisa**, **Próximo** leva a um terceiro passo, **Pesquisa**, na mesma janela: **Comece por** (um modelo ou **Em branco**), **Título da pesquisa** (obrigatório), **Descrição**, **Modo** (identificada ou anônima) e **Tipo de resposta**. **Criar pesquisa** cria o espaço e a pesquisa, em rascunho, e já abre o editor dela: *"A pesquisa nasce como rascunho: ninguém recebe nada até você abrir."* Se a pesquisa for recusada, o espaço fica criado, o passo continua com o que foi digitado e só a pesquisa é tentada de novo. Os espaços de [uma chamada](/espacos/chamada-de-trabalhos) e de [um curso](/espacos/cursos#cursos-no-modo-um-curso-so) funcionam igual: terminam abertos na chamada ou no curso.

Um exemplo: um espaço **Pesquisa do evento**, no modo **Uma pesquisa**, privado para quem comprou o ingresso; e um espaço **Pesquisas**, no modo **Várias pesquisas**, aberto aos membros, com o NPS do semestre e as pesquisas de cada curso.

### Quem faz o quê

| Quem | O que faz |
|---|---|
| Proprietário e administrador | Tudo: criam o espaço e as pesquisas, editam o rascunho, ligam o link, abrem, encerram, excluem, veem o resultado e as respostas e exportam o CSV |
| Membro (e moderador e financeiro) | Com acesso ao espaço, responde às pesquisas abertas dele, no espaço ou pelo convite por e-mail |
| Quem não tem conta | Responde pelo link público, se a pesquisa estiver aberta e com o link ligado; nada mais |

### Os modelos

**Nova pesquisa** abre a escolha do modelo. As perguntas vêm prontas, no idioma da comunidade, e tudo se edita antes de abrir.

| Modelo | O que vem | Modo |
|---|---|---|
| **NPS da comunidade** | Uma seção: a nota de 0 a 10 e *"O que mais pesou na sua nota?"* | Identificada |
| **Pesquisa de satisfação** | Uma seção: a satisfação geral de 1 a 5, em estrelas, e um comentário | Identificada |
| **Feedback do evento** | Quatro seções: **Conteúdo** (palestras e temas), **Infraestrutura** (local, alimentação, Wi-Fi), **Experiência** (organização, NPS do evento e comentário) e **Perfil** (*"Esta foi a sua primeira vez no evento?"*). As avaliações usam Excelente, Bom, Regular, Ruim e Não se aplica | Anônima, com o link público ligado |
| **Feedback do curso** | Uma seção: conteúdo, instrutor e aplicabilidade, com a mesma escala, e *"O que poderia melhorar?"* | Identificada |
| **eNPS** | Uma seção: *"o quanto você recomendaria a empresa como um lugar para trabalhar?"* e o porquê | Anônima |
| **Em branco** | Uma seção vazia, para montar do zero | Identificada |

### Seções

Toda pesquisa tem **pelo menos uma seção**, com título e descrição opcional; cada pergunta pertence a uma seção. Para quem responde, as seções são **etapas**:

- O **título** e a **introdução** da pesquisa abrem a primeira tela, com o modo (anônima ou identificada), o número de etapas e de perguntas e o botão **Começar**.
- No alto, a barra com o título de cada etapa (*Conteúdo · Infraestrutura · Experiência · Perfil*). No celular, ela vira *"Etapa 2 de 4 · Infraestrutura"*. Uma pesquisa de uma seção só não mostra a barra.
- **Avançar** só passa com as obrigatórias da etapa respondidas; **Voltar** mantém o que foi marcado; **Enviar** aparece na última etapa.
- A resposta é gravada **uma vez só, no Enviar**. Nada fica salvo no servidor pela metade: se a pessoa fechar a aba antes, começa de novo.

No resultado, as perguntas aparecem agrupadas por seção, na mesma ordem. Uma pesquisa tem até **20 seções** e **100 perguntas**.

### O editor

Montar a pesquisa é editar **a própria tela de quem responde**, com as cores da comunidade, como no editor de [campanhas](/notificacoes/campanhas-de-email):

- **Clique para escrever** no lugar: título, introdução, título e descrição da seção, enunciado, ajuda e alternativas.
- As **seções** aparecem como as etapas, em abas no alto do canvas; **Seção** cria uma nova. **Excluir seção** apaga as perguntas dela junto, depois de confirmar.
- O **+** entre as perguntas insere uma pergunta (um dos 5 tipos) ou uma seção nova.
- **Arraste** pela alça para reordenar as perguntas dentro da seção; arraste uma pergunta até a aba de outra etapa para movê-la para lá; arraste as abas para reordenar as seções. **Mover para seção**, **Subir** e **Descer**, no painel, fazem o mesmo sem arrastar.
- O **painel** da pergunta selecionada tem **Tipo**, **Obrigatória**, as opções da escala, **Duplicar** (copia as alternativas junto, útil quando a mesma escala se repete) e **Excluir**.
- **Computador** e **Celular** mudam a largura; **Prévia** percorre as etapas como quem responde, com **Enviar (prévia)**, sem gravar nada.

No alto ficam **Público e link**, **Modo**, **Tipo de resposta**, **Período**, **Prévia**, **Salvar rascunho** e **Abrir** (ou **Agendar**, com um início no futuro). Numa agendada, **Cancelar agendamento** no lugar de **Abrir**; numa aberta, **Encerrar**. Ao lado do título aparece **Alterações não salvas** ou **Tudo salvo**.

A barra do editor mostra só o título, o estado e a ação principal; as configurações viram resumos clicáveis, e **Pausar**, **Encerrar** e **Excluir** ficam em **Mais ações**. O aviso do modo fica acima da introdução, e uma pesquisa **identificada** cuja introdução fala em anonimato mostra *"A introdução fala em anonimato, mas a pesquisa é identificada."*, com **Corrigir texto**. Os modelos mostram as primeiras perguntas antes de escolher.

### Os 5 tipos de pergunta

| Tipo | Como responde | Detalhes |
|---|---|---|
| **Escolha única** | Uma alternativa | De 2 a 30 alternativas, sem repetir |
| **Múltipla escolha** | Uma ou mais alternativas | De 2 a 30 alternativas |
| **Escala** | Um número de um mínimo a um máximo | Mínimo 0 ou 1, máximo de 2 a 10, rótulos opcionais nas pontas (*Muito insatisfeito*, *Muito satisfeito*); **Mostrar como estrelas** usa uma escala de 1 a 5 em estrelas |
| **NPS (0 a 10)** | Uma nota de 0 a 10 | O resultado calcula o NPS (ver [O resultado](#o-resultado)) |
| **Texto** | Uma resposta escrita | Curta ou **Resposta longa**, até 5.000 caracteres |

Qualquer pergunta pode ser **Obrigatória**. Não há lógica condicional (pular perguntas conforme a resposta), matriz nem envio de arquivo.

### Identificada ou anônima

O **Modo** se escolhe no rascunho e **não muda depois de aberta**. A introdução diz o modo antes da primeira pergunta.

| Modo | O que a equipe vê |
|---|---|
| **Identificada** | A resposta de cada membro ligada ao nome dele, com a data. Quem responde pelo link público sem entrar aparece como **Visitante**, com a data |
| **Anônima** | Só o conjunto: nenhum nome, nenhum horário, nenhuma lista de quem respondeu ou de quem falta, nem quantos faltam |

Na anônima, a introdução diz exatamente: *"Pesquisa anônima: a comunidade não consegue ligar a resposta a você."* É essa a promessa: a comunidade (equipe, API, assistente, CSV) não tem como saber quem respondeu o quê. A resposta é guardada sem a pessoa e sem horário, separada do registro de que ela já respondeu, e as respostas nunca aparecem na ordem em que chegaram.

Os cuidados da anônima:

- **Mínimo de 3 respostas.** Antes disso, o resultado mostra *"O resultado aparece com 3 respostas"* e nenhum número nem texto.
- **Publicação em blocos de 3.** As respostas entram no resultado de 3 em 3, sempre 3 novas da mesma origem (membros ou visitantes). O número de respostas cresce de 3 em 3, e uma resposta sozinha nunca muda o resultado: comparar duas leituras não revela o que uma pessoa respondeu.
- **Filtro só por origem.** Na anônima, o resultado se filtra apenas por **membros** ou **visitantes**; grupo, tag e empresa ficam só para a identificada. O recorte aparece quando ele **e o resto** têm pelo menos 3 respostas cada. Sem a regra do resto, um recorte de 3 numa pesquisa de 4 entregaria a quarta pessoa pela diferença.
- **Textos embaralhados e sem data.**
- **CSV sem pessoa, sem segmento, sem origem e sem data**, só a partir de 3 respostas e só com as respostas já publicadas nos blocos de 3.

> [!WARNING]
> Numa pesquisa **identificada**, a resposta é dado pessoal da comunidade, que é a controladora. Não pergunte sobre saúde, religião, opinião política ou outro dado sensível numa pesquisa identificada; se precisar, use a anônima.

### Público e link

O público é **quem tem acesso ao espaço**: a [visibilidade](/conceitos/visibilidade-e-acesso) dele e, num espaço privado, os grupos, produtos e planos de **Quem tem acesso**. A pesquisa precisa de **alguém com acesso ao espaço, do link público ligado, ou dos dois**.

- **Público**: **Público e link** mostra quantas pessoas têm acesso ao espaço hoje (até 50.000), com alguns nomes. Para mudar quem responde, mude o acesso do espaço. O público é **congelado quando a pesquisa abre**: quem ganhar acesso ao espaço depois não entra nela.
- **Convite por e-mail**: ao abrir, com a caixa **Avisar por e-mail** marcada (o padrão), cada pessoa do público recebe **um** e-mail de convite, 10 minutos depois, com o botão **Responder**, se deixou a categoria **Pesquisas** ligada em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade). Editar a pesquisa depois não reenvia. O botão leva ao mesmo endereço para todos, então o e-mail não liga ninguém a uma resposta anônima.
- **Link para os membros**: o endereço do convite. Quem tem acesso ao espaço responde por ele, com login, ou direto no espaço. Quem abre logado e não tem acesso vê *"Esta pesquisa não é para você"* (a não ser que o link público esteja ligado).

  O link do convite abre a pesquisa **dentro do espaço dela**, com o menu da comunidade. Quem responde cai no formulário (ou em **Respondida** e **Encerrada**, conforme o caso); o proprietário e o administrador caem no editor, se a pesquisa é rascunho ou agendada, ou no resultado, se está aberta ou encerrada. Se nenhum espaço do menu da pessoa tem a pesquisa, a tela de resposta avulsa explica por quê. Num espaço de **Várias pesquisas**, o endereço do navegador acompanha a pesquisa aberta: dá para copiar, mandar para alguém da equipe e recarregar a página sem voltar para a lista.

- **Espaço**: no rascunho, a pesquisa pode ir para outro espaço de Pesquisas.
- **Link público**: qualquer pessoa com o link responde **sem login**, no domínio da própria comunidade (o personalizado, se houver, ou o endereço dela em `memberfy.net`, como `clube.memberfy.net/s/…`), com a marca da comunidade, mesmo que a comunidade seja privada (a página mostra só a pesquisa). **Copiar** copia o endereço; desligar faz o link dizer *"Este link não está disponível"*. O endereço é longo e aleatório: não dá para adivinhar o de outra pesquisa.

**Quem já respondeu.** Pelo link público, a resposta repetida é barrada **por esforço, não com garantia**:

- **Quem abre o link sem entrar** recebe um marcador **neste navegador** (a tela avisa: *"Guardamos um marcador neste navegador só para evitar resposta repetida"*). No mesmo navegador, a segunda tentativa vê *"Você já respondeu neste navegador. Obrigado!"*. **Uma janela anônima, outro navegador, outro aparelho ou os dados do navegador apagados respondem de novo.** Se a pesquisa precisa de uma resposta por pessoa de verdade, use o público da comunidade, sem o link público.
- **Quem abre logado e é membro da comunidade da pesquisa** responde **como membro**, uma vez só de verdade, em qualquer navegador: a segunda tentativa vê *"Você já respondeu"*. A resposta segue o modo da pesquisa. Logado em outra comunidade, conta como visitante.

**Contra robôs e abuso**, o link público tem:

- uma **verificação contra robôs** feita pelo próprio navegador, em cerca de um segundo, sem clicar em nada e sem enviar dados a terceiros (se ela falhar, a tela pede para enviar de novo);
- um limite de **300 envios a cada 10 minutos por rede**, por pesquisa (acima, *"Muitos envios desta rede. Espere alguns minutos e tente de novo."*);
- um teto de **5.000 respostas de visitantes** por pesquisa; as respostas de membros não contam no teto;
- e a equipe pode **desligar o link** a qualquer momento.

O endereço de rede de quem responde não é guardado com a pesquisa.

### Período e agendamento

**Período** define o **Início** e o **Fim** da coleta, no fuso da comunidade: *"Fora desse período ninguém responde."* O fim precisa ser depois do início.

- **Sem Início** (*Ao abrir*), a pesquisa começa quando a equipe clicar em **Abrir**.
- **Com um Início no futuro**, o botão vira **Agendar**. A confirmação diz quando ela abre e a partir de quando sai o convite por e-mail: *"A pesquisa abre sozinha em … e o convite por e-mail sai a partir de …. Nada é enviado antes disso."* Na hora marcada, a pesquisa **abre sozinha**, exatamente como se a equipe tivesse clicado em **Abrir**: o público é congelado nesse momento e o convite sai 10 minutos depois (se **Avisar por e-mail** ficou marcado ao agendar).
- **Agendada**, ela continua **editável como um rascunho**, inteira (perguntas, modo, tipo de resposta, período). **Cancelar agendamento** (ou remover o Início) a devolve a rascunho: *"Agendamento cancelado: a pesquisa voltou a rascunho."*
- **Com Fim**, ela encerra sozinha na data e hora escolhidas. Sem Fim, fica aberta até alguém da equipe **Encerrar**.

**Fora do período, ninguém responde, por nenhum caminho** (no espaço, pelo link do convite ou pelo link público). Antes do início, a tela diz *"Esta pesquisa ainda não começou"* e quando ela abre; depois do fim, ou encerrada, o link público mostra *"Pesquisa encerrada"*. **Uma pesquisa encerrada não reabre**; as respostas e o resultado continuam disponíveis.

### Tipo de resposta

**Tipo de resposta** diz o quanto a comunidade conta com a resposta. Escolhe-se no rascunho (ou no passo **Pesquisa** do espaço de uma pesquisa) e **trava ao abrir**.

| Tipo | Para quem está no público |
|---|---|
| **Pesquisa opcional** (o padrão) | O convite por e-mail e a pesquisa no espaço. Nenhuma janela no app: *"Ninguém é cobrado."* |
| **Pesquisa obrigatória** | Marcada como **Obrigatória** na lista e na tela de resposta (*"Esta pesquisa é obrigatória: a equipe conta com a sua resposta."*), e o convite diz que a resposta é obrigatória. Ao entrar no app, a janela *"Uma pesquisa espera a sua resposta"*, com **Agora não** |
| **Resposta imediata** | Como a obrigatória, mas a janela não tem **Agora não** nem fecha: *"Para continuar usando o app, responda a esta pesquisa."* Ela sai quando a pessoa responde ou quando a pesquisa encerra |

O tipo vale para quem entrou no público ao abrir; quem ganhou acesso ao espaço depois vê a pesquisa como opcional. Na identificada, obrigatória e imediata mostram no resultado quem falta responder (ver [O resultado](#o-resultado)).

Depois de aberta, a estrutura trava: só mudam o **título**, a **introdução**, o **Fim** do período e o **link público** (ligar ou desligar), com **Salvar alterações**. O **Início**, o **Modo** e o **Tipo de resposta** não mudam mais.

Excluir o espaço exclui as pesquisas dele e desliga os links públicos.

### Quem sai da comunidade

Quando um membro sai da comunidade (por conta própria, removido pela equipe, pelo assistente, no fim do vínculo com a empresa ou ao recusar um convite de importação), **as respostas identificadas dele são apagadas de verdade**, e o resultado recalcula. As respostas **anônimas ficam**, porque não há como saber de quem são. É a única exceção à regra de a Memberfy guardar os dados da comunidade.

## Passo a passo

### Criar o espaço

*Papel: proprietário ou administrador.*

1. No menu, embaixo da seção, clique em **Adicionar Espaço**.
2. Na aba **Comunidade**, escolha **Pesquisas** e clique em **Próximo**.
3. Escreva o título, escolha a **Visibilidade** (e, se for **Privada**, **Quem tem acesso**): é quem vai responder.
4. Em **Como o espaço funciona**, escolha **Várias pesquisas** ou **Uma pesquisa**. Com **Várias pesquisas**, crie o espaço.
5. Com **Uma pesquisa**, **Próximo** leva ao passo **Pesquisa**: escolha o modelo (ou **Em branco**), o título, a descrição, o **Modo** e o **Tipo de resposta**, e clique em **Criar pesquisa**. O espaço e a pesquisa nascem juntos e o editor abre; siga de [Criar e abrir a pesquisa](#criar-e-abrir-a-pesquisa), passo 3.

Ver [Criar e organizar espaços](/espacos/criar-e-organizar-espacos).

### Criar e abrir a pesquisa

1. No espaço, clique em **Nova pesquisa** (no modo **Uma pesquisa**, **Criar pesquisa**).
2. Escolha um modelo, ou **Em branco**.
3. Ajuste o título, a introdução, as seções e as perguntas direto no canvas. Confira em **Prévia**.
4. Em **Modo**, escolha **Identificada** ou **Anônima**. Em **Tipo de resposta**, **Pesquisa opcional**, **Pesquisa obrigatória** ou **Resposta imediata**.
5. Em **Público e link**, confira quantas pessoas têm acesso ao espaço e, se quiser, ligue o **Link público**. Em **Período**, o **Início** (vazio para começar ao abrir) e o **Fim**, se houver.
6. **Salvar rascunho**. Até abrir, ninguém vê a pesquisa, nem pelo link.
7. **Abrir** e confirme: a janela diz para quantas pessoas vai o convite por e-mail. O público é congelado e a pesquisa passa a aceitar respostas. Com um Início no futuro, o botão é **Agendar**: a pesquisa fica **Agendada** e abre sozinha na hora marcada.
8. Se o link público estiver ligado, divulgue o endereço, copiado em **Público e link**.

### Responder (membro)

Quem tem acesso ao espaço responde de dois jeitos: abrindo o espaço no menu (no modo **Várias pesquisas**, clicando em **Responder**) ou pelo botão **Responder** do convite por e-mail. Uma pesquisa já respondida aparece como **Respondida**; uma obrigatória, como **Obrigatória**. Uma pesquisa agendada não aparece para quem responde até abrir; quem chega antes pelo link vê *"Esta pesquisa ainda não começou"*.

**O aviso no app.** Só nas pesquisas **obrigatórias** e de **resposta imediata**: ao entrar na comunidade, quem está no público e ainda não respondeu vê um aviso só, *"Uma pesquisa espera a sua resposta"* (ou *"N pesquisas esperam a sua resposta"*), com cada pesquisa, o prazo (*Fecha em…*) e se é **Anônima**. Clicar numa pesquisa abre a resposta. Na obrigatória, **Agora não** fecha o aviso dessas pesquisas, e ele não volta para elas. Na de resposta imediata, não há **Agora não**: o aviso volta a cada tela até a pessoa responder ou a pesquisa encerrar. Responder remove a pesquisa do aviso. A pesquisa opcional não abre aviso: chega pelo convite por e-mail e pela lista do espaço.

### Ver o resultado

No espaço, clique numa pesquisa aberta ou encerrada (um rascunho abre o editor); no modo **Uma pesquisa**, o resultado aparece direto depois de aberta. A lista mostra, em cada uma, destinatários, respostas e o prazo.

## O resultado

**O cabeçalho.** O título da pesquisa, o estado (**Aberta**, **Encerrada**…), se é **Identificada** ou **Anônima** e o prazo, com **Editar** e **Exportar CSV**. Na anônima, o **(i)** ao lado de **Anônima** explica as regras de anonimato (os blocos e o filtro só por origem). No celular, os botões ficam só com o ícone.

**As seções, em abas.** Logo abaixo, as abas **Resumo**, **Respostas individuais** (só na identificada), **Rodadas** (só na recorrente) e **Mapa de calor** (só na identificada). Na mesma linha ficam os filtros: **Origem** (**Todas**, membros ou visitantes) e **Recorte** (um grupo, uma tag ou uma empresa; **Todos os recortes** volta ao todo). No celular, os filtros ficam em **Filtros**. Uma pesquisa sem outras abas mostra a origem como botões.

**Os cartões do topo.** Só os que têm algo a dizer, divididos por igual na linha:

| Cartão | O que mostra | Quando aparece |
|---|---|---|
| **Respostas** | O total, com *N de membros · N de visitantes* | Sempre que há resposta |
| **Taxa de resposta** | O percentual sobre os destinatários (*de N destinatários*). Visitantes não entram na conta, porque não têm um denominador. Na anônima, conta só as respostas já publicadas | Quando a pesquisa tem destinatários |
| **Última resposta** | Há quanto tempo chegou a última, com *N nos últimos 7 dias* | Na identificada |
| **Último bloco publicado** | Há quanto tempo o último bloco entrou no resultado, com *N nos últimos 7 dias* | Na anônima |
| **NPS** | A nota da primeira pergunta NPS e as três faixas: **Detratores**, **Neutros** e **Promotores**, em percentual | Quando a pesquisa tem pergunta NPS |

**Respostas por dia.** Um gráfico com quantas respostas chegaram em cada dia, no fuso da comunidade, seguindo o filtro. Na **anônima**, a pesquisa não guarda a hora de nenhuma resposta: o gráfico se chama **Respostas publicadas por dia** e conta os blocos que entraram no resultado em cada dia, nunca quando alguém respondeu. As respostas publicadas antes desse registro aparecem numa nota abaixo (*"N respostas publicadas antes do registro diário não aparecem no gráfico."*). O gráfico só aparece com pelo menos dois dias e alguma resposta. Numa pesquisa anônima filtrada por **Origem** ou **Recorte**, quando parte das respostas foi publicada antes do registro diário, o gráfico não aparece, e no lugar fica *"O gráfico por dia não aparece para este recorte."*

**Um cartão por pergunta**, agrupados por seção (o nome da seção aparece quando há mais de uma), em duas colunas na tela larga. Cada cartão diz o tipo e quantas pessoas responderam:

- **Escolha única e múltipla escolha:** barras com o percentual e a contagem; a opção mais escolhida fica em destaque.
- **NPS:** a nota (de −100 a 100: % de promotores menos % de detratores), as três faixas e o histograma de 0 a 10 com a **Média**. Promotores são as notas 9 e 10, neutros 7 e 8, detratores de 0 a 6.
- **Escala:** a **Média** e o histograma das notas.
- **Texto:** as respostas em lista (até 1.000 por pergunta). Com mais de 4, aparecem as 4 primeiras, a busca **Buscar nas respostas** e **Ver todas (N)**.
- Uma pergunta que ninguém respondeu diz *"Ninguém respondeu esta pergunta ainda."*

**Estados vazios.** Sem nenhuma resposta: *"Ainda não há respostas"*, com *"O resultado aparece aqui assim que as primeiras respostas chegarem."* (ou *"A pesquisa foi encerrada sem respostas."*). Com um filtro sem nada: *"Nenhuma resposta neste recorte."* Na **anônima** com menos de 3 respostas publicadas: *"O resultado aparece com 3 respostas"*, sem nenhum número, e a explicação: depois disso, o resultado cresce em blocos de 3 respostas, publicados de hora em hora, para ninguém descobrir quem acabou de responder.

**Nas outras abas:**

- **Respostas individuais:** só na identificada, com o nome do membro (ou *Visitante*) e a data, da mais recente para a mais antiga.
- **Faltam responder:** só na **identificada** com **Pesquisa obrigatória** ou **Resposta imediata**, acima do resumo: os nomes de quem está no público e ainda não respondeu, com a contagem (*"Mostrando N de M."* quando a lista é longa), ou *"Todo mundo do público já respondeu."* Na **anônima**, o resultado não mostra nada sobre quem ou quantos faltam, em nenhum tipo de resposta: comparar a contagem antes e depois de uma resposta revelaria quem respondeu.
- **Filtro:** um por vez. Na anônima, só **Origem**, com o mínimo de 3 e a regra do complemento.
- **Exportar CSV:** uma linha por resposta e uma coluna por pergunta, com a seção no cabeçalho. Na identificada, começa com nome, e-mail, origem e data da resposta; na anônima, só as respostas já publicadas, embaralhadas, e só a partir de 3. O **Mapa de calor** e as **Rodadas** têm a exportação deles.

## Pesquisa recorrente e mapa de calor

### Repetir a pesquisa

Para medir o clima ou o eNPS de tempos em tempos sem recriar a pesquisa, ligue **Repetir** em **Período da pesquisa** (botão **Período**), com a pesquisa em rascunho:

| Campo | O que define |
|---|---|
| **Frequência** | **Semanal**, **Quinzenal**, **Mensal** ou **Trimestral** |
| **Dia da semana** ou **Dia do mês** | O dia da semana na semanal e na quinzenal; o dia do mês (de 1 a 28) na mensal e na trimestral |
| **Hora** | A hora em que cada rodada abre, no fuso da comunidade |
| **Duração (dias)** | Quanto tempo cada rodada fica aberta: até 7 dias na semanal, 14 na quinzenal, 28 na mensal e 90 na trimestral |
| **Convidar por e-mail a cada rodada** | O convite da categoria **Pesquisas** a cada rodada (ligado por padrão) |

**Salvar e ligar a repetição**. A pesquisa ganha a etiqueta **Recorrente** e o resumo mostra **Repetição ativa**, a agenda (*"Todo dia 1, 09:00 · 7 dias aberta"*) e a **Próxima rodada**. Ela não tem **Abrir**: só abre por rodadas.

- **Cada rodada é uma cópia da pesquisa** que abre sozinha no dia e na hora, com o público de agora (quem tem acesso ao espaço nesse momento), manda o convite e fecha ao fim da duração. O modo (identificada ou anônima) e as regras de publicação do resultado valem em cada rodada.
- **Cada pessoa responde uma vez por rodada**; a resposta de uma rodada não conta para outra.
- **Mudar as perguntas vale só para as próximas rodadas.** A pesquisa recorrente continua editável; a rodada aberta segue com as perguntas com que abriu.
- **Pausar repetição** para de abrir rodadas novas, sem fechar a rodada aberta; **Retomar repetição** volta a agenda. **Encerrar repetição** pede confirmação e não tem volta: nenhuma rodada nova abre, as que já aconteceram continuam no resultado e a aberta segue até fechar.
- No espaço de **Uma pesquisa**, quem responde cai na rodada aberta mais recente. Excluir a pesquisa recorrente exclui as rodadas dela.

### Rodadas e evolução

No resultado de uma pesquisa recorrente, a aba **Rodadas** abre primeiro:

- um gráfico de linha por pergunta de NPS ou de escala, com a **Evolução por rodada**;
- a tabela das rodadas, com **Abertura**, **Respostas**, **Taxa** e o valor de cada pergunta, e **Ver resultado** para abrir o resultado daquela rodada.

O seletor **Rodada**, no topo, troca a rodada do resumo, das respostas e do mapa. Na anônima, a rodada com menos de 3 respostas e a rodada ainda aberta aparecem **sem número**.

### Mapa de calor

Na pesquisa **identificada** (recorrente ou não), a aba **Mapa de calor** mostra onde a nota é melhor ou pior:

- **Agrupar por**: **Grupo principal**, **Tag** ou **Empresa**, uma de cada vez. Na tag e na empresa, quem tem mais de uma conta em cada linha;
- uma coluna por pergunta de NPS e de escala, a coluna **Respostas** e a linha do total;
- cada célula com o valor, a contagem de respostas e uma cor de cinco faixas, de **Pior** a **Melhor**. O mapa usa o grupo, a tag e a empresa da pessoa na hora em que ela respondeu, e conta só as respostas de membros;
- na recorrente, o mapa é o da rodada escolhida, com a **Variação** de cada célula contra a rodada anterior;
- **Exportar mapa (CSV)** baixa o que está na tela.

O mapa de calor agrupa por um controle compacto, chama as colunas de **P1**, **P2**… com as perguntas embaixo, explica a seta da variação (*"+3 vs. rodada anterior"*) e tem uma exportação só. Também na pesquisa identificada, um grupo com menos de 3 respostas aparece como **Poucas respostas**, sem número.

Na pesquisa **anônima**, o mapa de calor não está disponível.

Rodadas e mapa são do proprietário e do administrador; o moderador e os membros não os veem.

## Exemplo: a pesquisa de satisfação de um evento

Um evento de tecnologia acabou e a organização quer ouvir quem foi, membro ou não:

1. **Nova pesquisa › Feedback do evento**, no espaço do evento. Título: *Pesquisa de satisfação do evento*. Introdução: *"Obrigado por participar da 10ª edição! Leva menos de 2 minutos."*
2. As quatro seções já vêm: **Conteúdo**, **Infraestrutura**, **Experiência** e **Perfil**. Na **Conteúdo**, a equipe acrescenta *"Qualidade da trilha de APIs"* com **Duplicar** numa pergunta pronta (a escala Excelente…Não se aplica vem junto) e cria uma escolha única com alternativas próprias: *"A duração das palestras foi…"* *Curta demais*, *Na medida*, *Longa demais*.
3. **Modo: Anônima** e **Link público** ligado (os dois vêm assim no modelo). A pesquisa mora num espaço **Pesquisa do evento**, no modo **Uma pesquisa**, privado para o produto do ingresso: quem comprou recebe o convite por e-mail ao abrir. **Prazo:** uma semana.
4. **Abrir**, copiar o link público e mandar no grupo do evento, para quem não tem conta.
5. Quem foi responde pelo celular, sem conta, em quatro etapas. Na terceira resposta, o resultado aparece, e daí em diante muda de 3 em 3; o filtro **Origem** separa membros e visitantes quando cada lado tem pelo menos 3.

## Pelo assistente (MCP)

O proprietário e o administrador fazem pelo assistente quase tudo o que fazem no espaço: criar o espaço de Pesquisas (com o modo), ver os modelos, criar a pesquisa no espaço com seções e perguntas, o período (`starts_at`, `closes_at`) e o tipo de resposta (`response_mode`), editar o rascunho ou a agendada (ou movê-la para outro espaço), conferir o alcance do público, abrir ou agendar (`open_survey` com um `starts_at` no futuro agenda; `starts_at` nulo cancela), ligar o link (a resposta traz o endereço público), ler o resultado com um filtro (com quem falta responder, só na identificada), listar as respostas individuais e exportar o CSV. **Abrir** e **agendar** (porque mandam o convite por e-mail), **encerrar** e **excluir** pedem a sua confirmação; o resto age na primeira chamada. A receita **Fazer uma pesquisa** monta, abre e resume o resultado com você.

Qualquer membro pergunta ao assistente quais pesquisas esperam a resposta dele (`list_my_pending_surveys`), com o link para responder no app e o tipo de resposta (`response_mode`) de cada uma.

A pesquisa recorrente também se faz pelo assistente, com `recurrence` em `create_survey` e `update_survey`, pausar, retomar e encerrar a repetição (encerrar pede confirmação), as rodadas, a evolução e o mapa de calor da identificada, com o CSV. Ver [Ferramentas · Membros](/mcp/ferramentas-membros#pesquisa-recorrente-e-mapa-de-calor).

`get_survey_results` traz também `activity`, as respostas por dia: na anônima, a contagem é das respostas publicadas em cada dia, e o assistente nunca diz quando alguém respondeu.

**Responder a uma pesquisa pelo assistente não existe**: o registro do que o assistente faz em nome de alguém identificaria quem respondeu. Ver [Ferramentas · Membros](/mcp/ferramentas-membros#pesquisas).

## Erros comuns e como resolver

| Mensagem | Por quê | O que fazer |
|---|---|---|
| *Escolha um público, ligue o link público, ou os dois, antes de abrir.* | Ninguém tem acesso ao espaço e o link público está desligado | Mude o acesso do espaço ou ligue o link público em **Público e link** |
| *Este espaço é de uma pesquisa só e ela já existe…* | O espaço está no modo **Uma pesquisa** | Crie a nova em outro espaço, ou mude o espaço para **Várias pesquisas** |
| *Este espaço tem N pesquisas e "Uma pesquisa" aceita só uma…* | Troca para **Uma pesquisa** com mais de uma pesquisa no espaço | Apague as outras (nada é apagado sozinho) ou mantenha **Várias pesquisas** |
| *Inclua pelo menos uma pergunta antes de abrir.* | Só há seções vazias | Use o **+** para colocar uma pergunta |
| *Depois de aberta, a pesquisa só muda o título, a descrição, o prazo e o link público.* | A estrutura, o início, o modo e o tipo de resposta travam ao abrir | Para mudar perguntas, crie outra pesquisa |
| *O resultado aparece com 3 respostas.* | Pesquisa anônima com menos de 3 respostas publicadas | Espere mais respostas |
| *Esta pesquisa não é para você.* | A pessoa está logada, sem acesso ao espaço, e o link público está desligado | Dê acesso ao espaço antes de abrir, ou ligue o link público |
| *Esta pesquisa já recebeu o máximo de 5000 respostas pelo link público.* | O teto de visitantes | Encerre ou crie outra pesquisa |
| *Esta pesquisa ainda não começou.* | A pesquisa está agendada, ou o Início ainda não chegou | Espere a hora do Início, ou, na equipe, remova o Início e abra agora |
| *O fim precisa ser depois do início.* | No **Período**, o Fim vem antes do Início | Corrija uma das datas |
| *Esta pesquisa já está agendada. Para abrir agora, remova a data de início.* | **Abrir** numa pesquisa já agendada | **Cancelar agendamento** ou remova o Início, e abra |

## Na API

O espaço é `module: "surveys"`, com `moduleConfig.mode` `single` ou `multi` na criação e na edição do espaço; `GET` e `PUT /api/surveys/spaces/{spaceId}` leem e trocam o modo (no `single`, o `GET` traz a pesquisa). As rotas da equipe ficam em `/api/surveys` (proprietário e administrador, com o `X-CommunityId`): modelos, lista (`?spaceId=`), criar (com `spaceId`, obrigatório), editar (no rascunho ou na agendada, a árvore inteira de seções e perguntas, e `spaceId` para mover), prévia do público (`spaceId` ou `surveyId`), abrir, encerrar, excluir, resultado com um filtro (`groupId`, `tag`, `companyId` ou `origin`; na anônima, só `origin`, e os outros voltam 422), respostas individuais e CSV. O membro lista as pesquisas que pode responder em `GET /api/surveys?spaceId=`, com `alreadyResponded`; as abertas que ainda esperam a resposta dele em `GET /api/surveys/pending` (com `responseMode` de cada uma, `notice` se o aviso no app deve aparecer e `blocking` se há uma de resposta imediata), e fecha o aviso de uma em `POST /api/surveys/{id}/notice/dismiss`. As duas rotas públicas, `/api/public/surveys/{publicToken}`, servem a pesquisa e recebem a resposta sem login. Antes de enviar, a página pública pede um desafio em `/api/public/surveys/{publicToken}/challenge`, que o navegador resolve e manda junto com a resposta.

**Período e tipo de resposta.** Criar e editar aceitam `startsAt` e `closesAt` (o fim depois do início) e `responseMode` (`optional`, o padrão, `required` ou `immediate`), no rascunho e na agendada. Abrir com `startsAt` no futuro agenda: o `status` fica `scheduled` (os status são `draft`, `scheduled`, `open` e `closed`) e a pesquisa abre sozinha no `startsAt`; `startsAt: null` cancela. No resultado, `pending` (`count`, `members`, `truncated`) só vem na identificada com `required` ou `immediate`; na anônima, o campo não existe.

**Respostas por dia**. `GET /api/surveys/{id}/results` traz `activity` (nulo quando `locked`), só contagens, no fuso da comunidade e seguindo o filtro: `basis`, `timeZone`, `days` (`[{ date, count }]`), `lastAt`, `lastWeek` (quantas nos últimos 7 dias) e `untracked`. Na identificada, `basis` é `response` e conta cada resposta no seu dia. Na anônima, `basis` é `publication`: a resposta anônima não guarda hora, então a contagem é dos blocos publicados a cada hora, no dia da publicação; `untracked` são as respostas publicadas antes desse registro.

| Erro | Quando |
|---|---|
| `403` | O papel não gerencia pesquisas, ou a pessoa logada não tem acesso ao espaço |
| `404` | A pesquisa não existe, é de outra comunidade, ou o link está desligado |
| `409` | Já respondeu (o membro, em qualquer navegador; o visitante, no mesmo navegador), segunda pesquisa num espaço **Uma pesquisa**, ou troca para **Uma pesquisa** com duas ou mais |
| `422` | Criar sem `spaceId` ou com um espaço que não é de Pesquisas, estrutura inválida, pesquisa em rascunho ou encerrada, fora do período (`notYetOpen` antes do início, `closed` depois do fim), fim antes do início (`closesBeforeStart`), abrir uma já agendada (`alreadyScheduled`), mudança travada depois de aberta, fechar o aviso de uma de resposta imediata ainda sem resposta (`noticeRequired`), verificação contra robôs vencida, recorte abaixo do mínimo |
| `429` | Limite de envios da rede ou teto de 5.000 respostas de visitantes |
| `503` | A verificação contra robôs está indisponível no momento; tente de novo em instantes |

## Relacionados

- [Módulos](/conceitos/modulos)
- [Visibilidade e acesso](/conceitos/visibilidade-e-acesso)
- [Campanhas de e-mail](/notificacoes/campanhas-de-email)
- [Enquetes](/espacos/enquetes)
- [Grupos e organograma](/membros/grupos-e-organograma)
- [Tags](/membros/tags)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)
- [Ferramentas · Membros](/mcp/ferramentas-membros#pesquisas)