> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Accessi e ruoli nei workspace Conduit degli studenti

> Su ogni workspace Conduit che paga Mattone gli Admin sono solo i due account di Mattone. Studenti e collaboratori lavorano con il ruolo personalizzato «Partner Mattone», che fa tutto il lavoro quotidiano ma non gestisce i membri e non cancella il workspace.

I workspace Conduit degli studenti fanno parte dell'ordine partner di Mattone: **li paghiamo noi**. Per questo chi può togliere l'accesso a qualcuno o cancellare un workspace deve essere solo Mattone.

## La regola

> [!WARNING]
>
> Su ogni workspace del nostro ordine gli **unici Admin sono i due account di Mattone**: l'**account Mattone** (`francesco@mattone.co`) e l'**account del token partner**. Nessun account dello studente o del suo team è Admin, e nessun altro ruolo ha **Manage Members** o **Delete Workspace**.

* Lo studente e i suoi collaboratori usano il ruolo personalizzato **Partner Mattone**: con quel ruolo fanno tutto il lavoro di ogni giorno (inbox, KB, agenti, workflow, prenotazioni, task, canali).
* Lo studente **non crea utenti da solo**. Se gli serve un utente nuovo, lo chiede a noi con un ticket ([vedi sotto](#come-lo-studente-chiede-un-utente-nuovo)).
* Un workspace si cancella **solo su decisione di Francesco** ([vedi sotto](#cancellazioni)).

> [!NOTE]
>
> **Perché due account.** Il token partner con cui il team legge e misura tutti i workspace è legato a un account che non è `@mattone.co`, e Conduit gli mostra **solo i workspace dove quell'account è Admin**. Se lo togliamo da Admin perdiamo l'accesso partner a quel workspace. Resta Admin finché Conduit non sposta l'accesso partner su un account Mattone; a quel punto l'Admin sarà uno solo. L'indirizzo dell'account del token partner non è scritto qui: chiedilo a Mattia.

## Perché

Conduit lo ha confermato per iscritto: **non esiste un blocco dei ruoli**. Chiunque abbia Manage Members può declassare un Admin, compresi i nostri. **L'unica protezione è che gli unici Admin siano nostri.**

Ci è già successo due volte:

* su un workspace l'Admin dello studente ha declassato il nostro account a un ruolo di sola lettura. Da quel momento il workspace è sparito dal nostro token partner: non lo vediamo più, non lo misuriamo e non lo possiamo sistemare, ma continuiamo a pagarlo.
* un altro workspace è stato cancellato, e dal nostro stesso account. Una cancellazione non si annulla dall'interfaccia, e con il workspace se ne vanno KB, agenti, workflow e storico conversazioni.

> [!NOTE]
>
> Il ruolo predefinito **Member** di Conduit non basta come protezione. Di solito non ha Manage Members, ma un Admin può modificarlo: abbiamo trovato un workspace in cui il Member aveva anche **Delete Workspace** e **Manage Workspace**. Per questo agli studenti si dà il ruolo personalizzato **Partner Mattone**, che controlliamo noi, e non il Member.

## Il ruolo personalizzato «Partner Mattone»

Si crea una volta per ogni workspace (i ruoli in Conduit valgono per un solo workspace). I nomi dei permessi sono quelli che mostra il pannello Conduit.

| Permesso | Partner Mattone |
| - | :-: |
| **Manage Members** | ❌ no |
| **Delete Workspace** | ❌ no |
| **Manage Workspace** (impostazioni generali del workspace) | ❌ no |
| **Manage Billing** | ❌ no (la fatturazione è nostra) |
| Access / Manage Inbox, Inboxes | ✅ sì |
| Access / Manage Contacts | ✅ sì |
| Access / Manage Properties | ✅ sì |
| Access / Manage Tasks | ✅ sì |
| Access / Manage Devices | ✅ sì |
| Access Calls | ✅ sì |
| Access / Manage Appointments | ✅ sì |
| Access Reservations | ✅ sì |
| Access Payments (c'è solo nei workspace più vecchi) | ✅ sì |
| Access / Manage Portals, Manage Portal Settings, Manage Submissions | ✅ sì |
| View Portal Transactions, Manage Portal Payments | ✅ sì |
| Access / Manage Knowledge Base | ✅ sì |
| Access / Manage Agents | ✅ sì |
| Access / Manage Workflows | ✅ sì |
| Access Insights | ✅ sì |
| Access / Manage Escalations | ✅ sì |
| Manage Assignment Schedule, Manage Routing, Manage Calendars | ✅ sì |
| View / Manage Connections | ✅ sì |
| Manage Channels, Manage Variables | ✅ sì |

In breve: **tutto tranne i quattro permessi in cima**. Se un workspace mostra un permesso che qui non c'è (Conduit ne aggiunge ogni tanto), il criterio è questo: se serve a lavorare sugli ospiti e sugli appartamenti è sì, se tocca membri, fatturazione o l'esistenza del workspace è no. Nel dubbio, chiedi prima di darlo.

## Come sistemare un workspace esistente

Si fa dal pannello Conduit, entrando con uno dei due account Admin di Mattone. L'API permette di leggere ruoli e membri e di creare un ruolo, ma **non permette di cambiare il ruolo di un membro né di rimuoverlo**: quei passi si fanno solo dall'interfaccia.

**1. 1 · Controlla di essere Admin**

Apri il workspace e vai nelle impostazioni dei membri. Devono essere Admin **entrambi** i nostri account. Se manca l'account Mattone, invitalo come Admin (l'invito si può fare anche via API). Se nessuno dei due è Admin, **fermati**: non puoi sistemare niente, va chiesto allo studente di rimetterci Admin (lo chiede Mattia).

**2. 2 · Crea il ruolo Partner Mattone**

Nelle impostazioni dei ruoli crea un ruolo personalizzato chiamato **Partner Mattone** con i permessi della tabella sopra. Rileggilo dopo averlo salvato e controlla che Manage Members, Delete Workspace, Manage Workspace e Manage Billing siano spenti.

**3. 3 · Sposta tutti gli altri su Partner Mattone**

Per ogni membro che non è uno dei due account Mattone (Admin o Member che sia) cambia il ruolo in **Partner Mattone**. Comincia dagli Admin: finché hanno Manage Members possono declassare noi.

**4. 4 · Controlla il ruolo Member predefinito**

Apri il ruolo **Member**: se ha Manage Members, Delete Workspace o Manage Workspace, toglili. Se possibile imposta **Partner Mattone** come ruolo predefinito per i nuovi inviti.

**5. 5 · Verifica finale**

Nell'elenco membri gli Admin devono essere **solo i due account Mattone**. Nessun altro ruolo deve avere Manage Members o Delete Workspace. Scrivi nel ticket del workspace cosa hai cambiato e quando.

> [!TIP]
>
> Avvisa lo studente prima di cambiare i ruoli: per lui non cambia niente nel lavoro di ogni giorno, ma non vedrà più la gestione dei membri. Spiegagli che gli utenti nuovi li crea il team su richiesta.

## Workspace nuovo

Quando si crea un workspace per uno studente (vedi [Onboarding nuovo studente](https://docs.mattone.co/integrazioni/conduit/onboarding-nuovo-studente.md)):

1. I due account Mattone (account Mattone e account del token partner) sono **Admin** dal primo minuto e sono **gli unici Admin**.
2. Prima di invitare chiunque si crea il ruolo **Partner Mattone**.
3. Lo studente e i collaboratori che indica vengono invitati **direttamente con il ruolo Partner Mattone**, mai come Admin e mai come Member.
4. Nessun altro account diventa Admin: se a qualcuno del team serve lavorarci, usa anche lui Partner Mattone.

## Come lo studente chiede un utente nuovo

1. Lo studente apre un **ticket** dalla piattaforma con nome, email e cosa farà la persona nel workspace.
2. Il ticket va a **Mattia**, che invita la persona con il ruolo **Partner Mattone** entrando con un account Admin di Mattone.
3. Mattia chiude il ticket solo quando la persona ha accettato l'invito e vede il workspace.

Lo stesso vale per togliere l'accesso a qualcuno (per esempio un collaboratore che se ne va): ticket, e lo fa Mattia.

## Cancellazioni

> [!WARNING]
>
> Un workspace del nostro ordine si cancella **solo su decisione di Francesco**, scritta. Nessuno lo cancella per pulizia, per errore di provisioning o perché lo studente lo chiede. Se uno studente vuole chiudere, si apre un ticket e si passa dalla procedura di [right-sizing](https://docs.mattone.co/integrazioni/conduit/right-sizing.md) o di chiusura del contratto, non dal pulsante di cancellazione.

Prima di cancellare, anche con la decisione presa, si fa il backup completo del workspace come descritto nel [right-sizing](https://docs.mattone.co/integrazioni/conduit/right-sizing.md).

## Pagine collegate

> **[Onboarding nuovo studente](https://docs.mattone.co/integrazioni/conduit/onboarding-nuovo-studente.md)**
>
> Creazione del workspace e primo accesso

> **[Right-sizing](https://docs.mattone.co/integrazioni/conduit/right-sizing.md)**
>
> Ridurre l'operatività senza cancellare niente

> **[Billing e fatturazione](https://docs.mattone.co/integrazioni/conduit/billing-e-fatturazione.md)**
>
> Perché i workspace li paghiamo noi

> **[Troubleshooting](https://docs.mattone.co/integrazioni/conduit/troubleshooting.md)**
>
> Quando qualcosa non funziona


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.