# Moduli (form)

> Il modulo di spazio Moduli. Come creare uno spazio di un modulo o di più, costruire i campi nell'editor (14 tipi, passaggi, obbligatorio, blocco al profilo, anteprima), scegliere chi compila, proteggere con una password, pubblicare tramite link, ricevere ogni invio via e-mail, lavorare l'elenco degli invii con stato, filtri e CSV, salvare chi ha inviato come membro e portare gli invii a webhook, HubSpot e RD Station.

Il **modulo** (il form da compilare) raccoglie dati strutturati da chi è membro e da chi non lo è ancora: la richiesta di demo dal tuo sito, l'iscrizione a un programma, la candidatura a una posizione, la registrazione di interesse per un corso che deve ancora aprire. Ogni invio arriva via e-mail ai responsabili e resta in un **elenco degli invii**, uno per uno, con uno stato di gestione, filtri e CSV, dentro la community, senza Google Forms né Typeform.

**Moduli** è un [modulo di spazio](/conceitos/modulos), nella scheda **Community** di **Aggiungi Spazio**, con la descrizione *"Raccogli dati da membri e visitatori, con elenco degli invii"*. Ogni modulo vive in uno spazio Moduli.

## Modulo o questionario

| | [Questionario](/espacos/pesquisas) | Modulo |
|---|---|---|
| A cosa serve | Misurare un'opinione: NPS, soddisfazione, clima | Raccogliere dati di contatto e richieste |
| Tipi di campo | Scelta, scala, NPS e testo | Nome, e-mail, telefono, azienda, ruolo, testo, scelte, numero, data, link e consenso |
| Cosa vede il team | Il risultato riepilogato (grafici, NPS), con anonimato facoltativo | Ogni invio, uno per uno, con nome ed e-mail, e uno stato di gestione |
| Avviso | Invito via e-mail all'apertura | Un'e-mail ai responsabili a ogni invio |
| Diventa membro | No | Facoltativo: **Salva come membro** |

## Creare lo spazio

1. Nella barra laterale, **Aggiungi Spazio**, scheda **Community**, **Moduli**.
2. In **Come funziona lo spazio**, scegli:
   - **Un modulo**: *"Lo spazio è il modulo stesso e si apre direttamente su di esso."* Il passaggio successivo della stessa finestra chiede il **Titolo del modulo** (e un'**Introduzione (facoltativa)**); **Crea modulo** termina nel suo editor.
   - **Più moduli**: *"Un elenco: crea tutti i moduli che vuoi in questo spazio."* Lo spazio si apre sull'elenco, con **Nuovo modulo**.
3. Il modulo nasce come **Bozza**: *"nessuno lo vede finché non lo pubblichi"*, nemmeno tramite il link.

### Chi crea

Chi lo spazio lascia pubblicare: l'opzione **Chi può pubblicare** dello spazio (vedi [Spazi](/conceitos/espacos)). Il proprietario e l'amministratore possono sempre. In uno spazio **Più moduli**, chi non è nella selezione non vede **Nuovo modulo** (e l'API risponde 403). In uno spazio **Un modulo**, il modulo nasce con lo spazio, da chi l'ha creato.

Un membro che crea un modulo lo gestisce come il team, con una differenza: le opzioni **Chiunque abbia il link** e **Salva come membro** sono **solo del team** (proprietario, amministratore, moderatore e finanza). Il membro non le vede nell'editor, e l'API rifiuta con 403 se prova ad attivarle.

## L'editor

L'editor è già la schermata che vede chi compila: scrivi il titolo e l'introduzione al loro posto, e ogni campo appare come apparirà.

- **Passaggi.** Il modulo si divide in passaggi (sezioni), ciascuno con titolo e descrizione; chi compila va avanti con **Avanti**. **Nuovo passaggio** ne crea un altro; **Rimuovi passaggio** toglie il passaggio e i suoi campi (gli invii già ricevuti mantengono le risposte). Fino a 20 passaggi.
- **Campi.** **Aggiungi campo** o il **+** tra due campi inserisce in quel punto. Fino a 100 campi per modulo. Trascina per riordinare, oppure usa **Su**, **Giù** e **Sposta al passaggio**.
- **Proprietà.** Fai clic su un campo per aprire il pannello **Campo**: **Tipo**, **Obbligatorio**, **Testo di esempio nel campo** e, nel numero, **Minimo** e **Massimo**. L'etichetta e il **Testo di aiuto** li scrivi nel campo stesso. **Duplica** e **Rimuovi** sono nel pannello.
- **Salvare.** In alto compare *Modifiche non salvate* o *Tutto salvato*; **Salva** registra.
- **Anteprima.** **Anteprima** mostra il modulo **Come membro** (con nome, e-mail e telefono di esempio presi da un profilo) o **Come visitatore**, senza salvare nulla; alla fine mostra il messaggio di ringraziamento o dove andrebbe la persona.

### I 14 tipi di campo

| Tipo | Cosa controlla |
|---|---|
| **Nome** | Testo; viene dal profilo per il membro che ha effettuato l'accesso |
| **E-mail** | Un indirizzo valido; viene dal profilo |
| **Telefono** | Con il paese, in formato internazionale; viene dal profilo |
| **Azienda** | Testo |
| **Ruolo** | Testo |
| **Testo breve** | Fino a 200 caratteri |
| **Testo lungo** | Fino a 5.000 caratteri |
| **Scelta singola** | Una delle opzioni (da 2 a 50) |
| **Scelta multipla** | Una o più opzioni (da 2 a 50) |
| **Numero** | Un numero, entro il minimo e il massimo, se ci sono |
| **Data** | Una data valida |
| **Link (URL)** | Un indirizzo che inizia con `http://` o `https://` |
| **Documento (CPF o passaporto)** | Un CPF con le cifre di controllo, oppure passaporto e altri documenti come testo (da 3 a 40 caratteri); il team vede il numero intero |
| **Consenso (privacy)** | La casella di accettazione, sempre obbligatoria |

Nome, e-mail, telefono, azienda e ruolo entrano una volta ciascuno per modulo: sono loro a formare il contatto (nell'elenco, nella ricerca, nelle e-mail e in **Salva come membro**).

### Blocca al profilo

Nei campi **Nome**, **E-mail** e **Telefono**, il membro che ha effettuato l'accesso trova già il valore del profilo compilato. Con **Blocca al profilo** attivo (*"Per un membro che ha effettuato l'accesso, il valore viene dal profilo e non si modifica"*), non può cambiare il valore nel modulo, e il campo mostra *"Dal tuo profilo."* Disattivato, il valore arriva compilato e la persona può cambiarlo. Per il visitatore, il campo è normale.

## Impostazioni

**Impostazioni**, in alto nell'editor, apre quattro schede. Valgono quando salvi il modulo.

### Chi compila

| Opzione | Cosa fa |
|---|---|
| **Membri con accesso allo spazio** | *"Compilano nell'app o tramite il link, con accesso."* L'invio resta legato al membro |
| **Chiunque abbia il link** | *"Senza accesso, con verifica anti-robot e consenso obbligatorio."* Solo il team lo attiva |
| **Salva come membro** | Ogni invio invita la persona nella community, con un tag con il nome del modulo (vedi sotto). Richiede un campo e-mail obbligatorio. Solo il team lo attiva |
| **Password di accesso** | *"Chi apre il link digita la password prima di vedere il modulo. Non è la password di un account."* Minimo 6 caratteri; per cambiarla, digita quella nuova (vuoto, mantiene quella attuale) |
| **Informativa sulla privacy (link)** | Compare nel consenso. Senza di essa, valgono i [termini d'uso di Memberfy](/conceitos/termos-de-uso) |

Spunta almeno una delle prime due. Un modulo aperto ai visitatori ha sempre il campo **Consenso (privacy)**: l'editor lo aggiunge da solo e non permette di rimuoverlo.

### Dopo l'invio

- **Mostra un messaggio**: il **Messaggio di ringraziamento** sulla stessa schermata. Se non ne scrivi uno, compare *"Abbiamo ricevuto il tuo invio. Grazie! Le tue risposte sono arrivate al team."*
- **Porta a un sito**: la persona va al **Link di destinazione (https)**, che deve iniziare con `https://`.

### Scadenza e limite

- **Chiudi il**: la data e l'ora in cui il modulo si chiude da solo, nel fuso orario della community (la sigla compare accanto). Senza data, resta aperto finché non lo chiudi. **Togli la scadenza** la cancella.
- **Limite di invii**: *"Raggiunto il limite, il modulo si chiude da solo."* Il limite viene controllato nell'invio stesso: due invii contemporanei non lo superano mai. Senza numero, **Senza limite**.

### Avvisi

- **Responsabili**: chi riceve un'e-mail a ogni invio e vede l'elenco degli invii, fino a 20 persone (cerca per nome). Chi crea il modulo entra come responsabile.
- **Conferma a chi ha inviato**: attiva per impostazione predefinita, invia l'e-mail *"Abbiamo ricevuto il tuo invio"* all'indirizzo del campo e-mail (per il membro che ha effettuato l'accesso, l'e-mail dell'account). Il testo è fisso: dice solo che la community ha ricevuto l'invio, con il colore della community, senza ripetere le risposte.

## Pubblicare, chiudere ed eliminare

| Stato | Cosa succede |
|---|---|
| **Bozza** | Visibile solo a chi lo gestisce; il link non si apre |
| **Aperto** | Il link si apre e il modulo riceve invii; i membri con accesso allo spazio lo vedono nell'elenco |
| **Chiuso** | Il link mostra *"Modulo chiuso. Questo modulo non accetta più invii."* |

- **Pubblica** richiede almeno un campo oltre al consenso. Se il modulo accetta membri, la pubblicazione fatta dal team avvisa via e-mail chi ha accesso allo spazio, una volta, 10 minuti dopo, nella categoria **Moduli** (vedi [E-mail di questa community](/notificacoes/emails-desta-comunidade)). La pubblicazione fatta da un membro non invia e-mail.
- **Chiudi** smette di accettare invii; quelli ricevuti restano nell'elenco. **Riapri** lo apre di nuovo (con la scadenza passata o il limite raggiunto, cambiali prima).
- **Elimina** mette offline il link e il modulo sparisce dall'elenco. Gli invii restano salvati per il proprietario.
- Puoi modificare il modulo in qualsiasi stato. Ogni invio conserva una copia di ciò che è stato inviato, con l'etichetta del campo di quel momento.

## Il link pubblico

**Copia link**, nell'editor, copia l'indirizzo del modulo, sul dominio della community: `clube.memberfy.net/f/…`. Il codice del link è lungo e non si può indovinare.

- **Il membro che ha effettuato l'accesso** compila tramite il link o dall'elenco dello spazio, senza verifica anti-robot.
- **Il visitatore** (con **Chiunque abbia il link** attivo) compila senza account. Prima di inviare, il browser risolve una verifica anti-robot, invisibile nella maggior parte dei casi; c'è anche un limite di invii per indirizzo internet ogni 10 minuti. Superato il limite, la schermata chiede di aspettare.
- In un modulo solo per membri, chi non ha effettuato l'accesso vede *"Accedi per compilarlo. Questo modulo è solo per i membri della community."*
- **Con password**, la schermata chiede la **Password di accesso** prima di mostrare i campi. Sbagliarla più volte blocca nuovi tentativi per qualche minuto, e dopo molte password errate sullo stesso modulo in 1 ora, chi lo apre passa una verifica anti-robot prima di riprovare; il modulo non viene bloccato. Se l'accesso scade mentre la persona compila, digita di nuovo la password e le risposte sono ancora lì.

Gli errori compaiono nel campo stesso: *"Compila questo campo."*, *"Digita un'e-mail valida."*, *"Spunta il consenso per inviare."*, *"Il minimo è …"*.

### Incorporare nel tuo sito

Il pulsante **Incorpora**, accanto a **Copia link**, apre due codici da incollare nell'HTML del tuo sito, dove deve comparire il modulo:

- **Script (consigliato)**: l'altezza si regola da sola, senza barra di scorrimento.
- **iframe**: per i siti che non accettano script; l'altezza è fissa (regola l'`height` se serve).

Entrambi usano il dominio del link pubblico del modulo (il dominio proprio della community, quando ne ha uno). Incorporato, il modulo appare compatto, con i colori della community; i link si aprono in una nuova scheda, e il reindirizzamento dopo l'invio porta la pagina in cui è incorporato. In un modulo solo per membri, l'accesso si apre in una nuova scheda. Il resto funziona come tramite il link: verifica anti-robot, password di accesso, limiti e **Salva come membro**.

La lingua del modulo incorporato segue il `data-lang` dello script (per esempio, `data-lang="it-IT"`; nel link, `?lang=`) e, senza, la lingua della community, mai quella del browser di chi visita. La finestra **Incorpora** compila già il `data-lang` con la lingua della community.

## Consenso e privacy (LGPD)

Quando il modulo accetta visitatori, la community inizia a raccogliere dati di chi non è membro ed è la titolare di questi dati. Per questo:

- il campo **Consenso (privacy)** è obbligatorio e non si rimuove; il testo predefinito è *"Acconsento all'uso di questi dati perché il team mi contatti."*, e puoi riscriverlo;
- accanto compare il link all'**Informativa sulla privacy** che hai indicato (senza di essa, i termini d'uso di Memberfy) e l'avviso *"I tuoi dati vanno al team di …"*;
- ogni invio conserva la prova del consenso: il testo accettato, il link all'informativa e la data e l'ora. L'invio compare con **Consenso: Sì**, *"Accettato il …"*.

Gli invii restano salvati finché qualcuno del team non li elimina; non c'è cancellazione automatica.

## Gli invii

**Invii**, nell'editor (con il contatore **Invii ricevuti** e quanti sono nuovi), apre l'elenco. Ogni riga riporta la data, l'origine (**Membro** o **Visitatore**), il nome, l'e-mail e lo stato.

**Chi vede:** chi ha creato il modulo, il team (proprietario, amministratore, moderatore e finanza) e i responsabili. Gli altri membri non aprono l'elenco, l'invio né il CSV (403).

- **Stato**: **Nuovo** (*"Nessuno ha ancora parlato con questa persona."*), **In contatto** e **Concluso**, in qualsiasi ordine, in **Gestisci invio**.
- **Filtri**: stato, origine, periodo (**Dal** e **Al**) e la ricerca *"Cerca per nome, e-mail o risposta"*.
- **L'invio**: tutte le risposte, la data, il membro (se ha effettuato l'accesso), il risultato di **Salva come membro** e la prova del consenso.
- **Esporta CSV**: gli invii del filtro attuale, una colonna per campo, con stato, origine e date nel fuso orario della community.
- **Eliminare** un invio lo toglie dall'elenco e dal CSV; gli altri non cambiano (e il limite di invii non si riapre).

## Salva come membro

Con **Salva come membro** attivo, ogni invio diventa un contatto dentro la community:

| Chi ha inviato | Cosa succede | Compare nell'invio come |
|---|---|---|
| Qualcuno che non è ancora membro | Riceve l'invito via e-mail per entrare nella community, con il tag del modulo | *Invitato come membro* |
| Qualcuno la cui e-mail è già di un membro | Riceve solo il tag; nient'altro cambia nel profilo | *Era già membro: ha ricevuto il tag* |
| Un membro che ha effettuato l'accesso | Riceve solo il tag | *Era già membro: ha ricevuto il tag* |
| Qualcuno, con la community al limite di membri del piano | L'invio viene salvato, senza invito | *Non è diventato membro (limite del piano)* |
| Qualcuno, con i limiti giornalieri di inviti raggiunti (100 nuovi membri per modulo, 3 per chi invia e il limite di e-mail di invito) | L'invio viene salvato; nessuno viene creato e nessun invito parte | *Non è diventato membro (limite di inviti)* |
| Qualcuno che ha chiesto di non ricevere inviti dalla community | L'invio viene salvato, senza invito | *Ha chiesto di non partecipare* |

- **Il tag** ha il nome del modulo e viene creato da solo al primo invio (vedi [Tag](/membros/tags)).
- **Nessuna password nel modulo.** Il modulo non chiede mai la password di un account: la persona entra dall'e-mail di invito, come qualsiasi invitato (vedi [Invitare membri](/membros/convidar-membros)).
- Con l'opzione disattivata, l'invio resta solo nell'elenco del modulo.

## E-mail

| E-mail (oggetto) | Quando | Chi la riceve | Si può disattivare? |
|---|---|---|---|
| *Nuovo invio in …* | A ogni invio, con i campi principali e **Vedi l'invio** | I responsabili | Sì: la categoria **Moduli** |
| *… nuovi invii in …* | Più di 20 invii dello stesso modulo in un'ora: i successivi arrivano insieme, in un'unica e-mail, un'ora dopo | I responsabili | Sì: **Moduli** |
| *Abbiamo ricevuto il tuo invio: …* | A ogni invio, se **Conferma a chi ha inviato** è attiva; testo fisso | L'e-mail dell'invio | No: è la conferma di ciò che la persona ha fatto |
| Invito a entrare | Con **Salva come membro**, per chi non è membro | L'e-mail dell'invio | No |
| Nuovo modulo | Il team pubblica un modulo aperto ai membri | Chi ha accesso allo spazio | Sì: **Moduli** |

Uno stesso indirizzo riceve al massimo **una** e-mail (conferma o invito) per modulo ogni 24 ore; gli invii successivi vengono salvati senza una nuova e-mail. Tutte le e-mail partono dalla coda, in background.

## Limiti

| Cosa | Limite |
|---|---|
| Passaggi per modulo | 20 |
| Campi per modulo | 100 |
| Opzioni per campo di scelta | Da 2 a 50 |
| Testo breve · Testo lungo | 200 · 5.000 caratteri |
| Responsabili | 20 |
| Password di accesso | Da 6 a 100 caratteri |
| Password errate sullo stesso modulo | Dopo molte in 1 ora, una verifica anti-robot prima di riprovare |
| Nuovi membri con **Salva come membro** | 100 per modulo e 3 per chi invia, al giorno, oltre al limite di e-mail di invito |
| Invii di visitatori per indirizzo internet | 20 ogni 10 minuti |
| E-mail a chi ha inviato | 1 per indirizzo, per modulo, ogni 24 ore |
| E-mail ai responsabili | 20 per modulo ogni ora; il resto in un riepilogo |

## Integrazioni

Ogni invio genera l'evento **`form.submitted`** (*"È stato inviato un modulo"*, famiglia **Moduli**): il modulo, l'invio, l'origine, il membro (se ha effettuato l'accesso), ogni campo con l'etichetta e la risposta e il consenso. L'indirizzo internet di chi ha inviato **non** viene mai inviato. Vedi [Eventi webhook](/api/eventos-de-webhook).

- **[Webhook](/api/webhooks)** e [Zapier, Make e n8n](/integracoes/zapier-make-n8n): iscriviti a `form.submitted` o `form.*`.
- **[HubSpot](/integracoes/hubspot)**: crea il contatto con nome, e-mail, telefono, azienda, ruolo e il consenso.
- **[RD Station](/integracoes/rd-station)**: registra la conversione *"Ha inviato il modulo …"* e, con il consenso, la base giuridica.

Due regole proteggono i contatti che hai già:

- **Un visitatore non modifica mai un contatto esistente.** Chiunque può digitare l'e-mail di un altro in un modulo aperto. Per questo, solo l'invio di un membro che ha effettuato l'accesso con l'e-mail del proprio profilo tocca un contatto che è già nel CRM; quello di un visitatore diventa una nota sul contatto (HubSpot) o solo la conversione (RD Station). I dettagli sono nell'articolo di ciascuna app.
- **Chi ha già collegato HubSpot o RD Station deve spuntare l'evento.** Le installazioni esistenti non ricevono `form.submitted` da sole: apri l'integrazione, spunta **È stato inviato un modulo** e salva. Una nuova installazione lo ha già.

## Con l'assistente

L'assistente costruisce, pubblica e segue i moduli con 17 strumenti, con le stesse regole dell'app (chi crea, opzioni solo del team, chi vede gli invii). Prima di pubblicare, chiama `publish_form` con `dry_run` e mostra quante persone ricevono l'avviso via e-mail e cosa fa ogni invio (con **Salva come membro**, l'invito); pubblica solo dopo il tuo sì. Eliminare un modulo o un invio chiede conferma. Quando compila un modulo, l'assistente spunta il consenso solo dopo che hai letto il testo e hai detto sì.

In Claude, la ricetta **Raccogliere con un modulo** fa l'intero percorso. Vedi [Strumenti · Membri](/mcp/ferramentas-membros#moduli) e [Ricette](/mcp/receitas).

## Nell'API

Le rotte del team sono in `/api/forms` (con l'`X-CommunityId`), e quelle di chi compila tramite il link in `/api/public/forms/{token}`. L'elenco completo, con esempi, è nel [Riferimento API](/api/referencia), generato dall'API stessa.

## Domande frequenti

**Si può mettere il modulo sul mio sito?**
Sì: **Incorpora**, accanto a **Copia link**, dà i codici da incollare nel tuo sito. Vedi [Incorporare nel tuo sito](#incorporare-nel-tuo-sito). Puoi anche mettere l'indirizzo `…/f/…` in un pulsante.

**Si può ricevere un file o far pagare nel modulo?**
No. Per far pagare, usa un [prodotto](/monetizacao/produtos); per ricevere file, uno spazio [Assistenza](/espacos/suporte) o [Call for papers](/espacos/chamada-de-trabalhos).

**Chi vede i dati di un visitatore?**
Chi ha creato il modulo, il team e i responsabili. La persona che ha compilato ne viene avvisata sulla schermata (*"I tuoi dati vanno al team di …"*).

**Ho eliminato il modulo. Ho perso gli invii?**
No: restano salvati per il proprietario, finché non li elimina uno per uno.

## Correlati

- [Questionari](/espacos/pesquisas)
- [Creare e organizzare gli spazi](/espacos/criar-e-organizar-espacos)
- [Tag](/membros/tags)
- [E-mail di questa community](/notificacoes/emails-desta-comunidade)
- [HubSpot](/integracoes/hubspot) · [RD Station](/integracoes/rd-station)