Invito del team
Invita i colleghi nel tenant, assegna i ruoli corretti e gestisci inviti, revoche e disattivazioni.
Secondo passaggio della guida rapida. Prima di configurare l'agente, definisci chi può fare cosa: assegnare i ruoli dopo il go-live è più rischioso che farlo prima.
Prima di iniziare
- Accesso alla Console con ruolo Amministratore
- Elenco degli indirizzi e-mail aziendali dei colleghi da invitare
- Decisione condivisa su chi deve gestire configurazione, conversazioni e fatturazione
Invita un utente
Apri la sezione utenti
Nel menu laterale seleziona Tenant, quindi Utenti. La tabella mostra utenti attivi, inviti in sospeso e account disattivati, con filtro per stato e per ruolo.
Compila i dati dell'invito
Seleziona Invita utente e compila il modulo.
| Campo | Obbligatorio | Note |
|---|---|---|
| Indirizzo e-mail | Sì | Usa il dominio aziendale, per esempio mario.rossi@acme.it |
| Nome | Sì | Mostrato agli altri operatori e nelle conversazioni interne |
| Cognome | Sì | — |
| Ruolo | Sì | Vedi la matrice dei permessi più sotto |
| Workspace | No | Se il tenant usa i workspace, limita la visibilità dei dati |
| Messaggio di benvenuto | No | Testo libero incluso nell'e-mail di invito |
Invia l'invito
Conferma con Invia invito. L'utente riceve un'e-mail con un collegamento valido 7 giorni e compare in tabella con stato Invitato.
Verifica l'attivazione
Quando l'utente completa la registrazione, lo stato passa a Attivo. Se il tenant richiede l'MFA obbligatoria, l'attivazione non è completa finché il secondo fattore non è configurato.
Inviti multipli
Puoi invitare più persone nella stessa operazione incollando gli indirizzi separati da virgola. Il ruolo scelto viene applicato a tutti gli indirizzi dell'elenco: per ruoli diversi, esegui inviti separati.
I ruoli disponibili
| Ruolo | A chi assegnarlo | Ambito |
|---|---|---|
| Amministratore | Responsabile della piattaforma, referente IT | Controllo completo del tenant, inclusi utenti, sicurezza e fatturazione |
| Manager | Responsabile di reparto o di progetto | Configurazione di progetti, agenti, contenuti e statistiche |
| Operatore | Front office, segreteria, assistenza | Gestione quotidiana delle conversazioni e dei clienti |
| Sola lettura | Direzione, audit, consulenti esterni | Consultazione di dati e report, nessuna modifica |
Matrice dei permessi
| Area | Amministratore | Manager | Operatore | Sola lettura |
|---|---|---|---|---|
| Dashboard | Sì | Sì | Sì | Sì |
| Conversazioni: lettura | Sì | Sì | Sì | Sì |
| Conversazioni: risposta e handover | Sì | Sì | Sì | No |
| Conversazioni: chiusura ed esportazione | Sì | Sì | Sì | No |
| Clienti: lettura | Sì | Sì | Sì | Sì |
| Clienti: modifica | Sì | Sì | Sì | No |
| Classificazione documentale | Sì | Sì | Sì | No |
| Statistiche e report | Sì | Sì | Sì | Sì |
| Knowledge base: lettura | Sì | Sì | Sì | Sì |
| Knowledge base: caricamento e reindicizzazione | Sì | Sì | No | No |
| Modelli AI e prompt | Sì | Sì | No | No |
| Progetti, avatar e widget builder | Sì | Sì | No | No |
| Flussi conversazionali e strumenti | Sì | Sì | No | No |
| Webhook e integrazioni | Sì | No | No | No |
| Chiavi API | Sì | No | No | No |
| Utenti e ruoli | Sì | No | No | No |
| Sicurezza del tenant, MFA e SSO | Sì | No | No | No |
| Fatturazione e piano | Sì | No | No | Sì |
| Log di audit | Sì | No | No | Sì |
I permessi effettivi sono espressi nel formato {servizio}:{risorsa}:{azione}. Il dettaglio completo, con i ruoli personalizzati, è in Amministrazione.
console:sessions:read
console:sessions:write
console:customers:read
console:customers:write
console:analytics:readPrincipio del privilegio minimo
Assegna il ruolo più basso sufficiente a svolgere il lavoro. Non usare Amministratore come ruolo predefinito: mantieni almeno due amministratori, ma non più di quanti servano davvero. Un secondo amministratore è comunque necessario per non restare bloccati se il primo perde l'accesso.
Gestire gli inviti
| Azione | Quando usarla | Effetto |
|---|---|---|
| Reinvia invito | L'utente non ha ricevuto l'e-mail o il collegamento è scaduto | Genera un nuovo collegamento valido 7 giorni e invalida il precedente |
| Copia collegamento | Le e-mail di sistema sono bloccate dal filtro aziendale | Copia il collegamento da trasmettere su un canale sicuro |
| Modifica ruolo | Il ruolo scelto era errato | Aggiorna il ruolo prima dell'accettazione, senza reinviare |
| Revoca invito | La persona non deve più entrare | Invalida immediatamente il collegamento; l'invito sparisce dall'elenco |
Non condividere i collegamenti su canali pubblici
Il collegamento di invito consente di creare un accesso al tenant. Trasmettilo solo tramite canali aziendali controllati, mai in chat pubbliche o gruppi condivisi.
Modificare, disattivare ed eliminare un utente
Cambiare il ruolo di un utente attivo
Apri la riga dell'utente, seleziona Modifica ruolo e conferma. Il nuovo ruolo è applicato alla sessione successiva: se serve effetto immediato, forza la disconnessione con Termina sessioni attive.
Disattivare un account
Usa Disattiva quando una persona lascia il ruolo o l'azienda. L'account non può più accedere, ma restano intatti lo storico delle conversazioni gestite, le attribuzioni e il log di audit. È l'operazione corretta nella quasi totalità dei casi.
Riattivare un account
Un account disattivato può essere riattivato dallo stesso elenco. L'utente riceve un'e-mail e mantiene le credenziali e la configurazione MFA precedenti.
Eliminare definitivamente
L'eliminazione definitiva è irreversibile e va usata solo su richiesta formale dell'interessato ai sensi del GDPR. I contenuti delle conversazioni restano nel tenant in forma anonimizzata. Vedi Conformità.
Gestione via API
Il provisioning degli utenti può essere automatizzato dai sistemi HR aziendali.
/identity/v1/invitationsAPI KeyCrea un invito per un nuovo utente del tenant e invia l'e-mail di attivazione.
Corpo della richiesta
| Parametro | Tipo | Obblig. | Default | Descrizione |
|---|---|---|---|---|
email | string | Sì | — | Indirizzo e-mail aziendale del destinatario dell'invito. |
firstName | string | Sì | — | Nome della persona. |
lastName | string | Sì | — | Cognome della persona. |
role | string | Sì | — | Codice del ruolo: admin, manager, operator oppure viewer. |
workspaceId | string | No | — | Workspace a cui limitare la visibilità dei dati. |
locale | string | No | it | Lingua dell'e-mail di invito e dell'interfaccia iniziale. |
curl -X POST https://api.blupantheon.com/identity/v1/invitations \
-H "Authorization: Bearer bp_live_xxxxxxxxxxxxxxxx" \
-H "X-Tenant-Slug: acme-srl" \
-H "Content-Type: application/json" \
-d '{
"email": "mario.rossi@acme.it",
"firstName": "Mario",
"lastName": "Rossi",
"role": "operator",
"locale": "it"
}'Endpoint inviti
https://api.blupantheon.com/identity/v1/invitationsRichiede una chiave API con permesso identity:users:invite.
Risoluzione dei problemi
Controlla spam e quarantena aziendale, verifica che l'indirizzo sia corretto e chiedi al reparto IT di autorizzare no-reply@blupantheon.com. In alternativa usa Copia collegamento e trasmettilo su un canale aziendale sicuro.
Nella maggior parte dei casi il ruolo è Sola lettura oppure l'utente è limitato a un workspace che non contiene il progetto. Verifica ruolo e workspace nella scheda utente.
L'invito revocato non è recuperabile. Crea un nuovo invito per lo stesso indirizzo: non ci sono conseguenze sul destinatario, se non un secondo messaggio.
Passaggio 2 completato
Il team ha accesso e ruoli coerenti. Continua con la configurazione del modello AI.