Comunicazione
Connettere Gmail a un agente IA autonomo
Gmail concentra gli scambi con clienti e team interno. Un agente Atako può smistare, preparare bozze e ripulire una casella, senza mai vedere la vostra password Google.
Prossimamente — 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 elenca i messaggi non letti con list_messages, li classifica per label con add_label_to_message (fatturazione, bug, domanda generale), poi redige una risposta in bozza con create_draft per ogni richiesta chiara. Un umano rilegge e invia con send_draft. L'agente utilizza send_email solo se questo grant preciso gli è stato concesso.
Pulizia periodica della casella
Newsletter, notifiche automatiche, conferme di ricezione: l'agente cerca questi messaggi con search_messages (es. from:noreply), verifica la loro label con list_labels, poi li mette nel cestino con trash_message invece di lasciarli accumulare nella casella principale. La casella resta leggibile senza che un umano vi passi dieci minuti ogni mattina a fare questo smistamento manuale ripetitivo, settimana dopo settimana.
Monitoraggio dei thread cliente da sollecitare
L'agente cerca i thread senza risposta da più di tre giorni con search_messages, recupera il contesto completo con get_thread, li etichetta con add_label_to_message, poi prepara una bozza di sollecito con create_draft. Nulla parte senza convalida umana: l'agente si limita a preparare il terreno affinché il sollecito parta lo stesso giorno, senza aspettare che un commerciale ci pensi da solo.
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 Impostazioni → Integrazioni
Un admin sceglie Gmail dalla lista dei connettori disponibili.
- 2
Verificare le azioni esposte
La finestra mostra tutte le azioni di lettura e scrittura, send_email incluso, prima dell'autorizzazione.
- 3
Autenticarsi tramite la schermata Google
Reindirizzamento verso il consenso Google, nessuna password trasmessa ad Atako.
- 4
Concedere l'accesso a un agente
Si scelgono le azioni precise per agente, per esempio solo create_draft per restare prudenti.
Perché collegare un agente autonomo a Gmail
Gmail concentra gli scambi con clienti, fornitori e team. Un agente autonomo collegato non si limita a rispondere a un comando puntuale: gira in continuo e decide, in base all'istruzione ricevuta, di cercare un messaggio, classificarlo o preparare una risposta, grazie al tool calling.
La connessione utilizza 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 rende utile un flusso come lo smistamento della casella support, vicino a ciò che fa un agente di triage supporto o di automazione del supporto: riceve ogni nuovo messaggio e prepara una risposta senza aspettare che un umano apra una conversazione di chat. Gmail fa parte delle integrazioni coperte dal piano Standard, senza una voce di fatturazione separata per connettore.
Limiti e buone pratiche
L'azione più sensibile del connettore è send_email: una volta concessa in scope scrittura, l'agente invia senza ripassare da voi. La pratica più sicura consiste nel concedere solo create_draft, l'agente prepara, un umano rilegge e attiva l'invio con send_draft.
Lo scope gmail.modify copre tutta la casella connessa, non un'etichetta o una label precisa. Il vero limite deriva quindi dal grant: elencate le azioni esatte di cui l'agente ha bisogno invece di concedere tutto in una volta fin dalla connessione.
La documentazione non menziona un limite di frequenza specifico per il connettore Gmail. Ogni chiamata, inviata o rifiutata, resta consultabile nel registro di audit della pagina dell'agente. E come per ogni account OAuth, se il token scade o viene revocato lato Google, la connessione passa in stato di errore fino alla riconnessione.
Casi d'uso correlati
Integrazioni correlate
Domande frequenti
L'agente può inviare un'email al posto mio senza convalida?
Sì, se il grant include send_email in scope scrittura, l'agente invia allora direttamente. La maggior parte delle aziende preferisce concedere solo create_draft: l'agente prepara la risposta, un umano la rilegge e la invia con send_draft.
Serve un piano a pagamento per connettere Gmail?
Sì, è necessario un piano Atako attivo, ma Gmail fa parte di tutte le integrazioni già incluse nel piano Standard, senza sovrapprezzo per connettore.
Come revocare l'accesso di Atako alla mia casella Gmail?
Da Impostazioni → Integrazioni, cliccate su Revoke sulla connessione Gmail. Il token cifrato viene eliminato immediatamente, e tutti gli agenti che lo utilizzavano perdono l'accesso all'istante.
Lo scope gmail.modify permette di eliminare email definitivamente?
No, questo scope permette di leggere, comporre, inviare e mettere nel cestino, ma non di eliminare un messaggio in modo immediato e permanente, il che richiederebbe uno scope più ampio di quello usato dal 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.