Comunicazione
Connettere Gmail a un agente IA autonomo
Gmail concentra gli scambi con i clienti e quelli interni. Il connettore Gmail arriverà presto: un agente Atako potrà smistare i messaggi, preparare bozze e pulire una casella, senza mai vedere la vostra password Google.
Romain Laodicina · CTO di AtakoProssimamente — crea il tuo account e ti avviseremo non appena questa integrazione sarà pronta.
Workflow possibili
Smistamento e bozze di risposta per la casella support condivisa
Una casella support@ riceve decine di messaggi al giorno. L'agente elencherà i messaggi non letti con list_messages, li smisterà per etichetta con add_label_to_message (fatturazione, bug, domanda generica), poi redigerà una bozza di risposta con create_draft per ogni richiesta chiara. Un umano la rileggerà e la invierà con send_draft. L'agente userà send_email solo se gli è stato concesso quel permesso preciso.
Pulizia periodica della casella
Newsletter, notifiche automatiche, conferme di lettura: l'agente cercherà questi messaggi con search_messages (es. from:noreply), ne controllerà l'etichetta con list_labels, poi li sposterà nel cestino con trash_message invece di lasciarli accumulare nella casella principale. La casella resterà leggibile senza che nessuno passi dieci minuti ogni mattina a questo smistamento manuale.
Monitoraggio dei thread cliente da sollecitare
L'agente cercherà con search_messages i thread senza risposta da più di tre giorni, recupererà il contesto completo con get_thread, li etichetterà con add_label_to_message, poi preparerà una bozza di sollecito con create_draft. Nulla partirà senza convalida umana: l'agente preparerà il terreno perché il sollecito parta in giornata.
Azioni del connettore
list_messages
Lettura. Elenca gli identificativi dei messaggi, filtrabili per label.
search_messages
Lettura. Cerca messaggi con una query Gmail.
get_message
Lettura. Recupera un messaggio completo, intestazioni e corpo inclusi.
get_thread
Lettura. Recupera un intero thread di conversazione.
list_drafts
Lettura. Elenca le bozze esistenti.
create_draft
Scrittura. Crea una bozza di risposta senza inviarla.
send_draft
Scrittura. Invia una bozza esistente.
send_email
Scrittura. Invia direttamente un'email dall'account connesso.
add_label_to_message
Scrittura. Aggiunge una label a un messaggio.
trash_message
Scrittura. Mette un messaggio nel cestino.
Prerequisiti
- Ruolo admin sull'azienda Atako per connettere l'integrazione.
- Account Gmail o Google Workspace la cui casella deve essere connessa.
- Consenso OAuth Google, scope https://www.googleapis.com/auth/gmail.modify.
- Un grant esplicito per agente, in particolare per l'azione send_email.
Come connettersi
- 1
Aprire Contesto → Integrazioni
Quando il connettore sarà attivo, un admin sceglierà Gmail nell'elenco dei connettori.
- 2
Verificare le azioni esposte
La finestra mostrerà tutte le azioni di lettura e scrittura, send_email inclusa, prima dell'autorizzazione.
- 3
Autenticarsi tramite la schermata Google
Reindirizzamento al consenso Google; nessuna password verrà trasmessa ad Atako.
- 4
Concedere l'accesso a un agente
Sceglierete le azioni precise per agente, per esempio solo create_draft per restare prudenti.
Perché collegare un agente autonomo a Gmail
Il connettore Gmail non è ancora disponibile. Questa pagina descrive cosa farà una volta attivo.
Gmail concentra gli scambi con clienti, fornitori e team. Un agente autonomo collegato non si limiterà a rispondere a un comando puntuale: lavorerà in continuo e deciderà, in base all'istruzione ricevuta, di cercare un messaggio, classificarlo o preparare una risposta, grazie al tool calling. A differenza di uno strumento di automazione a evento, che si esegue una volta e poi si ferma, l'agente percorrerà un'intera casella da solo.
La connessione userà OAuth 2.0, scope https://www.googleapis.com/auth/gmail.modify (scope Gmail di Google). Questo scope permette di leggere, comporre e inviare, ma non di eliminare un messaggio in modo immediato e permanente.
È ciò che renderà utile un flusso come lo smistamento della casella di supporto, vicino a ciò che fa un agente di triage del supporto o di automazione del supporto: riceverà ogni nuovo messaggio e preparerà una risposta senza aspettare che un umano apra una conversazione. Gmail farà parte delle integrazioni coperte dal piano Standard, senza voce di fatturazione separata per connettore.
Limiti e buone pratiche
L'azione più sensibile del connettore sarà send_email: una volta concessa in scope scrittura, l'agente invierà senza ripassare da voi. La pratica più sicura sarà concedere solo create_draft: l'agente prepara, un umano rilegge e attiva l'invio con send_draft. Prima di convalidare una bozza, controllate destinatario, oggetto e allegati: una volta attivato send_draft, l'email parte subito e non si può richiamare.
Lo scope gmail.modify copre l'intera casella collegata, non una singola etichetta. Il limite reale verrà quindi dal permesso: elencate le azioni esatte di cui l'agente ha bisogno invece di concedere tutto in una volta al momento della connessione.
Ogni chiamata, eseguita o rifiutata, sarà visibile nel registro di audit della pagina dell'agente. Come per ogni account OAuth, se il token scade o viene revocato lato Google, la connessione passerà in stato di errore fino alla riconnessione. L'account collegato resta inoltre soggetto alle quote di invio di Gmail, fissate da Google indipendentemente dal connettore: meglio distribuire gli invii automatici nell'arco della giornata.
Come per ogni integrazione Atako, la sola connessione non darà alcun accesso: nulla sarà disponibile per un agente finché un admin non avrà scelto le azioni precise e il loro scope. Questo approccio chiuso per impostazione predefinita permetterà di dare a un agente solo create_draft e a un altro, dedicato a un compito più ristretto, anche send_email.
Casi d'uso correlati
Integrazioni correlate
Scritto dagli agenti di Atako · Rivisto e approvato da Romain Laodicina · CTO di Atako
Domande frequenti
L'agente potrà inviare un'email al posto mio senza convalida?+
Solo se il permesso include send_email in scope scrittura; allora l'agente invierà direttamente. Concedere solo create_draft mantiene un umano nel ciclo: l'agente prepara la risposta, un umano la rilegge e la invia con send_draft.
Gmail sarà incluso nel piano Standard?+
Sì. Come tutte le integrazioni, Gmail sarà incluso nel piano Standard, senza costi aggiuntivi per connettore.
Come revocherò l'accesso di Atako alla mia casella Gmail?+
Da Contesto → Integrazioni, con Revoke sulla connessione Gmail. Il token cifrato verrà eliminato subito e tutti gli agenti che lo usavano perderanno l'accesso all'istante.
Lo scope gmail.modify permetterà di eliminare le email definitivamente?+
No. Questo scope Google permette di leggere, comporre, inviare e spostare nel cestino, ma non di eliminare un messaggio in modo immediato e permanente; servirebbe uno scope più ampio di quello che userà il connettore.
Cosa leggere dopo
Fonti
- Gmail API, scopes OAuth · consultato il 4 settembre 2026
- Gmail API, guide d'envoi d'emails · consultato il 4 settembre 2026
CTO di Atako
Questo contenuto è stato redatto dagli agenti IA di Atako, poi rivisto, corretto e approvato da Romain Laodicina, CTO di Atako.