# Campi personalizzati

> I dati extra dell'anagrafica dei membri (azienda, ruolo, città, tipo di biglietto) - tipi, obbligatorietà, chi vede e chi modifica, la richiesta di completare l'anagrafica all'accesso e la variabile nelle campagne.

I **campi personalizzati** sono i dati che la community vuole conservare di ogni membro oltre a nome, e-mail e telefono: azienda, ruolo, città, data di nascita, tipo di biglietto. Il team crea i campi una volta; i valori compaiono nella scheda di ogni membro, nel profilo della persona stessa e nelle campagne e-mail.

## A cosa serve

| Community | Campi |
|---|---|
| Associazione | *Azienda*, *Ruolo*, *Numero di associato* |
| Evento | *Tipo di biglietto* (scelta), *Città* |
| Scuola | *Classe*, *Data di iscrizione* |
| Coworking | *Piano*, *Ha un posto auto* (sì/no) |

## Come funziona

### I tipi

| Tipo | A cosa serve | Esempio |
|---|---|---|
| **Testo** | Qualsiasi testo breve | Azienda |
| **Numero** | Un numero | Numero di associato |
| **Data** | Una data | Data di nascita |
| **Scelta** | Un'opzione da un elenco (almeno due) | Tipo di biglietto: VIP, In presenza, Online |
| **Sì/no** | Una risposta sì o no | Ha un posto auto |

Il tipo **non cambia** quando un membro ha già un valore compilato: *"Il tipo non cambia quando ci sono valori compilati."*

### Obbligatorio

Un campo **Obbligatorio** deve essere compilato da tutti. Chi non ha il valore (membro di lunga data, importato o nuovo) vede, al **prossimo accesso** alla community, la finestra **Completa la tua registrazione** (*"{nome della community} chiede queste informazioni per proseguire."*) e prosegue solo dopo aver compilato e fatto clic su **Salva e continua**. Chi preferisce può fare **Esci**.

L'[importazione da foglio di calcolo](/membros/importar-membros) non blocca mai una riga per un campo obbligatorio vuoto; la persona lo completa al primo accesso.

### Chi vede e chi modifica

| Chi | Vede | Modifica i valori |
|---|:-:|:-:|
| Proprietario, amministratore e moderatore | Di tutti | Di tutti |
| Finanza | Di tutti | Solo i propri |
| Il membro stesso | I propri | I propri |
| Un altro membro | — | — |

Creare, modificare, riordinare ed eliminare **campi** spetta a proprietario e amministratore. Moderatore e finanza vedono la scheda solo in consultazione: *"Puoi vedere i campi, ma solo owner e admin li creano, modificano o eliminano."*

I campi non compaiono nel profilo pubblico: un altro membro non vede l'azienda né il ruolo di nessuno.

> [!TIP]
> È la schermata stessa a ricordarlo: *"Non chiedere dati sensibili (salute, religione, documenti) se non serve."*

### Dove compaiono i valori

- **Scheda del membro** (team): in **Amministrazione › Membri**, modificando la persona, la sezione **Informazioni aggiuntive**, con **Salva informazioni**. Per chi è entrato tramite importazione, lì compare anche *"Origine: importazione da foglio il …"*.
- **Il Mio Account** (il membro stesso): la scheda **Informazioni aggiuntive**, *"Campi che la community chiede in fase di registrazione."*
- **Campagne e-mail:** ogni campo diventa una variabile (sotto).

### Nelle campagne

Ogni campo diventa la variabile `{{campo_<chiave>}}`, dove la chiave è il nome del campo senza accenti, in minuscolo e con `_` al posto degli spazi: il campo *Azienda* diventa `{{campo_azienda}}`, *Tipo di biglietto* diventa `{{campo_tipo_di_biglietto}}`. Vale anche `{{field_<chiave>}}`. La chiave nasce con il campo e non cambia, anche se il nome cambia dopo.

Nell'editor, **Inserisci variabile** mostra i campi nel gruppo **Campi della community**, con il nome corretto. Il valore esce formattato per chi riceve: data nella lingua della persona, sì/no tradotto, scelta con l'opzione. Per chi non ha il valore, usa il testo di riserva: `{{campo_azienda|la tua azienda}}`. Vedi [Variabili per destinatario](/notificacoes/campanhas-de-email#variabili-per-destinatario).

### Eliminare un campo

Il campo sparisce dalla scheda, dalla scheda del membro, dal profilo e dalle variabili delle campagne. I valori già compilati **restano salvati**. Una campagna che usa ancora la variabile di un campo eliminato viene rifiutata al salvataggio o all'invio.

## Passo dopo passo

*Ruolo: proprietario o amministratore.*

1. **Amministrazione › Membri**, scheda **Campi personalizzati**, pulsante **Nuovo campo**.
2. **Nome del campo** (es.: *Azienda*) e **Tipo**. In una **Scelta**, scrivi le **Opzioni** (**Aggiungi opzione** per un'altra).
3. Spunta **Obbligatorio** se tutti devono compilarlo.
4. **Salva**. Usa **Sposta su** e **Sposta giù** per cambiare l'ordine in cui i campi compaiono nella scheda e nel profilo.

Per compilare il valore di qualcuno: **Amministrazione › Membri**, modifica la persona e usa **Informazioni aggiuntive**.

## Esempi

**Associazione che chiede l'azienda.** L'amministratore crea *Azienda* (Testo, obbligatorio). Al prossimo accesso, ogni associato vede **Completa la tua registrazione** e compila. La campagna del congresso si apre con *"{{nome}}, {{campo_azienda|la tua azienda}} ha già il posto?"*.

**Evento che importa il tipo di biglietto.** Nell'[importazione](/membros/importar-membros), la colonna *Tipo di biglietto* va in **+ Nuovo campo personalizzato**; Memberfy suggerisce **Scelta**, perché i valori si ripetono. Dopo, il team vede nella scheda di ogni persona se è VIP, In presenza oppure Online.

## Errori comuni e come risolverli

| Messaggio | Cosa fare |
|---|---|
| *Dai un nome al campo.* | Compila il **Nome del campo** |
| *Una scelta richiede almeno due opzioni.* | Aggiungi un'altra opzione |
| *Compila {campo}.* | Il campo è obbligatorio e non può restare vuoto |
| *Sola lettura: owner, admin e moderatore modificano questi valori.* | La finanza vede solo i valori degli altri |
| Il tipo non si può cambiare | Ci sono già valori compilati; crea un nuovo campo |

## Domande frequenti

**Il membro vede i campi degli altri?**
No. Ogni membro vede solo i propri; il team vede quelli di tutti.

**Posso filtrare il pubblico di una campagna per un campo?**
Non ancora. Per ora, usa i [Tag](/membros/tags) o i [Gruppi](/membros/grupos-e-organograma) per separare le persone.

## Con l'assistente

`list_member_fields`, `create_member_field`, `update_member_field`, `reorder_member_fields`, `delete_member_field` (chiede conferma) e `update_member_field_values`. Vedi [Strumenti · Membri](/mcp/ferramentas-membros#campi-personalizzati).

## Nell'API

`GET` e `POST /api/member-fields`, `PATCH` e `DELETE /api/member-fields/{id}`, `PUT /api/member-fields/order` e `PUT /api/profiles/{profileId}/fields`. I valori arrivano in `fields` di `GET /api/profiles/{id}`, solo per il team e per il membro stesso. Vedi [Member Fields](/api/referencia/member-fields) nel Riferimento API.

## Correlati

- [Importare membri da un foglio di calcolo](/membros/importar-membros)
- [Gestire i membri](/membros/gerenciar-membros)
- [Campagne e-mail](/notificacoes/campanhas-de-email)