# Questionari

> Il modulo di spazio Questionari. Come il team crea uno spazio di un questionario o di più, prepara il questionario in sezioni in un editor che è già la schermata di risposta (da un modello NPS, soddisfazione, evento, corso, eNPS o vuoto), lo apre per chi ha accesso allo spazio con un invito via e-mail e/o con il link pubblico senza accesso, identificato o anonimo, e legge il risultato con filtri e CSV.

Il **questionario** è un modulo del team, con più domande organizzate in **sezioni**, per chi ha accesso a uno spazio della community e/o per chiunque abbia il **link pubblico**. Serve a misurare l'NPS della community, la soddisfazione per un evento o un corso, l'eNPS di un'azienda, o qualunque altra cosa il team voglia chiedere, senza Google Forms né Typeform, con il risultato riepilogato dentro la community.

**Questionari** è un [modulo di spazio](/conceitos/modulos), nella scheda **Community** di **Aggiungi Spazio**. Ogni questionario vive in uno spazio Questionari, e **chi ha accesso allo spazio è il suo pubblico**. Da non confondere con il [sondaggio](/espacos/enquetes) del Feed, che è una sola domanda pubblicata come post.

## Questionario o sondaggio

| | [Sondaggio](/espacos/enquetes) | Questionario |
|---|---|---|
| Che cos'è | Una domanda, da 2 a 10 opzioni, pubblicata come post | Un questionario: sezioni, fino a 100 domande, 5 tipi di domanda |
| Dove compare | Nel Feed o in uno spazio Contenuti, con reazioni e commenti | In uno spazio Questionari, in una schermata di risposta dedicata, a fasi; niente va nel Feed |
| Chi risponde | Chi vede il post | Chi ha accesso allo spazio e/o chiunque abbia il link pubblico, senza accesso |
| Anonimato | Il team vede chi ha votato cosa | Identificato o anonimo, scelto prima di aprire |
| Risultato | Barre nel post stesso | Pannello per sezione, NPS, filtri e CSV |

Per una domanda veloce di tutti i giorni, il sondaggio. Per un feedback strutturato, il questionario.

## A cosa serve

| Community | Questionario |
|---|---|
| Evento | Il questionario di soddisfazione dell'evento, a cui risponde col link anche chi non è membro |
| Scuola online | Il feedback su un corso: contenuti, docente, applicabilità |
| Coworking | L'NPS dei residenti, una volta a semestre |
| Azienda | L'eNPS del team, anonimo |

## Come funziona

### Lo spazio: un questionario o più

Alla creazione dello spazio, **Come funziona lo spazio** chiede:

| Modalità | Come si presenta |
|---|---|
| **Più questionari** (il predefinito) | Un elenco di questionari. Il team li vede tutti, con i filtri **Tutti**, **Bozze**, **Programmati**, **Aperti** e **Chiusi** (quello programmato mostra *Apre il…*), e li crea con **Nuovo questionario**; il membro vede quelli a cui può rispondere, con **Rispondi** o **Risposto**, e il contrassegno **Obbligatorio** su quelli obbligatori |
| **Un questionario** | Lo spazio è un questionario: chi lo apre ci arriva direttamente. Il team vede l'editor (o il risultato, dopo l'apertura); il membro, il modulo da compilare. Vuoto, mostra **Crea questionario** al team |

**Un questionario** è possibile solo con al massimo un questionario nello spazio (bozze e chiusi contano): passare a questa modalità con due o più viene rifiutato, e anche un secondo questionario. La modalità si cambia poi nelle impostazioni dello spazio.

**Lo spazio nasce con il questionario.** In **Un questionario**, **Avanti** porta a un terzo passaggio, **Questionario**, nella stessa finestra: **Inizia da** (un modello o **Vuoto**), **Titolo del questionario** (obbligatorio), **Descrizione**, **Modalità** (identificato o anonimo) e **Tipo di risposta**. **Crea questionario** crea lo spazio e il questionario, in bozza, e ne apre subito l'editor: *"Il questionario nasce come bozza: nessuno riceve nulla finché non lo apri."* Se il questionario viene rifiutato, lo spazio resta creato, il passaggio conserva quanto scritto e si riprova solo il questionario. Gli spazi con [una call](/espacos/chamada-de-trabalhos) e con [un corso](/espacos/cursos#corsi-in-modalita-un-solo-corso) funzionano allo stesso modo: finiscono aperti sulla call o sul corso.

Un esempio: uno spazio **Questionario dell'evento**, in modalità **Un questionario**, privato per chi ha comprato il biglietto; e uno spazio **Questionari**, in modalità **Più questionari**, aperto ai membri, con l'NPS del semestre e i questionari di ogni corso.

### Chi fa cosa

| Chi | Cosa fa |
|---|---|
| Proprietario e amministratore | Tutto: creano lo spazio e i questionari, modificano la bozza, attivano il link, aprono, chiudono, eliminano, vedono il risultato e le risposte ed esportano il CSV |
| Membro (e moderatore e finanza) | Con accesso allo spazio, risponde ai suoi questionari aperti, nello spazio o dall'invito via e-mail |
| Chi non ha un account | Risponde dal link pubblico, se il questionario è aperto e il link è attivo; nient'altro |

### I modelli

**Nuovo questionario** apre la scelta del modello. Le domande arrivano pronte, nella lingua della community, e tutto si modifica prima di aprire.

| Modello | Cosa contiene | Modalità |
|---|---|---|
| **NPS della community** | Una sezione: il voto da 0 a 10 e *"Che cosa ha pesato di più sul tuo voto?"* | Identificato |
| **Questionario di soddisfazione** | Una sezione: la soddisfazione generale da 1 a 5, in stelle, e un commento | Identificato |
| **Feedback sull'evento** | Quattro sezioni: **Contenuti** (interventi e temi), **Infrastruttura** (sede, cibo, Wi-Fi), **Esperienza** (organizzazione, NPS dell'evento e commento) e **Profilo** (*"Era la tua prima volta all'evento?"*). Le valutazioni usano Eccellente, Buono, Discreto, Scarso e Non applicabile | Anonimo, con il link pubblico attivo |
| **Feedback sul corso** | Una sezione: contenuti, docente e applicabilità, con la stessa scala, e *"Che cosa si potrebbe migliorare?"* | Identificato |
| **eNPS** | Una sezione: *"quanto consiglieresti l'azienda come luogo di lavoro?"* e il perché | Anonimo |
| **Vuoto** | Una sezione vuota, per costruire da zero | Identificato |

### Sezioni

Ogni questionario ha **almeno una sezione**, con titolo e descrizione facoltativa; ogni domanda appartiene a una sezione. Per chi risponde, le sezioni sono **fasi**:

- Il **titolo** e l'**introduzione** del questionario aprono la prima schermata, con la modalità (anonimo o identificato), il numero di fasi e di domande e il pulsante **Inizia**.
- In alto, la barra con il titolo di ogni fase (*Contenuti · Infrastruttura · Esperienza · Profilo*). Sul cellulare diventa *"Fase 2 di 4 · Infrastruttura"*. Un questionario di una sola sezione non mostra la barra.
- **Avanti** prosegue solo con le domande obbligatorie della fase risposte; **Indietro** mantiene quanto scelto; **Invia** compare nell'ultima fase.
- La risposta viene salvata **una sola volta, con Invia**. Niente resta sul server a metà: se la persona chiude la scheda prima, ricomincia.

Nel risultato, le domande appaiono raggruppate per sezione, nello stesso ordine. Un questionario ha fino a **20 sezioni** e **100 domande**.

### L'editor

Preparare il questionario significa modificare **la schermata stessa di chi risponde**, con i colori della community, come nell'editor delle [campagne](/notificacoes/campanhas-de-email):

- **Fai clic per scrivere** sul posto: titolo, introduzione, titolo e descrizione della sezione, testo della domanda, aiuto e opzioni.
- Le **sezioni** appaiono come le fasi, in schede in cima al canvas; **Sezione** ne crea una nuova. **Elimina sezione** cancella anche le sue domande, dopo la conferma.
- Il **+** tra le domande inserisce una domanda (uno dei 5 tipi) o una nuova sezione.
- **Trascina** dalla maniglia per riordinare le domande nella sezione; trascina una domanda sulla scheda di un'altra fase per spostarla lì; trascina le schede per riordinare le sezioni. **Sposta nella sezione**, **Su** e **Giù**, nel pannello, fanno lo stesso senza trascinare.
- Il **pannello** della domanda selezionata ha **Tipo**, **Obbligatoria**, le opzioni della scala, **Duplica** (copia anche le opzioni, utile quando la stessa scala si ripete) ed **Elimina**.
- **Computer** e **Cellulare** cambiano la larghezza; **Anteprima** percorre le fasi come chi risponde, con **Invia (anteprima)**, senza salvare nulla.

In alto ci sono **Pubblico e link**, **Modalità**, **Tipo di risposta**, **Periodo**, **Anteprima**, **Salva bozza** e **Apri** (o **Programma**, con un inizio nel futuro). Su uno programmato, **Annulla programmazione** al posto di **Apri**; su uno aperto, **Chiudi**. Accanto al titolo compare **Modifiche non salvate** o **Tutto salvato**.

La barra dell'editor mostra solo il titolo, lo stato e l'azione principale; le impostazioni diventano riepiloghi cliccabili, e **Metti in pausa**, **Chiudi** ed **Elimina** vanno in **Altre azioni**. L'avviso della modalità sta sopra l'introduzione, e un questionario **identificato** la cui introduzione parla di anonimato mostra *"L'introduzione parla di anonimato, ma il sondaggio è identificato."*, con **Correggi il testo**. I modelli mostrano le prime domande prima della scelta.

### I 5 tipi di domanda

| Tipo | Come si risponde | Dettagli |
|---|---|---|
| **Scelta singola** | Un'opzione | Da 2 a 30 opzioni, senza ripetizioni |
| **Scelta multipla** | Una o più opzioni | Da 2 a 30 opzioni |
| **Scala** | Un numero da un minimo a un massimo | Minimo 0 o 1, massimo da 2 a 10, etichette facoltative agli estremi (*Molto insoddisfatto*, *Molto soddisfatto*); **Mostra come stelle** usa una scala da 1 a 5 in stelle |
| **NPS (da 0 a 10)** | Un voto da 0 a 10 | Il risultato calcola l'NPS (vedi [Il risultato](#il-risultato)) |
| **Testo** | Una risposta scritta | Breve o **Risposta lunga**, fino a 5.000 caratteri |

Qualsiasi domanda può essere **Obbligatoria**. Non c'è logica condizionale (saltare domande in base alla risposta), né matrice né invio di file.

### Identificato o anonimo

La **Modalità** si sceglie nella bozza e **non cambia dopo l'apertura**. L'introduzione dichiara la modalità prima della prima domanda.

| Modalità | Cosa vede il team |
|---|---|
| **Identificato** | La risposta di ogni membro legata al suo nome, con la data. Chi risponde dal link pubblico senza accedere compare come **Visitatore**, con la data |
| **Anonimo** | Solo l'insieme: nessun nome, nessun orario, nessun elenco di chi ha risposto o di chi manca, né quanti mancano |

Nell'anonimo, l'introduzione dice esattamente: *"Questionario anonimo: la community non può collegare la risposta a te."* Questa è la promessa: la community (team, API, assistente, CSV) non ha modo di sapere chi ha risposto cosa. La risposta è salvata senza la persona e senza orario, separata dalla registrazione del fatto che ha risposto, e le risposte non compaiono mai nell'ordine in cui sono arrivate.

Le tutele dell'anonimo:

- **Minimo di 3 risposte.** Prima, il risultato mostra *"Il risultato appare con 3 risposte"* e nessun numero né testo.
- **Pubblicazione a blocchi di 3.** Le risposte entrano nel risultato 3 alla volta, sempre 3 nuove della stessa origine (membri o visitatori). Il numero di risposte cresce di 3 in 3, e una risposta da sola non cambia mai il risultato: confrontare due letture non rivela che cosa ha risposto una persona.
- **Filtro solo per origine.** Nell'anonimo il risultato si filtra solo per **membri** o **visitatori**; gruppo, tag e azienda restano per l'identificato. Il sottoinsieme compare quando esso **e il resto** hanno almeno 3 risposte ciascuno. Senza la regola del resto, un sottoinsieme di 3 in un questionario di 4 rivelerebbe la quarta persona per differenza.
- **Testi mescolati e senza data.**
- **CSV senza persona, segmento, origine e data**, solo da 3 risposte e solo con le risposte già pubblicate nei blocchi di 3.

> [!WARNING]
> In un questionario **identificato**, la risposta è un dato personale della community, che è il titolare del trattamento. Non chiedere di salute, religione, opinioni politiche o altri dati sensibili in un questionario identificato; se serve, usa quello anonimo.

### Pubblico e link

Il pubblico è **chi ha accesso allo spazio**: la sua [visibilità](/conceitos/visibilidade-e-acesso) e, in uno spazio privato, i gruppi, prodotti e piani di **Chi ha accesso**. Il questionario ha bisogno di **qualcuno con accesso allo spazio, del link pubblico attivo, o di entrambi**.

- **Pubblico**: **Pubblico e link** mostra quante persone hanno oggi accesso allo spazio (fino a 50.000), con alcuni nomi. Per cambiare chi risponde, cambia l'accesso dello spazio. Il pubblico viene **congelato quando il questionario si apre**: chi ottiene accesso allo spazio dopo non entra nel questionario.
- **Invito via e-mail**: all'apertura, con la casella **Avvisa via e-mail** selezionata (predefinita), ogni persona del pubblico riceve **un'**e-mail di invito, 10 minuti dopo, con il pulsante **Rispondi**, se ha lasciato attiva la categoria **Questionari** in [E-mail di questa community](/notificacoes/emails-desta-comunidade). Modificare il questionario dopo non lo rinvia. Il pulsante porta allo stesso indirizzo per tutti, quindi l'e-mail non collega nessuno a una risposta anonima.
- **Link per i membri**: l'indirizzo dell'invito. Chi ha accesso allo spazio risponde da lì, con l'accesso, o direttamente nello spazio. Chi lo apre con l'accesso e non ha accesso allo spazio vede *"Questo questionario non è per te"* (a meno che il link pubblico sia attivo).

  Il link dell'invito apre il questionario **dentro il suo spazio**, con il menu della community. Chi risponde arriva al modulo (o all'avviso di già risposto o chiuso, a seconda del caso); il proprietario e l'amministratore arrivano all'editor, se il questionario è una bozza o programmato, o ai risultati, se è aperto o chiuso. Se nessuno spazio del menu della persona contiene il questionario, la schermata di risposta a sé spiega perché. In uno spazio **Più questionari**, l'indirizzo del browser segue il questionario aperto: puoi copiarlo, mandarlo a qualcuno del team e ricaricare la pagina senza tornare all'elenco.

- **Spazio**: finché è in bozza, il questionario può essere spostato in un altro spazio Questionari.
- **Link pubblico**: chiunque abbia il link risponde **senza accedere**, sul dominio della community stessa (quello personalizzato, se c'è, o il suo indirizzo su `memberfy.net`, come `clube.memberfy.net/s/…`), con il marchio della community, anche se la community è privata (la pagina mostra solo il questionario). **Copia** copia l'indirizzo; disattivarlo fa dire al link *"Questo link non è disponibile"*. L'indirizzo è lungo e casuale: non si può indovinare quello di un altro questionario.

**Chi ha già risposto.** Dal link pubblico, la risposta ripetuta viene bloccata **per quanto possibile, senza garanzia**:

- **Chi apre il link senza accedere** riceve un marcatore **in questo browser** (la schermata avvisa: *"Salviamo un marcatore in questo browser solo per evitare risposte ripetute"*). Nello stesso browser, il secondo tentativo vede *"Hai già risposto da questo browser. Grazie!"*. **Una finestra in incognito, un altro browser, un altro dispositivo o i dati del browser cancellati rispondono di nuovo.** Se il questionario ha davvero bisogno di una risposta per persona, usa il pubblico dello spazio, senza il link pubblico.
- **Chi lo apre con l'accesso ed è membro della community del questionario** risponde **come membro**, davvero una sola volta, in qualsiasi browser: il secondo tentativo vede *"Hai già risposto"*. La risposta segue la modalità del questionario. Con l'accesso in un'altra community, conta come visitatore.

**Contro i bot e gli abusi**, il link pubblico ha:

- una **verifica anti-bot** fatta dal browser stesso in circa un secondo, senza cliccare nulla e senza inviare dati a terzi (se fallisce, la schermata chiede di inviare di nuovo);
- un limite di **300 invii ogni 10 minuti per rete**, per questionario (oltre, *"Troppi invii da questa rete. Attendi qualche minuto e riprova."*);
- un tetto di **5.000 risposte di visitatori** per questionario; le risposte dei membri non contano per il tetto;
- e il team può **disattivare il link** in qualsiasi momento.

L'indirizzo di rete di chi risponde non viene salvato con il questionario.

### Periodo e programmazione

**Periodo** definisce l'**Inizio** e la **Fine** della raccolta, nel fuso orario della community: *"Fuori da questo periodo nessuno risponde."* La fine deve essere dopo l'inizio.

- **Senza Inizio** (*All'apertura*), il questionario comincia quando il team fa clic su **Apri**.
- **Con un Inizio nel futuro**, il pulsante diventa **Programma**. La conferma dice quando si apre e da quando parte l'invito via e-mail: *"Il questionario si apre da solo il … e l'invito via e-mail parte da …. Nulla viene inviato prima."* A quell'ora il questionario **si apre da solo**, esattamente come se il team avesse fatto clic su **Apri**: il pubblico viene congelato in quel momento e l'invito parte 10 minuti dopo (se **Avvisa via e-mail** era selezionato al momento della programmazione).
- **Programmato**, resta **modificabile come una bozza**, per intero (domande, modalità, tipo di risposta, periodo). **Annulla programmazione** (o togliere l'Inizio) lo riporta a bozza: *"Programmazione annullata: il questionario è tornato bozza."*
- **Con una Fine**, si chiude da solo alla data e all'ora scelte. Senza, resta aperto finché qualcuno del team non fa **Chiudi**.

**Fuori dal periodo nessuno risponde, da nessuna strada** (nello spazio, dal link dell'invito o dal link pubblico). Prima dell'inizio, la schermata dice *"Questo questionario non è ancora iniziato"* e quando si apre; dopo la fine, o se chiuso, il link pubblico mostra *"Questionario chiuso"*. **Un questionario chiuso non si riapre**; le risposte e il risultato restano disponibili.

### Tipo di risposta

**Tipo di risposta** dice quanto la community conta sulla risposta. Si sceglie nella bozza (o nel passaggio **Questionario** dello spazio con un questionario) e **si blocca all'apertura**.

| Tipo | Per chi è nel pubblico |
|---|---|
| **Questionario facoltativo** (il predefinito) | L'invito via e-mail e il questionario nello spazio. Nessuna finestra nell'app: *"Nessuno viene sollecitato."* |
| **Questionario obbligatorio** | Contrassegnato come **Obbligatorio** nell'elenco e nella schermata di risposta (*"Questo questionario è obbligatorio: il team conta sulla tua risposta."*), e l'invito dice che la risposta è obbligatoria. Entrando nell'app, la finestra *"Un questionario aspetta la tua risposta"*, con **Non ora** |
| **Risposta immediata** | Come l'obbligatorio, ma la finestra non ha **Non ora** e non si chiude: *"Per continuare a usare l'app, rispondi a questo questionario."* Sparisce quando la persona risponde o quando il questionario si chiude |

Il tipo vale per chi è entrato nel pubblico all'apertura; chi ha ottenuto l'accesso allo spazio dopo vede il questionario come facoltativo. Nell'identificato, obbligatorio e immediata mostrano nel risultato chi deve ancora rispondere (vedi [Il risultato](#il-risultato)).

Dopo l'apertura, la struttura si blocca: cambiano solo il **titolo**, l'**introduzione**, la **Fine** del periodo e il **link pubblico** (attivo o no), con **Salva modifiche**. L'**Inizio**, la **Modalità** e il **Tipo di risposta** non cambiano più.

Eliminare lo spazio elimina i suoi questionari e disattiva i link pubblici.

### Chi esce dalla community

Quando un membro esce dalla community (da sé, rimosso dal team, tramite l'assistente, alla fine del legame con l'azienda o rifiutando un invito da importazione), **le sue risposte identificate vengono cancellate definitivamente**, e il risultato si ricalcola. Le risposte **anonime restano**, perché non c'è modo di sapere di chi siano. È l'unica eccezione alla regola per cui Memberfy conserva i dati della community.

## Passo dopo passo

### Creare lo spazio

*Ruolo: proprietario o amministratore.*

1. Nel menu, sotto la sezione, fai clic su **Aggiungi Spazio**.
2. Nella scheda **Community**, scegli **Questionari** e fai clic su **Avanti**.
3. Scrivi il titolo, scegli la **Visibilità** (e, se è **Privata**, **Chi ha accesso**): è chi risponderà.
4. In **Come funziona lo spazio**, scegli **Più questionari** o **Un questionario**. Con **Più questionari**, crea lo spazio.
5. Con **Un questionario**, **Avanti** porta al passaggio **Questionario**: scegli il modello (o **Vuoto**), il titolo, la descrizione, la **Modalità** e il **Tipo di risposta**, e fai clic su **Crea questionario**. Lo spazio e il questionario nascono insieme e si apre l'editor; prosegui da [Creare e aprire il questionario](#creare-e-aprire-il-questionario), passaggio 3.

Vedi [Creare e organizzare gli spazi](/espacos/criar-e-organizar-espacos).

### Creare e aprire il questionario

1. Nello spazio, fai clic su **Nuovo questionario** (in modalità **Un questionario**, **Crea questionario**).
2. Scegli un modello, oppure **Vuoto**.
3. Sistema titolo, introduzione, sezioni e domande direttamente sul canvas. Controlla in **Anteprima**.
4. In **Modalità**, scegli **Identificato** o **Anonimo**. In **Tipo di risposta**, **Questionario facoltativo**, **Questionario obbligatorio** o **Risposta immediata**.
5. In **Pubblico e link**, controlla quante persone hanno accesso allo spazio e, se vuoi, attiva il **Link pubblico**. In **Periodo**, l'**Inizio** (vuoto per cominciare all'apertura) e la **Fine**, se c'è.
6. **Salva bozza**. Fino all'apertura nessuno vede il questionario, nemmeno dal link.
7. **Apri** e conferma: la finestra dice a quante persone va l'invito via e-mail. Il pubblico viene congelato e il questionario inizia ad accettare risposte. Con un Inizio nel futuro, il pulsante è **Programma**: il questionario diventa **Programmato** e si apre da solo all'ora fissata.
8. Se il link pubblico è attivo, diffondi l'indirizzo, copiato da **Pubblico e link**.

### Rispondere (membro)

Chi ha accesso allo spazio risponde in due modi: aprendo lo spazio dal menu (in modalità **Più questionari**, facendo clic su **Rispondi**) o con il pulsante **Rispondi** dell'invito via e-mail. Un questionario a cui ha già risposto compare come **Risposto**; uno obbligatorio, come **Obbligatorio**. Un questionario programmato non compare a chi risponde finché non si apre; chi arriva prima dal link vede *"Questo questionario non è ancora iniziato"*.

**L'avviso nell'app.** Solo per i questionari **obbligatori** e a **risposta immediata**: entrando nella community, chi è nel pubblico e non ha ancora risposto vede un unico avviso (*"Un questionario aspetta la tua risposta"*), con ogni questionario, la scadenza e se è **Anonimo**. Cliccando su un questionario si apre la risposta. Nell'obbligatorio, **Non ora** chiude l'avviso di quei questionari, e non torna per loro. In quello a risposta immediata non c'è **Non ora**: l'avviso torna a ogni schermata finché la persona non risponde o il questionario si chiude. Rispondere toglie il questionario dall'avviso. Il questionario facoltativo non apre avvisi: arriva con l'invito via e-mail e nell'elenco dello spazio.

### Vedere il risultato

Nello spazio, fai clic su un questionario aperto o chiuso (una bozza apre l'editor); in modalità **Un questionario**, il risultato compare direttamente dopo l'apertura. L'elenco mostra, per ciascuno, destinatari, risposte e scadenza.

## Il risultato

**L'intestazione.** Il titolo del questionario, lo stato (**Aperto**, **Chiuso**…), se è **Identificato** o **Anonimo** e la scadenza, con **Modifica** ed **Esporta CSV**. Nell'anonimo, la **(i)** accanto ad **Anonimo** spiega le regole di anonimato (i blocchi e il filtro solo per origine). Sul telefono, i pulsanti mostrano solo l'icona.

**Le sezioni, in schede.** Subito sotto, le schede **Riepilogo**, **Risposte individuali** (solo nell'identificato), **Round** (solo nel ricorrente) e **Mappa di calore** (solo nell'identificato). Sulla stessa riga ci sono i filtri: **Origine** (**Tutte**, membri o visitatori) e **Segmento** (un gruppo, un tag o un'azienda; **Tutti i segmenti** torna al totale). Sul telefono, i filtri stanno in **Filtri**. Un questionario senza altre schede mostra l'origine come pulsanti.

**Le card in alto.** Solo quelle che hanno qualcosa da dire, divise in parti uguali sulla riga:

| Card | Cosa mostra | Quando compare |
|---|---|---|
| **Risposte** | Il totale, con *N da membri · N da visitatori* | Ogni volta che c'è una risposta |
| **Tasso di risposta** | La percentuale sui destinatari (*di N destinatari*). I visitatori non entrano nel conto, perché non hanno un denominatore. Nell'anonimo conta solo le risposte già pubblicate | Quando il questionario ha destinatari |
| **Ultima risposta** | Quanto tempo fa è arrivata l'ultima, con *N negli ultimi 7 giorni* | Nell'identificato |
| **Ultimo blocco pubblicato** | Quanto tempo fa l'ultimo blocco è entrato nel risultato, con *N negli ultimi 7 giorni* | Nell'anonimo |
| **NPS** | Il punteggio della prima domanda NPS e le tre fasce: **Detrattori**, **Passivi** e **Promotori**, in percentuale | Quando il questionario ha una domanda NPS |

**Risposte al giorno.** Un grafico con quante risposte sono arrivate ogni giorno, nel fuso orario della community, seguendo il filtro. Nell'**anonimo**, il questionario non conserva l'ora di nessuna risposta: il grafico si chiama **Risposte pubblicate al giorno** e conta i blocchi entrati nel risultato ogni giorno, mai quando qualcuno ha risposto. Le risposte pubblicate prima di questo conteggio compaiono in una nota sotto. Il grafico compare solo con almeno due giorni e qualche risposta. In un sondaggio anonimo filtrato per **Origine** o **Segmento**, quando parte delle risposte è stata pubblicata prima del registro giornaliero, il grafico non compare e al suo posto c'è *"Il grafico giornaliero non è disponibile per questo segmento."*

**Una card per domanda**, raggruppate per sezione (il nome della sezione compare quando ce n'è più di una), su due colonne sullo schermo largo. Ogni card indica il tipo e quante persone hanno risposto:

- **Scelta singola e scelta multipla:** barre con la percentuale e il conteggio; l'opzione più scelta è evidenziata.
- **NPS:** il punteggio (da −100 a 100: % di promotori meno % di detrattori), le tre fasce e l'istogramma da 0 a 10 con la **Media**. I promotori sono i voti 9 e 10, i passivi 7 e 8, i detrattori da 0 a 6.
- **Scala:** la **Media** e l'istogramma dei voti.
- **Testo:** le risposte in elenco (fino a 1.000 per domanda). Con più di 4, compaiono le prime 4, la ricerca **Cerca nelle risposte** e **Vedi tutte (N)**.
- Una domanda a cui nessuno ha risposto dice *"Nessuno ha ancora risposto a questa domanda."*

**Stati vuoti.** Senza nessuna risposta: *"Ancora nessuna risposta"*, con *"Il risultato appare qui non appena arrivano le prime risposte."* (oppure *"Il sondaggio si è chiuso senza risposte."*). Con un filtro senza nulla: *"Nessuna risposta in questo segmento."* Nell'**anonimo** con meno di 3 risposte pubblicate: *"Il risultato appare con 3 risposte"*, senza nessun numero, e la spiegazione: dopo, il risultato cresce in blocchi di 3 risposte, pubblicati ogni ora, perché nessuno scopra chi ha appena risposto.

**Nelle altre schede:**

- **Risposte individuali:** solo nell'identificato, con il nome del membro (o *Visitatore*) e la data, dalla più recente.
- **Devono ancora rispondere:** solo nell'**identificato** con **Questionario obbligatorio** o **Risposta immediata**, sopra il riepilogo: i nomi di chi è nel pubblico e non ha ancora risposto, con il conteggio (*"Mostrati N di M."* quando l'elenco è lungo), oppure *"Tutto il pubblico ha già risposto."* Nell'**anonimo**, il risultato non mostra nulla su chi o quanti mancano, in nessun tipo di risposta: confrontare il conteggio prima e dopo una risposta rivelerebbe chi ha risposto.
- **Filtro:** uno alla volta. Nell'anonimo, solo **Origine**, con il minimo di 3 e la regola del complemento.
- **Esporta CSV:** una riga per risposta e una colonna per domanda, con la sezione nell'intestazione. Nell'identificato inizia con nome, e-mail, origine e data della risposta; nell'anonimo, solo le risposte già pubblicate, mescolate, e solo da 3. La **Mappa di calore** e i **Round** hanno la propria esportazione.

## Questionario ricorrente e mappa di calore

### Ripetere il questionario

Per misurare il clima o l'eNPS a intervalli regolari senza ricreare il questionario, attiva **Ripeti** in **Periodo del questionario** (pulsante **Periodo**), con il questionario in bozza:

| Campo | Cosa definisce |
|---|---|
| **Frequenza** | **Settimanale**, **Ogni 2 settimane**, **Mensile** o **Trimestrale** |
| **Giorno della settimana** o **Giorno del mese** | Il giorno della settimana nella settimanale e in quella ogni 2 settimane; il giorno del mese (da 1 a 28) nella mensile e nella trimestrale |
| **Ora** | L'ora in cui si apre ogni round, nel fuso orario della community |
| **Durata (giorni)** | Quanto resta aperto ogni round: fino a 7 giorni nella settimanale, 14 in quella ogni 2 settimane, 28 nella mensile e 90 nella trimestrale |
| **Invita via e-mail a ogni round** | L'invito della categoria **Questionari** a ogni round (attivo per impostazione predefinita) |

**Salva e attiva la ripetizione**. Il questionario riceve l'etichetta **Ricorrente** e il riepilogo mostra **Ripetizione attiva**, la pianificazione (*"Il giorno 1 di ogni mese, 09:00 · aperto 7 giorni"*) e il **Prossimo round**. Non ha **Apri**: si apre solo a round.

- **Ogni round è una copia del questionario** che si apre da solo nel giorno e all'ora scelti, con il pubblico di quel momento (chi ha accesso allo spazio in quel momento), invia l'invito e si chiude alla fine della durata. La modalità (identificato o anonimo) e le regole di pubblicazione del risultato valgono in ogni round.
- **Ognuno risponde una volta per round**; la risposta di un round non conta per un altro.
- **Modificare le domande vale solo per i prossimi round.** Il questionario ricorrente resta modificabile; il round aperto continua con le domande con cui si è aperto.
- **Metti in pausa** smette di aprire nuovi round, senza chiudere quello aperto; **Riprendi ripetizione** riattiva la pianificazione. **Termina ripetizione** chiede conferma e non si torna indietro: non si apre nessun nuovo round, quelli già svolti restano nel risultato e quello aperto continua fino alla chiusura.
- Nello spazio **Un questionario**, chi risponde finisce nel round aperto più recente. Eliminare il questionario ricorrente elimina i suoi round.

### Round ed evoluzione

Nel risultato di un questionario ricorrente, la scheda **Round** si apre per prima:

- un grafico a linee per ogni domanda NPS o di scala, con l'**Evoluzione per round**;
- la tabella dei round, con **Apertura**, **Risposte**, **Tasso** e il valore di ogni domanda, e **Vedi risultato** per aprire il risultato di quel round.

Il selettore **Round**, in alto, cambia il round del riepilogo, delle risposte e della mappa. Nell'anonimo, il round con meno di 3 risposte e il round ancora aperto appaiono **senza numero**.

### Mappa di calore

Nel questionario **identificato** (ricorrente o no), la scheda **Mappa di calore** mostra dove il voto è migliore o peggiore:

- **Raggruppa per**: **Gruppo principale**, **Tag** o **Azienda**, uno alla volta. Per tag e per azienda, chi ne ha più di uno conta in ogni riga;
- una colonna per ogni domanda NPS e di scala, la colonna **Risposte** e la riga del totale;
- ogni cella con il valore, il conteggio delle risposte e un colore in cinque fasce, da **Peggio** a **Meglio**. La mappa usa il gruppo, il tag e l'azienda della persona al momento della risposta, e conta solo le risposte dei membri;
- nel ricorrente, la mappa è quella del round scelto, con la **Variazione** di ogni cella rispetto al round precedente;
- **Esporta mappa (CSV)** scarica ciò che è sullo schermo.

La mappa di calore raggruppa con un controllo compatto, chiama le colonne **D1**, **D2**… con le domande sotto, spiega la freccia della variazione (*"+3 rispetto al turno precedente"*) e ha un'unica esportazione. Anche nel questionario identificato, un gruppo con meno di 3 risposte compare come **Poche risposte**, senza numero.

Nel questionario **anonimo**, la mappa di calore non è disponibile.

Round e mappa sono del proprietario e dell'amministratore; il moderatore e i membri non li vedono.

## Esempio: il questionario di soddisfazione di un evento

Un evento tech è appena finito e l'organizzazione vuole sentire chi c'era, membro o no:

1. **Nuovo questionario › Feedback sull'evento**, nello spazio dell'evento. Titolo: *Questionario di soddisfazione dell'evento*. Introduzione: *"Grazie per aver partecipato alla 10ª edizione! Ci vogliono meno di 2 minuti."*
2. Le quattro sezioni ci sono già: **Contenuti**, **Infrastruttura**, **Esperienza** e **Profilo**. In **Contenuti**, il team aggiunge *"Qualità del percorso sulle API"* con **Duplica** su una domanda pronta (la scala Eccellente…Non applicabile viene con lei) e crea una scelta singola con opzioni proprie: *"La durata degli interventi è stata…"* *Troppo breve*, *Giusta*, *Troppo lunga*.
3. **Modalità: Anonimo** e **Link pubblico** attivo (entrambi così nel modello). Il questionario vive in uno spazio **Questionario dell'evento**, in modalità **Un questionario**, privato per il prodotto del biglietto: chi l'ha comprato riceve l'invito via e-mail all'apertura. **Scadenza:** una settimana.
4. **Apri**, copia il link pubblico e mandalo nel gruppo dell'evento, per chi non ha un account.
5. Chi c'era risponde dal cellulare, senza account, in quattro fasi. Alla terza risposta compare il risultato, che da lì cambia di 3 in 3; il filtro **Origine** separa membri e visitatori quando ciascun lato ne ha almeno 3.

## Con l'assistente (MCP)

Il proprietario e l'amministratore fanno con l'assistente quasi tutto quello che fanno nello spazio: creare lo spazio Questionari (con la modalità), vedere i modelli, creare il questionario nello spazio con sezioni e domande, il periodo (`starts_at`, `closes_at`) e il tipo di risposta (`response_mode`), modificare la bozza o quello programmato (o spostarlo in un altro spazio), controllare la portata del pubblico, aprire o programmare (`open_survey` con uno `starts_at` nel futuro programma; `starts_at` nullo annulla), attivare il link (la risposta riporta l'indirizzo pubblico), leggere il risultato con un filtro (con chi deve ancora rispondere, solo nell'identificato), elencare le risposte individuali ed esportare il CSV. **Aprire** e **programmare** (perché inviano l'invito via e-mail), **chiudere** ed **eliminare** chiedono la tua conferma; il resto agisce alla prima chiamata. La ricetta **Fare un questionario** lo prepara, lo apre e ne riassume il risultato con te.

Qualsiasi membro chiede all'assistente quali questionari aspettano la sua risposta (`list_my_pending_surveys`), con il link per rispondere nell'app e il tipo di risposta (`response_mode`) di ciascuno.

Il questionario ricorrente si fa anche con l'assistente, con `recurrence` in `create_survey` e `update_survey`, mettere in pausa, riprendere e terminare la ripetizione (terminare chiede conferma), i round, l'evoluzione e la mappa di calore dell'identificato, con il CSV. Vedi [Strumenti · Membri](/mcp/ferramentas-membros#questionario-ricorrente-e-mappa-di-calore).

**Rispondere a un questionario con l'assistente non esiste**: il registro di ciò che l'assistente fa per conto di qualcuno identificherebbe chi ha risposto. Vedi [Strumenti · Membri](/mcp/ferramentas-membros#questionari).

`get_survey_results` restituisce anche `activity`, le risposte al giorno: nell'anonimo, il conteggio è delle risposte pubblicate ogni giorno, e l'assistente non dice mai quando qualcuno ha risposto.

## Errori comuni e come risolverli

| Messaggio | Perché | Cosa fare |
|---|---|---|
| *Scegli un pubblico, attiva il link pubblico, o entrambi, prima di aprire.* | Nessuno ha accesso allo spazio e il link pubblico è disattivato | Cambia l'accesso dello spazio o attiva il link pubblico in **Pubblico e link** |
| *Questo spazio contiene un solo questionario e c'è già…* | Lo spazio è in modalità **Un questionario** | Crea il nuovo in un altro spazio, o passa lo spazio a **Più questionari** |
| *Questo spazio ha N questionari e "Un questionario" ne accetta uno solo…* | Passaggio a **Un questionario** con più di un questionario nello spazio | Elimina gli altri (niente viene eliminato da solo) o mantieni **Più questionari** |
| *Aggiungi almeno una domanda prima di aprire.* | Ci sono solo sezioni vuote | Usa il **+** per aggiungere una domanda |
| *Dopo l'apertura, del questionario cambiano solo il titolo, la descrizione, la scadenza e il link pubblico.* | La struttura, l'inizio, la modalità e il tipo di risposta si bloccano all'apertura | Per cambiare le domande, crea un altro questionario |
| *Il risultato appare con 3 risposte.* | Questionario anonimo con meno di 3 risposte pubblicate | Attendi altre risposte |
| *Questo questionario non è per te.* | La persona ha fatto l'accesso, non ha accesso allo spazio e il link pubblico è disattivato | Dalle accesso allo spazio prima di aprire, o attiva il link pubblico |
| *Questo questionario ha già ricevuto il massimo di 5000 risposte tramite il link pubblico.* | Il tetto dei visitatori | Chiudilo o crea un altro questionario |
| *Questo questionario non è ancora iniziato.* | Il questionario è programmato, o il suo Inizio non è ancora arrivato | Aspetta l'ora dell'Inizio o, nel team, togli l'Inizio e aprilo ora |
| *La fine deve essere dopo l'inizio.* | In **Periodo**, la Fine viene prima dell'Inizio | Correggi una delle date |
| *Questo questionario è già programmato. Per aprirlo ora, togli la data di inizio.* | **Apri** su un questionario già programmato | **Annulla programmazione** o togli l'Inizio, poi aprilo |

## Nell'API

Lo spazio è `module: "surveys"`, con `moduleConfig.mode` `single` o `multi` nella creazione e nella modifica dello spazio; `GET` e `PUT /api/surveys/spaces/{spaceId}` leggono e cambiano la modalità (in `single`, il `GET` porta il questionario). Le rotte del team sono in `/api/surveys` (proprietario e amministratore, con `X-CommunityId`): modelli, elenco (`?spaceId=`), creare (con `spaceId`, obbligatorio), modificare (nella bozza o in quello programmato, l'albero intero di sezioni e domande, e `spaceId` per spostarlo), anteprima del pubblico (`spaceId` o `surveyId`), aprire, chiudere, eliminare, risultato con un filtro (`groupId`, `tag`, `companyId` o `origin`; nell'anonimo solo `origin`, gli altri restituiscono 422), risposte individuali e CSV. Il membro elenca i questionari a cui può rispondere con `GET /api/surveys?spaceId=`, con `alreadyResponded`. Quelli aperti che aspettano ancora la sua risposta sono in `GET /api/surveys/pending` (con il `responseMode` di ciascuno, `notice` se l'avviso nell'app deve comparire e `blocking` se ce n'è uno a risposta immediata), e l'avviso di uno si chiude in `POST /api/surveys/{id}/notice/dismiss`. Le due rotte pubbliche, `/api/public/surveys/{publicToken}`, servono il questionario e ricevono la risposta senza accesso. Prima dell'invio, la pagina pubblica chiede una sfida a `/api/public/surveys/{publicToken}/challenge`, che il browser risolve e invia con la risposta.

**Periodo e tipo di risposta.** Creare e modificare accettano `startsAt` e `closesAt` (la fine dopo l'inizio) e `responseMode` (`optional`, il predefinito, `required` o `immediate`), nella bozza e in quello programmato. Aprire con `startsAt` nel futuro lo programma: lo `status` diventa `scheduled` (gli stati sono `draft`, `scheduled`, `open` e `closed`) e il questionario si apre da solo a `startsAt`; `startsAt: null` annulla. Nel risultato, `pending` (`count`, `members`, `truncated`) arriva solo nell'identificato con `required` o `immediate`; nell'anonimo il campo non esiste.

**Risposte al giorno.** `GET /api/surveys/{id}/results` restituisce `activity` (nullo quando `locked`), solo conteggi, nel fuso orario della community e seguendo il filtro: `basis`, `timeZone`, `days` (`[{ date, count }]`), `lastAt`, `lastWeek` (quante negli ultimi 7 giorni) e `untracked`. Nell'identificato, `basis` è `response` e conta ogni risposta nel suo giorno. Nell'anonimo, `basis` è `publication`: la risposta anonima non conserva l'ora, quindi il conteggio è dei blocchi pubblicati ogni ora, nel giorno della pubblicazione; `untracked` sono le risposte pubblicate prima di questo conteggio.

| Errore | Quando |
|---|---|
| `403` | Il ruolo non gestisce i questionari, o la persona che ha fatto l'accesso non ha accesso allo spazio |
| `404` | Il questionario non esiste, è di un'altra community, o il link è disattivato |
| `409` | Ha già risposto (il membro, in qualsiasi browser; il visitatore, nello stesso browser), secondo questionario in uno spazio **Un questionario**, o passaggio a **Un questionario** con due o più |
| `422` | Creazione senza `spaceId` o con uno spazio che non è Questionari, struttura non valida, questionario in bozza o chiuso, fuori dal periodo (`notYetOpen` prima dell'inizio, `closed` dopo la fine), fine prima dell'inizio (`closesBeforeStart`), aprire uno già programmato (`alreadyScheduled`), modifica bloccata dopo l'apertura, chiudere l'avviso di uno a risposta immediata ancora senza risposta (`noticeRequired`), verifica anti-bot scaduta, sottoinsieme sotto il minimo |
| `429` | Limite di invii della rete o tetto di 5.000 risposte di visitatori |
| `503` | La verifica anti-bot non è disponibile al momento; riprova tra poco |

## Correlati

- [Moduli](/conceitos/modulos)
- [Visibilità e accesso](/conceitos/visibilidade-e-acesso)
- [Campagne e-mail](/notificacoes/campanhas-de-email)
- [Sondaggi](/espacos/enquetes)
- [Gruppi e organigramma](/membros/grupos-e-organograma)
- [Tag](/membros/tags)
- [Ruoli e permessi](/conceitos/papeis-e-permissoes)
- [Strumenti · Membri](/mcp/ferramentas-membros#questionari)