# Inquéritos

> O módulo de espaço Inquéritos. Como a equipa cria um espaço de um inquérito ou de vários, monta o questionário em secções no editor que já é o ecrã de resposta (de um modelo NPS, satisfação, evento, curso, eNPS ou em branco), abre-o para quem tem acesso ao espaço com um convite por e-mail e/ou pelo link público sem sessão iniciada, identificado ou anónimo, e lê o resultado com filtros e CSV.

O **inquérito** é um questionário da equipa, com várias perguntas organizadas em **secçõ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 equipa quiser perguntar, sem Google Forms nem Typeform, com o resultado consolidado dentro da comunidade.

**Inquéritos** é um [módulo de espaço](/conceitos/modulos), no separador **Comunidade** de **Adicionar Espaço**. Todo o inquérito mora num espaço de Inquéritos, e **quem tem acesso ao espaço é o público dele**.

## Inquérito ou sondagem

| | [Sondagem](/espacos/enquetes) | Inquérito |
|---|---|---|
| O que é | Uma pergunta, de 2 a 10 opções, publicada como post | Um questionário: secçõ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 Inquéritos, num ecrã próprio de resposta, por 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 sessão iniciada |
| Anonimato | A equipa vê quem votou em quê | Identificado ou anónimo, escolhido antes de abrir |
| Resultado | Barras no próprio post | Painel por secção, NPS, filtros e CSV |

Para uma pergunta rápida no dia a dia, a sondagem. Para um feedback estruturado, o inquérito.

## Para que serve

| Comunidade | Inquérito |
|---|---|
| Evento | O inquérito de satisfação do evento, respondido pelo link também por quem não é membro |
| Escola online | O feedback de um curso: conteúdo, formador, aplicabilidade |
| Coworking | O NPS dos residentes, uma vez por semestre |
| Empresa | O eNPS da equipa, anónimo |

## Como funciona

### O espaço: um inquérito ou vários

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

| Modo | Como fica |
|---|---|
| **Vários inquéritos** (o padrão) | Uma lista de inquéritos. A equipa vê todos, com os filtros **Todos**, **Rascunhos**, **Agendados**, **Abertos** e **Encerrados** (o agendado mostra *Abre em…*), e cria com **Novo inquérito**; o membro vê os que pode responder, com **Responder** ou **Respondido**, e a marca **Obrigatório** nos obrigatórios |
| **Um inquérito** | O espaço é um inquérito: quem abre vai direto para ele. A equipa vê o editor (ou o resultado, depois de aberto); o membro, o formulário. Vazio, mostra **Criar inquérito** à equipa |

**Um inquérito** só é possível com no máximo um inquérito no espaço (rascunhos e encerrados contam): mudar para ele com dois ou mais é recusado, e um segundo inquérito também. O modo muda-se depois nas configurações do espaço.

**O espaço nasce com o inquérito.** Em **Um inquérito**, **Seguinte** leva a um terceiro passo, **Inquérito**, na mesma janela: **Comece por** (um modelo ou **Em branco**), **Título do inquérito** (obrigatório), **Descrição**, **Modo** (identificado ou anónimo) e **Tipo de resposta**. **Criar inquérito** cria o espaço e o inquérito, em rascunho, e abre logo o editor: *"O inquérito nasce como rascunho: ninguém recebe nada até o abrir."* Se o inquérito for recusado, o espaço fica criado, o passo mantém o que foi escrito e só o inquérito é tentado 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 da mesma forma: terminam abertos na chamada ou no curso.

Um exemplo: um espaço **Inquérito do evento**, no modo **Um inquérito**, privado para quem comprou o bilhete; e um espaço **Inquéritos**, no modo **Vários inquéritos**, aberto aos membros, com o NPS do semestre e os inquéritos de cada curso.

### Quem faz o quê

| Quem | O que faz |
|---|---|
| Proprietário e administrador | Tudo: criam o espaço e os inquéritos, editam o rascunho, ativam o link, abrem, encerram, eliminam, veem o resultado e as respostas e exportam o CSV |
| Membro (e moderador e financeiro) | Com acesso ao espaço, responde aos inquéritos abertos dele, no espaço ou pelo convite por e-mail |
| Quem não tem conta | Responde pelo link público, se o inquérito estiver aberto e com o link ativo; nada mais |

### Os modelos

**Novo inquérito** 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 secção: a nota de 0 a 10 e *"O que mais pesou na sua nota?"* | Identificado |
| **Inquérito de satisfação** | Uma secção: a satisfação geral de 1 a 5, em estrelas, e um comentário | Identificado |
| **Feedback do evento** | Quatro secçõ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, Mau e Não se aplica | Anónimo, com o link público ativo |
| **Feedback do curso** | Uma secção: conteúdo, formador e aplicabilidade, com a mesma escala, e *"O que poderia melhorar?"* | Identificado |
| **eNPS** | Uma secção: a probabilidade de recomendar a empresa como um lugar para trabalhar, e o porquê | Anónimo |
| **Em branco** | Uma secção vazia, para montar do zero | Identificado |

### Secções

Todo o inquérito tem **pelo menos uma secção**, com título e descrição opcional; cada pergunta pertence a uma secção. Para quem responde, as secções são **etapas**:

- O **título** e a **introdução** do inquérito abrem o primeiro ecrã, com o modo (anónimo ou identificado), o número de etapas e de perguntas e o botão **Começar**.
- No topo, a barra com o título de cada etapa (*Conteúdo · Infraestrutura · Experiência · Perfil*). No telemóvel, passa a *"Etapa 2 de 4 · Infraestrutura"*. Um inquérito de uma só secção 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 só vez, no Enviar**. Nada fica guardado no servidor a meio: se a pessoa fechar o separador antes, recomeça.

No resultado, as perguntas aparecem agrupadas por secção, pela mesma ordem. Um inquérito tem até **20 secções** e **100 perguntas**.

### O editor

Montar o inquérito é editar **o próprio ecrã 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 secção, enunciado, ajuda e alternativas.
- As **secções** aparecem como as etapas, em separadores no topo do canvas; **Secção** cria uma nova. **Eliminar secção** apaga as perguntas dela também, depois de confirmar.
- O **+** entre as perguntas insere uma pergunta (um dos 5 tipos) ou uma secção nova.
- **Arraste** pela pega para reordenar as perguntas dentro da secção; arraste uma pergunta até ao separador de outra etapa para a mover para lá; arraste os separadores para reordenar as secções. **Mover para secçã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 também as alternativas, útil quando a mesma escala se repete) e **Eliminar**.
- **Computador** e **Telemóvel** mudam a largura; **Pré-visualização** percorre as etapas como quem responde, com **Enviar (pré-visualização)**, sem gravar nada.

No topo ficam **Público e link**, **Modo**, **Tipo de resposta**, **Período**, **Pré-visualização**, **Guardar rascunho** e **Abrir** (ou **Agendar**, com um início no futuro). Num agendado, **Cancelar agendamento** no lugar de **Abrir**; num aberto, **Encerrar**. Ao lado do título aparece **Alterações não guardadas** ou **Tudo guardado**.

A barra do editor mostra apenas o título, o estado e a ação principal; as definições são resumos clicáveis, e **Pausar**, **Encerrar** e **Eliminar** ficam em **Mais ações**. O aviso do modo fica acima da introdução, e um inquérito **identificado** 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 se 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 (saltar perguntas consoante a resposta), matriz nem envio de ficheiro.

### Identificado ou anónimo

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

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

No anónimo, a introdução diz exatamente: *"Inquérito anónimo: a comunidade não consegue ligar a resposta a si."* É essa a promessa: a comunidade (equipa, API, assistente, CSV) não tem como saber quem respondeu o quê. A resposta é guardada sem a pessoa e sem horário, separada do registo de que ela já respondeu, e as respostas nunca aparecem pela ordem em que chegaram.

Os cuidados do anónimo:

- **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.** No anónimo, o resultado filtra-se apenas por **membros** ou **visitantes**; grupo, etiqueta e empresa ficam só para o identificado. O recorte aparece quando ele **e o resto** têm pelo menos 3 respostas cada. Sem a regra do resto, um recorte de 3 num inquérito de 4 entregaria a quarta pessoa pela diferença.
- **Textos baralhados 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]
> Num inquérito **identificado**, a resposta é um dado pessoal da comunidade, que é a responsável pelo tratamento. Não pergunte sobre saúde, religião, opinião política ou outro dado sensível num inquérito identificado; se precisar, use o anónimo.

### 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**. O inquérito precisa de **alguém com acesso ao espaço, do link público ativo, ou dos dois**.

- **Público**: **Público e link** mostra quantas pessoas têm hoje acesso ao espaço (até 50.000), com alguns nomes. Para mudar quem responde, altere o acesso do espaço. O público é **congelado quando o inquérito abre**: quem ganhar acesso ao espaço depois não entra nele.
- **Convite por e-mail**: ao abrir, com a caixa **Avisar por e-mail** marcada (por omissão), cada pessoa do público recebe **um** e-mail de convite, 10 minutos depois, com o botão **Responder**, se deixou a categoria **Inquéritos** ligada em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade). Editar o inquérito depois não reenvia. O botão leva ao mesmo endereço para todos, por isso 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 sessão iniciada, ou diretamente no espaço. Quem abre com sessão iniciada e não tem acesso vê *"Este inquérito não é para si"* (a não ser que o link público esteja ativo).

  O link do convite abre o inquérito **dentro do espaço dele**, com o menu da comunidade. Quem responde vai para o formulário (ou para o aviso de já respondido ou encerrado, conforme o caso); o proprietário e o administrador vão para o editor, se o inquérito é rascunho ou agendado, ou para o resultado, se está aberto ou encerrado. Se nenhum espaço do menu da pessoa tem o inquérito, o ecrã de resposta avulso explica porquê. Num espaço de **Vários inquéritos**, o endereço do navegador acompanha o inquérito aberto: pode copiá-lo, enviá-lo a alguém da equipa e recarregar a página sem voltar à lista.

- **Espaço**: no rascunho, o inquérito pode ir para outro espaço de Inquéritos.
- **Link público**: qualquer pessoa com o link responde **sem iniciar sessão**, no domínio da própria comunidade (o personalizado, se existir, 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ó o inquérito). **Copiar** copia o endereço; desativar 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 outro inquérito.

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

- **Quem abre o link sem iniciar sessão** recebe um marcador **neste navegador** (o ecrã avisa: *"Guardamos um marcador neste navegador só para evitar respostas repetidas"*). No mesmo navegador, a segunda tentativa vê *"Já respondeu neste navegador. Obrigado!"*. **Uma janela anónima, outro navegador, outro dispositivo ou os dados do navegador apagados respondem de novo.** Se o inquérito precisa mesmo de uma resposta por pessoa, use o público do espaço, sem o link público.
- **Quem abre com sessão iniciada e é membro da comunidade do inquérito** responde **como membro**, uma só vez de verdade, em qualquer navegador: a segunda tentativa vê *"Já respondeu"*. A resposta segue o modo do inquérito. Com sessão iniciada noutra comunidade, conta como visitante.

**Contra robôs e abusos**, 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 falhar, o ecrã pede para enviar de novo);
- um limite de **300 envios a cada 10 minutos por rede**, por inquérito (acima, *"Demasiados envios desta rede. Aguarde alguns minutos e tente novamente."*);
- um teto de **5.000 respostas de visitantes** por inquérito; as respostas de membros não contam para o teto;
- e a equipa pode **desativar o link** a qualquer momento.

O endereço de rede de quem responde não é guardado com o inquérito.

### Período e agendamento

**Período** define o **Início** e o **Fim** da recolha, no fuso horário da comunidade: *"Fora desse período ninguém responde."* O fim tem de ser depois do início.

- **Sem Início** (*Ao abrir*), o inquérito começa quando a equipa clicar em **Abrir**.
- **Com um Início no futuro**, o botão passa a **Agendar**. A confirmação diz quando abre e a partir de quando sai o convite por e-mail: *"O inquérito abre sozinho em … e o convite por e-mail sai a partir de …. Nada é enviado antes disso."* À hora marcada, o inquérito **abre sozinho**, tal como se a equipa 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).
- **Agendado**, continua **editável como um rascunho**, por inteiro (perguntas, modo, tipo de resposta, período). **Cancelar agendamento** (ou tirar o Início) devolve-o a rascunho: *"Agendamento cancelado: o inquérito voltou a rascunho."*
- **Com Fim**, encerra sozinho na data e hora escolhidas. Sem Fim, fica aberto até alguém da equipa **Encerrar**.

**Fora do período, ninguém responde, por nenhum caminho** (no espaço, pela ligação do convite ou pela ligação pública). Antes do início, o ecrã diz *"Este inquérito ainda não começou"* e quando abre; depois do fim, ou encerrado, o link público mostra *"Inquérito encerrado"*. **Um inquérito encerrado 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 **Inquérito** do espaço de um inquérito) e **fica bloqueado ao abrir**.

| Tipo | Para quem está no público |
|---|---|
| **Inquérito opcional** (o padrão) | O convite por e-mail e o inquérito no espaço. Nenhuma janela na aplicação: *"Ninguém é cobrado."* |
| **Inquérito obrigatório** | Marcado como **Obrigatório** na lista e no ecrã de resposta (*"Este inquérito é obrigatório: a equipa conta com a sua resposta."*), e o convite diz que a resposta é obrigatória. Ao entrar na aplicação, a janela *"Um inquérito espera a sua resposta"*, com **Agora não** |
| **Resposta imediata** | Como o obrigatório, mas a janela não tem **Agora não** nem fecha: *"Para continuar usando o app, responda a este inquérito."* Sai quando a pessoa responde ou quando o inquérito encerra |

O tipo vale para quem entrou no público ao abrir; quem ganhou acesso ao espaço depois vê o inquérito como opcional. No identificado, obrigatório e imediata mostram no resultado quem falta responder (ver [O resultado](#o-resultado)).

Depois de aberto, a estrutura fica bloqueada: só mudam o **título**, a **introdução**, o **Fim** do período e o **link público** (ativar ou desativar), com **Guardar alterações**. O **Início**, o **Modo** e o **Tipo de resposta** já não mudam.

Eliminar o espaço elimina os inquéritos dele e desativa os links públicos.

### Quem sai da comunidade

Quando um membro sai da comunidade (por iniciativa própria, removido pela equipa, 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 vez**, e o resultado é recalculado. 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, por baixo da secção, clique em **Adicionar Espaço**.
2. No separador **Comunidade**, escolha **Inquéritos** e clique em **Seguinte**.
3. Escreva o título e escolha a **Visibilidade** (e, se for **Privada**, **Quem tem acesso**): é quem vai responder.
4. Em **Como o espaço funciona**, escolha **Vários inquéritos** ou **Um inquérito**. Com **Vários inquéritos**, crie o espaço.
5. Com **Um inquérito**, **Seguinte** leva ao passo **Inquérito**: escolha o modelo (ou **Em branco**), o título, a descrição, o **Modo** e o **Tipo de resposta**, e clique em **Criar inquérito**. O espaço e o inquérito nascem juntos e o editor abre; continue em [Criar e abrir o inquérito](#criar-e-abrir-o-inquerito), passo 3.

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

### Criar e abrir o inquérito

1. No espaço, clique em **Novo inquérito** (no modo **Um inquérito**, **Criar inquérito**).
2. Escolha um modelo, ou **Em branco**.
3. Ajuste o título, a introdução, as secções e as perguntas diretamente no canvas. Confira em **Pré-visualização**.
4. Em **Modo**, escolha **Identificado** ou **Anónimo**. Em **Tipo de resposta**, **Inquérito opcional**, **Inquérito obrigatório** ou **Resposta imediata**.
5. Em **Público e link**, confira quantas pessoas têm acesso ao espaço e, se quiser, ative o **Link público**. Em **Período**, o **Início** (vazio para começar ao abrir) e o **Fim**, se houver.
6. **Guardar rascunho**. Até abrir, ninguém vê o inquérito, nem pelo link.
7. **Abrir** e confirme: a janela diz para quantas pessoas vai o convite por e-mail. O público é congelado e o inquérito passa a aceitar respostas. Com um Início no futuro, o botão é **Agendar**: o inquérito fica **Agendado** e abre sozinho à hora marcada.
8. Se o link público estiver ativo, divulgue o endereço, copiado em **Público e link**.

### Responder (membro)

Quem tem acesso ao espaço responde de duas formas: abrindo o espaço no menu (no modo **Vários inquéritos**, clicando em **Responder**) ou pelo botão **Responder** do convite por e-mail. Um inquérito já respondido aparece como **Respondido**; um obrigatório, como **Obrigatório**. Um inquérito agendado não aparece a quem responde até abrir; quem chega antes pela ligação vê *"Este inquérito ainda não começou"*.

**O aviso na aplicação.** Só nos inquéritos **obrigatórios** e de **resposta imediata**: ao entrar na comunidade, quem está no público e ainda não respondeu vê um único aviso (*"Um inquérito espera a sua resposta"*), com cada inquérito, o prazo e se é **Anónimo**. Clicar num inquérito abre a resposta. No obrigatório, **Agora não** fecha o aviso desses inquéritos, e ele não volta para eles. No de resposta imediata, não há **Agora não**: o aviso volta a cada ecrã até a pessoa responder ou o inquérito encerrar. Responder tira o inquérito do aviso. O inquérito opcional não abre aviso: chega pelo convite por e-mail e pela lista do espaço.

### Ver o resultado

No espaço, clique num inquérito aberto ou encerrado (um rascunho abre o editor); no modo **Um inquérito**, o resultado aparece diretamente depois de aberto. A lista mostra, em cada um, destinatários, respostas e o prazo.

## O resultado

**O cabeçalho.** O título do inquérito, o estado (**Aberto**, **Encerrado**…), se é **Identificado** ou **Anónimo** e o prazo, com **Editar** e **Exportar CSV**. No anónimo, o **(i)** ao lado de **Anónimo** explica as regras de anonimato (os blocos e o filtro só por origem). No telemóvel, os botões ficam só com o ícone.

**As secções, em separadores.** Logo abaixo, os separadores **Resumo**, **Respostas individuais** (só no identificado), **Rodadas** (só no recorrente) e **Mapa de calor** (só no identificado). Na mesma linha ficam os filtros: **Origem** (**Todas**, membros ou visitantes) e **Recorte** (um grupo, uma etiqueta ou uma empresa; **Todos os recortes** volta ao todo). No telemóvel, os filtros ficam em **Filtros**. Um inquérito sem outros separadores 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** | A percentagem sobre os destinatários (*de N destinatários*). Os visitantes não entram na conta, porque não têm denominador. No anónimo, conta só as respostas já publicadas | Quando o inquérito tem destinatários |
| **Última resposta** | Há quanto tempo chegou a última, com *N nos últimos 7 dias* | No identificado |
| **Último bloco publicado** | Há quanto tempo o último bloco entrou no resultado, com *N nos últimos 7 dias* | No anónimo |
| **NPS** | A nota da primeira pergunta NPS e as três faixas: **Detratores**, **Neutros** e **Promotores**, em percentagem | Quando o inquérito tem pergunta NPS |

**Respostas por dia.** Um gráfico com quantas respostas chegaram em cada dia, no fuso horário da comunidade, seguindo o filtro. No **anónimo**, o inquérito não guarda a hora de nenhuma resposta: o gráfico chama-se **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 registo aparecem numa nota abaixo. O gráfico só aparece com pelo menos dois dias e alguma resposta. Num inquérito anónimo filtrado por **Origem** ou **Recorte**, quando parte das respostas foi publicada antes do registo diário, o gráfico não aparece e, no seu lugar, fica *"O gráfico por dia não aparece para este recorte."*

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

- **Escolha única e escolha múltipla:** barras com a percentagem 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 pesquisa **Procurar nas respostas** e **Ver todas (N)**.
- Uma pergunta a que ninguém respondeu diz *"Ainda ninguém respondeu a esta pergunta."*

**Estados vazios.** Sem nenhuma resposta: *"Ainda não há respostas"*, com *"O resultado aparece aqui assim que chegarem as primeiras respostas."* (ou *"A pesquisa foi encerrada sem respostas."*). Com um filtro sem nada: *"Nenhuma resposta neste recorte."* No **anónimo** 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 a hora, para ninguém descobrir quem acabou de responder.

**Nos outros separadores:**

- **Respostas individuais:** só no identificado, com o nome do membro (ou *Visitante*) e a data, da mais recente para a mais antiga.
- **Faltam responder:** só no **identificado** com **Inquérito obrigatório** 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 *"Toda a gente do público já respondeu."* No **anónimo**, 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 de cada vez. No anónimo, 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 secção no cabeçalho. No identificado, começa com nome, e-mail, origem e data da resposta; no anónimo, só as respostas já publicadas, baralhadas, e só a partir de 3. O **Mapa de calor** e as **Rodadas** têm a sua própria exportação.

## Inquérito recorrente e mapa de calor

### Repetir o inquérito

Para medir o clima ou o eNPS de tempos a tempos sem recriar o inquérito, ligue **Repetir** em **Período do inquérito** (botão **Período**), com o inquérito 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 a que cada rodada abre, no fuso horário 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 **Inquéritos** a cada rodada (ligado por omissão) |

**Guardar e ligar a repetição**. O inquérito 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**. Não tem **Abrir**: só abre por rodadas.

- **Cada rodada é uma cópia do inquérito** que abre sozinha no dia e à hora definidos, com o público do momento (quem tem acesso ao espaço nessa altura), envia o convite e fecha no fim da duração. O modo (identificado ou anónimo) 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.** O inquérito recorrente continua editável; a rodada aberta segue com as perguntas com que abriu.
- **Pausar repetição** deixa de abrir rodadas novas, sem fechar a rodada aberta; **Retomar repetição** repõe 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 **Um inquérito**, quem responde cai na rodada aberta mais recente. Eliminar o inquérito recorrente elimina as rodadas dele.

### Rodadas e evolução

No resultado de um inquérito recorrente, o separador **Rodadas** abre primeiro:

- um gráfico de linhas 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 dessa rodada.

O seletor **Rodada**, no topo, muda a rodada do resumo, das respostas e do mapa. No anónimo, a rodada com menos de 3 respostas e a rodada ainda aberta aparecem **sem número**.

### Mapa de calor

No inquérito **identificado** (recorrente ou não), o separador **Mapa de calor** mostra onde a nota é melhor ou pior:

- **Agrupar por**: **Grupo principal**, **Tag** ou **Empresa**, um 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 no momento em que respondeu, e conta só as respostas de membros;
- no recorrente, o mapa é o da rodada escolhida, com a **Variação** de cada célula face à rodada anterior;
- **Exportar mapa (CSV)** descarrega o que está no ecrã.

O mapa de calor agrupa através de um controlo compacto, chama às colunas **P1**, **P2**… com as perguntas por baixo, explica a seta da variação (*"+3 vs. rodada anterior"*) e tem uma única exportação. Também no inquérito identificado, um grupo com menos de 3 respostas aparece como **Poucas respostas**, sem número.

No inquérito **anónimo**, o mapa de calor não está disponível.

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

## Exemplo: o inquérito de satisfação de um evento

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

1. **Novo inquérito › Feedback do evento**, no espaço do evento. Título: *Inquérito de satisfação do evento*. Introdução: *"Obrigado por participar na 10.ª edição! Demora menos de 2 minutos."*
2. As quatro secções já vêm: **Conteúdo**, **Infraestrutura**, **Experiência** e **Perfil**. Em **Conteúdo**, a equipa 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*, *Adequada*, *Longa demais*.
3. **Modo: Anónimo** e **Link público** ativo (os dois vêm assim no modelo). O inquérito mora num espaço **Inquérito do evento**, no modo **Um inquérito**, privado para o produto do bilhete: quem comprou recebe o convite por e-mail ao abrir. **Prazo:** uma semana.
4. **Abrir**, copiar o link público e enviá-lo no grupo do evento, para quem não tem conta.
5. Quem foi responde no telemóvel, sem conta, em quatro etapas. À terceira resposta, o resultado aparece, e a partir daí 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 Inquéritos (com o modo), ver os modelos, criar o inquérito no espaço com secções e perguntas, o período (`starts_at`, `closes_at`) e o tipo de resposta (`response_mode`), editar o rascunho ou o agendado (ou movê-lo para outro espaço), confirmar o alcance do público, abrir ou agendar (`open_survey` com um `starts_at` no futuro agenda; `starts_at` nulo cancela), ativar o link (a resposta traz o endereço público), ler o resultado com um filtro (com quem falta responder, só no identificado), listar as respostas individuais e exportar o CSV. **Abrir** e **agendar** (porque enviam o convite por e-mail), **encerrar** e **eliminar** pedem a sua confirmação; o resto atua na primeira chamada. A receita **Fazer um inquérito** monta, abre e resume o resultado consigo.

Qualquer membro pergunta ao assistente que inquéritos esperam a sua resposta (`list_my_pending_surveys`), com a ligação para responder na aplicação e o tipo de resposta (`response_mode`) de cada um.

O inquérito 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 do identificado, com o CSV. Ver [Ferramentas · Membros](/mcp/ferramentas-membros#inquerito-recorrente-e-mapa-de-calor).

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

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

## Erros comuns e como resolver

| Mensagem | Porquê | O que fazer |
|---|---|---|
| *Escolha um público, ative a ligação pública, ou ambos, antes de abrir.* | Ninguém tem acesso ao espaço e o link público está desativado | Altere o acesso do espaço ou ative o link público em **Público e link** |
| *Este espaço é de um só inquérito e ele já existe…* | O espaço está no modo **Um inquérito** | Crie o novo noutro espaço, ou mude o espaço para **Vários inquéritos** |
| *Este espaço tem N inquéritos e "Um inquérito" aceita só um…* | Mudança para **Um inquérito** com mais de um inquérito no espaço | Apague os outros (nada é apagado sozinho) ou mantenha **Vários inquéritos** |
| *Inclua pelo menos uma pergunta antes de abrir.* | Só há secções vazias | Use o **+** para pôr uma pergunta |
| *Depois de aberto, o inquérito só muda o título, a descrição, o prazo e a ligação pública.* | A estrutura, o início, o modo e o tipo de resposta bloqueiam ao abrir | Para mudar perguntas, crie outro inquérito |
| *O resultado aparece com 3 respostas.* | Inquérito anónimo com menos de 3 respostas publicadas | Espere por mais respostas |
| *Este inquérito não é para si.* | A pessoa tem sessão iniciada, sem acesso ao espaço, e o link público está desativado | Dê acesso ao espaço antes de abrir, ou ative o link público |
| *Este inquérito já recebeu o máximo de 5000 respostas pela ligação pública.* | O teto de visitantes | Encerre ou crie outro inquérito |
| *Este inquérito ainda não começou.* | O inquérito está agendado, ou o Início ainda não chegou | Espere pela hora do Início ou, na equipa, tire 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 |
| *Este inquérito já está agendado. Para abrir agora, tire a data de início.* | **Abrir** num inquérito já agendado | **Cancelar agendamento** ou tire 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 mudam o modo (no `single`, o `GET` traz o inquérito). As rotas da equipa ficam em `/api/surveys` (proprietário e administrador, com o `X-CommunityId`): modelos, lista (`?spaceId=`), criar (com `spaceId`, obrigatório), editar (no rascunho ou no agendado, a árvore inteira de secções e perguntas, e `spaceId` para mover), pré-visualização do público (`spaceId` ou `surveyId`), abrir, encerrar, eliminar, resultado com um filtro (`groupId`, `tag`, `companyId` ou `origin`; no anónimo, só `origin`, e os outros devolvem 422), respostas individuais e CSV. O membro lista os inquéritos que pode responder em `GET /api/surveys?spaceId=`, com `alreadyResponded`. Os abertos que ainda esperam a resposta dele estão em `GET /api/surveys/pending` (com o `responseMode` de cada um, `notice` se o aviso na aplicação deve aparecer e `blocking` se há um de resposta imediata), e o aviso de um fecha-se em `POST /api/surveys/{id}/notice/dismiss`. As duas rotas públicas, `/api/public/surveys/{publicToken}`, servem o inquérito e recebem a resposta sem sessão iniciada. Antes de enviar, a página pública pede um desafio em `/api/public/surveys/{publicToken}/challenge`, que o navegador resolve e envia 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 no agendado. Abrir com `startsAt` no futuro agenda: o `status` fica `scheduled` (os estados são `draft`, `scheduled`, `open` e `closed`) e o inquérito abre sozinho no `startsAt`; `startsAt: null` cancela. No resultado, `pending` (`count`, `members`, `truncated`) só vem no identificado com `required` ou `immediate`; no anónimo, o campo não existe.

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

| Erro | Quando |
|---|---|
| `403` | O papel não gere inquéritos, ou a pessoa com sessão iniciada não tem acesso ao espaço |
| `404` | O inquérito não existe, é de outra comunidade, ou o link está desativado |
| `409` | Já respondeu (o membro, em qualquer navegador; o visitante, no mesmo navegador), segundo inquérito num espaço **Um inquérito**, ou mudança para **Um inquérito** com dois ou mais |
| `422` | Criar sem `spaceId` ou com um espaço que não é de Inquéritos, estrutura inválida, inquérito em rascunho ou encerrado, fora do período (`notYetOpen` antes do início, `closed` depois do fim), fim antes do início (`closesBeforeStart`), abrir um já agendado (`alreadyScheduled`), alteração bloqueada depois de aberto, fechar o aviso de um de resposta imediata ainda sem resposta (`noticeRequired`), verificação contra robôs expirada, 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 de momento; tente de novo daqui a instantes |

## Relacionados

- [Módulos](/conceitos/modulos)
- [Visibilidade e acesso](/conceitos/visibilidade-e-acesso)
- [Campanhas de e-mail](/notificacoes/campanhas-de-email)
- [Sondagens](/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#inqueritos)