> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.userbot.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server.

# Gruppi

Un gruppo è un elenco di persone a cui dai un nome (Vendite, Supporto, Ufficio
tecnico) e che poi usi ovunque Userbot ti chieda «con chi condividi?» o «chi può
usare questa cosa?».

Senza gruppi ogni condivisione è un elenco di nomi. Funziona il primo giorno.
Smette di funzionare alla prima assunzione, quando scopri che il nuovo assunto
non vede l'agente che tutto il suo reparto usa, e nessuno sa in quanti posti
bisogna aggiungerlo.

## Dove hanno effetto

Questo è il punto: un gruppo non serve a organizzare l'organigramma, serve
perché lo puoi selezionare in molti punti diversi del prodotto.

| Dove                                                               | Cosa ci fai                                                                                                               |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| [Attivare e limitare le funzionalità](/prodotti)                   | Rendi una parte del prodotto disponibile solo a certi gruppi, con l'opzione **Gruppi e persone scelti**                   |
| Condivisione di agenti, skill, workflow, cartelle, file e progetti | Scegli il gruppo invece dei singoli nomi, con il ruolo Visualizzatore o Editor (per un singolo file, solo Visualizzatore) |
| [Regole per l'AI](/regole)                                         | Applichi linee guida e obblighi di approvazione a un intero reparto                                                       |
| [Modelli disponibili](/modelli-admin)                              | Con il pulsante dell'accesso accanto al modello limiti un modello costoso a chi ne ha davvero bisogno                     |
| Customer Service                                                   | Definisci chi presidia l'inbox e chi può rileggere tutte le conversazioni per controllo qualità                           |

Il vantaggio è sempre lo stesso: quando una persona entra nel gruppo, eredita
tutto in una volta. Quando esce, lo perde in una volta.

## Cosa un gruppo non fa

Tre limiti da conoscere prima di disegnare la struttura, perché tutti e tre
smentiscono un'aspettativa comune.

* **I gruppi non si annidano.** Un gruppo contiene persone, non altri gruppi. Se
  vi serve «tutta la Direzione commerciale» oltre a «Vendite Italia» e «Vendite
  Estero», il terzo gruppo va compilato con le stesse persone dei primi due.
* **Non ce ne sono di predefiniti.** Una nuova area di lavoro nasce senza nessun
  gruppo: non esiste un «Tutti» automatico. Per rivolgersi a tutti si usa
  l'opzione **Tutta l'area di lavoro** dove è prevista.
* **Un gruppo non porta permessi.** Serve solo a due cose: ricevere condivisioni
  e comparire negli elenchi di chi può usare una funzionalità. Le capacità delle
  persone restano quelle del loro [ruolo](/ruoli).

## Creare un gruppo

Il modulo compare in linea al posto del pulsante, non in una finestra:

![Animazione: il clic su Crea gruppo fa comparire due campi in linea, si scrivono nome e descrizione e il cursore si ferma su Crea](/_fern-files/userbot-035249.docs.buildwithfern.com/b5e47c0ed67936dff5f71da5a478b385a6a812f59ce76c9cf6ad7037e0c62dce/docs/assets/animazioni/admin-creare-gruppo.gif)

#### Apri Gruppi

**Impostazioni › Persone e permessi › Gruppi**. Trovi l'elenco **Gestisci
gruppi**, con il numero di persone e la descrizione di ciascuno.

![La navigazione delle Impostazioni con Gruppi evidenziato sotto Persone e permessi, e a destra la pagina Gruppi con l'elenco Gestisci gruppi](/_fern-img/8b52b192be1f19f2e349f900f792da7be37770ad4bc96713d389978576f5cf49.webp)

#### Premi Crea gruppo

Il pulsante è in alto a destra, sopra l'elenco.

![La pagina Gruppi con il pulsante Crea gruppo evidenziato e sotto i gruppi esistenti, ciascuno con il numero di persone e la descrizione](/_fern-img/e2e7fd8dd17fb52fa7dd0826d6fb3b0c656038ee7f66149e980762cd8eaa09ca.webp)

#### Scrivi nome e descrizione

Il nome è quello che vedranno tutti nei menu di condivisione: usa il nome
del reparto come lo chiamate in azienda, non una sigla. La descrizione è
facoltativa ma utile fra sei mesi, quando ci saranno dodici gruppi e nessuno
ricorderà la differenza fra «Commerciale» e «Vendite».

![I due campi comparsi al posto del pulsante, con il nome Ufficio gare e la descrizione già scritti, e accanto Crea evidenziato e Annulla](/_fern-img/9219faa302c5a7f5632c32e092ba12d7ff946d3f00ca4f15d673ad97587fe018.webp)

#### Premi Crea

Il gruppo compare nell'elenco, ancora senza persone.

![Il gruppo Ufficio gare in cima all'elenco, evidenziato, con 0 persone e la descrizione](/_fern-img/562c8b53f9f9322ecdd75656eeea57560b680849b50cb9694c1096422b97abf7.webp)

#### Apri il gruppo e premi Aggiungi persona

Un clic sul nome apre la scheda del gruppo.

![La scheda del gruppo Ufficio tecnico: nome e descrizione in alto, le persone del gruppo con la X per toglierle, e Aggiungi persona evidenziato a destra](/_fern-img/d3415f8dc940d73cd4a2d69ff467f79c775920825cd47765f40a56f9233891d3.webp)

#### Scegli le persone

Nell'elenco trovi solo chi è già membro dell'area di lavoro e non è ancora
nel gruppo: chi non è entrato va prima invitato dalla pagina
[Membri](/membri). Ripeti per ogni persona.

![L'elenco aperto sotto Aggiungi persona, con i membri dell'area di lavoro che non fanno ancora parte del gruppo](/_fern-img/43b00e4e0c9c01b1c920b17582f1795c18fec0c530ff9b11d508c1a3cc1ccb4c.webp)

Un gruppo non ha un responsabile da impostare in questa pagina. Chi approva le
richieste dei membri di un gruppo si decide nelle [Regole per l'AI](/regole), con
una regola applicata a quel gruppo.

Dalla scheda del gruppo togli una persona con il pulsante accanto al suo nome, e
elimini l'intero gruppo dall'elenco **Gestisci gruppi**: il browser chiede
conferma con «Eliminare il gruppo "…"?».

> **Warning**
>
> Eliminare un gruppo non elimina le persone, ma revoca in un colpo solo tutti
> gli accessi che passavano da lì: agenti condivisi, cartelle, funzionalità
> ristrette. Prima di eliminarlo, controlla che non sia l'unica via d'accesso a
> qualcosa che serve.

## Gruppi e ruoli non sono la stessa cosa

Confonderli è l'errore più frequente, e produce configurazioni che sembrano
sicure e non lo sono.

* Il **ruolo** dice *cosa* una persona può fare: creare agenti, condividere con
  tutta l'azienda, scaricare i file altrui. È una capacità, e vale ovunque.
* Il **gruppo** dice *a cosa* una persona ha accesso: quell'agente, quella
  cartella, quel modello. È un elenco di destinatari.

Mettere una persona in un gruppo non le dà nessun permesso in più. Se il
Commerciale non riesce a condividere un agente con tutta l'azienda, non è
questione di gruppi: è il permesso **Condividere agenti col workspace**, che si
regola in [Ruoli e permessi](/ruoli).

## Come tenerli utili

Pochi gruppi e stabili valgono più di molti gruppi precisi.

* **Modella i reparti, non i progetti.** I progetti finiscono, i gruppi
  restano, e in due anni ti ritrovi con trenta gruppi morti e nessuno che osa
  cancellarli.
* **Un gruppo per il pilota, all'inizio.** Durante il lancio serve un solo
  gruppo: le persone che stanno provando Userbot. Ci restringi le funzionalità
  che non vuoi ancora aprire a tutti.
* **Aggiungi la persona al gruppo il giorno dell'invito**, non quando si
  lamenta di non vedere qualcosa. È il momento in cui hai in testa il contesto.
* **Non creare un gruppo per una persona sola.** Se la condivisione riguarda un
  individuo, condividi con l'individuo.

## Domande frequenti

#### Chi può creare gruppi?

Chi ha il permesso **Creare gruppi**: di norma Editor e Admin, non i Membri.
Lo cambi in [Ruoli e permessi](/ruoli). Lo stesso permesso fa comparire la
voce **Gruppi** nelle Impostazioni e consente di cambiare le persone di
qualunque gruppo e di eliminarlo, non solo di quelli creati da sé. Chi non
ha il permesso non vede la voce.

#### Una persona può stare in più gruppi?

Sì, e gli accessi si sommano. Se un gruppo dà accesso a una funzionalità e un
altro no, prevale l'accesso: i gruppi concedono, non tolgono.

#### I gruppi si sincronizzano con la nostra directory aziendale?

Non ancora: al momento si compilano a mano. Per aree di lavoro grandi, tieni
i gruppi allineati ai reparti e rivedili quando aggiorni l'elenco dei
[membri](/membri).