Il tuo team
Un solo numero WhatsApp, più persone che rispondono. Questa pagina è dove stabilisci chi sono quelle persone e quanto ciascuna di loro può fare. Spiega come invitare qualcuno, che cosa succede tra l’invito e la sua comparsa effettiva, la differenza tra i tre ruoli e come togliere di nuovo l’accesso. È breve, perché la pagina è breve — ma due cose qui sono facili da fraintendere, ed entrambe sono segnalate più sotto.

Chi fa parte del tuo team
L’intera pagina
La pagina si apre su un modulo per invitare qualcuno e, sotto, tutti quelli che hanno già accesso. Più in basso ci sono le regole valide per tutto l’account: come vengono distribuite le nuove conversazioni, un riepilogo di ciò che ciascun ruolo può fare e una cronologia di ogni cambiamento di accesso. Ogni membro ha anche un proprio pannello Access, dove il proprietario decide a che cosa può accedere quella persona — il ruolo è un punto di partenza, non tutta la storia.

Invitare qualcuno
Un indirizzo e un ruolo: l’invito è tutto qui. La persona riceve un link; aprirlo e accedere con quello stesso indirizzo è ciò che trasforma l’invito in appartenenza al team. Se non ha mai usato questa applicazione, il link le permette anche di creare l’account nello stesso passaggio.

L’elenco del team
Tutti quelli a cui è stato dato accesso, nell’ordine in cui sono stati invitati. Il pallino colorato su ogni avatar è la lettura più rapida: il verde significa che hanno accettato e stanno lavorando, l’ambra che l’invito è ancora in sospeso. Il badge accanto al ruolo dice la stessa cosa a parole.
Nota: Tu non sei in questo elenco. Il proprietario dell’account non ha una scheda di appartenenza, quindi qui non c’è nulla da mostrare — vedi il riferimento più sotto, e bugs/R01.

Leggere una riga
Qualcuno che si è unito
Un membro che ha accettato mostra il suo nome reale, il suo indirizzo, un pallino di stato verde e un badge «active». A destra ci sono il ruolo che ricopre e il pulsante che gli toglie l’accesso. Questo è un admin.

A che cosa può accedere questa persona
Sotto ogni membro, il proprietario vede un pannello Access. Shared inbox attiva o disattiva il suo accesso alle conversazioni dei clienti (disattivarlo annulla anche l’assegnazione delle sue conversazioni aperte). «Conversations they can see» restringe la casella alle sole conversazioni assegnate a quella persona. «Reassign only their own chats» le impedisce di smistare il lavoro degli altri. I quattro interruttori delle funzioni — modelli, campagne, contatti e API — si concedono uno per uno; promuovere qualcuno ad admin non li concede più da solo.
Nota: Solo il proprietario dell’account vede questi interruttori. Un admin che guarda questa pagina vede l’elenco senza di essi.

Qualcuno che non lo ha fatto
Un invito in sospeso si distingue in tre modi: non c’è alcun nome, perché nessuno ha ancora accettato; il pallino è ambra e pulsa; e il badge riporta «invited». Finché non diventa attivo non c’è alcun account dietro, quindi a questa persona non può essere assegnata una conversazione — non comparirà nell’elenco degli assegnatari dentro una chat.
Nota: La riga viene creata a prescindere dalla consegna dell’email. Un invito fermo qui da giorni di solito significa che il messaggio si è perso, non che la persona ti stia ignorando — per rimandarlo, revoca e invita di nuovo.

Cambiare il ruolo
Il menu a discesa dei ruoli offre esattamente due ruoli, perché owner non è qualcosa che si possa cedere da qui. Un admin può gestire le impostazioni condivise — etichette, orari di lavoro, policy SLA — e, dato che può vedere ogni conversazione, invitare e gestire altri membri. Il cambiamento ha effetto già dalla sua richiesta successiva, non dal prossimo accesso.

Togliere l’accesso
Revoke chiude l’accesso all’istante. Ciò che non fa è cancellare qualcosa: le risposte che hanno inviato restano nelle conversazioni, le note che hanno scritto restano al loro posto, e ciò che era assegnato a loro resta assegnato. Se ne va solo l’accesso.

Regole per tutto il team
Distribuire le nuove conversazioni
L’assegnazione automatica decide chi riceve una conversazione che arriva senza nessuno sopra. Lasciarla non assegnata è l’impostazione predefinita; round robin distribuisce le nuove conversazioni ai membri attivi a turno; claim by replying dà la conversazione al collega che risponde per primo.

Che cosa può fare ciascun ruolo
Un riepilogo di ciò che possono fare il proprietario, un admin e un agent, riga per riga. Descrive le impostazioni predefinite; il pannello Access di ogni membro è il punto in cui il proprietario le cambia per una singola persona.

Chi ha cambiato che cosa
Access history registra ogni cambiamento fatto in questa pagina — inviti, cambi di ruolo, interruttori commutati, revoche — con chi lo ha fatto e quando, così una domanda come «chi ha disattivato la casella di Priya?» ha una risposta.

Team activity
Il collegamento Team activity in cima alla pagina apre un report per il proprietario: quante campagne e pianificazioni ha creato ogni membro, e quante conversazioni gli sono state assegnate e ha risolto, con i risultati SLA, per le date che scegli.

Riferimento
Che cosa tocca questa pagina sotto il cofano, per chi ha bisogno di sapere esattamente che cosa cambia un controllo.
Ogni indirizzo che usa questa pagina
Un indirizzo disegna la pagina; gli altri vengono chiamati dai suoi controlli. Il link di adesione è l’unico tra questi che una persona non ancora nel tuo team può raggiungere.
| Metodo | Percorso | Che cosa fa |
|---|---|---|
GET | /coext/team | La pagina. Qualsiasi membro può vederla. |
GET | /coext/team/list | Rilegge l’elenco dopo una modifica. |
POST | /coext/team/invite | Crea la riga dell’invito e invia il link per email. Owner o admin. |
PUT | /coext/team/:uuid/role | Admin ⇄ agent. Owner o admin. |
DELETE | /coext/team/:uuid | Revoca l’accesso. Owner o admin. |
GET | /coext/team/join/:uuid | La pagina pubblica di adesione. Volutamente NON dietro un accesso. |
POST | /coext/team/join/:uuid | Registra un collega nuovo di zecca e lo unisce in un solo passaggio. |
Nota: L’indirizzo di adesione è pubblico di proposito: chi non ha mai usato questa applicazione non ha un account con cui accedere. Resta comunque sicuro — il link è un identificatore non indovinabile, scade, e accettarlo richiede di dimostrare il controllo dell’indirizzo email invitato.
Che cosa può fare davvero ciascun ruolo
Tre ruoli, e la linea che conta ogni giorno è quella tra gli ultimi due: un agent gestisce le conversazioni, un admin cambia anche le impostazioni da cui tutte le conversazioni sono governate.
| Azione | Owner | Admin | Agent |
|---|---|---|---|
| Leggere e rispondere a qualsiasi conversazione | Sì | Sì | Sì |
| Impostare lo stato, assegnare, etichettare, scrivere note | Sì | Sì | Sì |
| Vedere l’elenco del team | Sì | Sì | Sì |
| Invitare, cambiare ruoli, revocare | Sì | Sì | No |
| Vedere l’elenco delle etichette | Sì | Sì | Sì — in sola lettura |
| Creare, rinominare o eliminare un’etichetta | Sì | Sì | No |
| Orari di lavoro e policy SLA | Sì | Sì | No — le pagine vengono rifiutate |
| Il report SLA | Sì | Sì | No — la pagina viene rifiutata |
| Impostazioni del bot, fatturazione, il numero stesso | Sì | No | No |
I ruoli vengono verificati sul server per ogni azione, non usati soltanto per nascondere dei pulsanti. Un agent che ricostruisca la richiesta a mano viene rifiutato nello stesso punto in cui ci sarebbe stato il pulsante.
Perché il proprietario non è nell’elenco
L’elenco mostra i membri invitati e quelli attivi. Non mostra te, il proprietario dell’account, e in questa pagina non c’è alcuna riga che ti rappresenti — un proprietario non è memorizzato come membro. Il codice tratta «nessuna appartenenza» e «proprietario» come la stessa risposta, il che è ordinato all’interno e sorprendente sullo schermo.
Le conseguenze pratiche sono piccole ma vale la pena conoscerle. Non puoi cambiare il tuo ruolo né revocare te stesso da qui, ed è corretto così. Puoi comunque ricevere conversazioni assegnate, e compari nel menu degli assegnatari dentro una conversazione anche se sei assente da questa pagina — quindi i due elenchi legittimamente non coincidono.
Nota: Questo caso è registrato come bugs/R01. Il sottotitolo della pagina dice «People with access to this account’s shared inbox», e l’unica persona che ha di certo quell’accesso manca dall’elenco.
L’invito, con precisione
Invitare qualcuno scrive prima la riga e poi invia l’email. Se la posta fallisce la riga esiste comunque, ed è per questo che un invito mai arrivato compare nell’elenco in ambra invece di sparire — e per questo reinvitare lo stesso indirizzo viene rifiutato come duplicato.
| Situazione | Che cosa succede |
|---|---|
| L’indirizzo appartiene già a un utente | L’invito viene collegato subito a quell’account; accetta accedendo. |
| L’indirizzo è nuovo per questa applicazione | La pagina di adesione gli fa impostare nome e password, e lo unisce in un solo passaggio. |
| È già invitato o già membro | Rifiutato come duplicato. Revoca prima, se vuoi ricominciare. |
| Inviti il tuo stesso indirizzo | Rifiutato. Sei già il proprietario. |
| L’invito è vecchio | Rifiutato perché scaduto. Inviane uno nuovo. |
| Accede con un indirizzo diverso | Rifiutato — l’indirizzo invitato deve corrispondere. |
Nota: A un membro invitato non può essere assegnata una conversazione finché non ha accettato, perché fino ad allora non c’è alcun account a cui assegnarla. La riga esiste; la persona dietro di essa non ancora.
Revocare
Revocare chiude l’accesso all’istante e fa uscire la persona dall’elenco del team. Non cancella nulla di ciò che ha fatto: le sue risposte restano nelle conversazioni, le sue note interne restano al loro posto, e le conversazioni assegnate a lei restano assegnate a lei.
Un’appartenenza revocata viene conservata invece di essere eliminata, così resta traccia di chi ha avuto accesso e quando. Invitare di nuovo lo stesso indirizzo crea una nuova appartenenza invece di far rivivere quella vecchia.
Nota: Su Revoke non c’è alcun passaggio di conferma. Ha effetto alla pressione, e l’unico modo per tornare indietro è un nuovo invito che la persona deve accettare di nuovo.