Agenda
Collegare Google Calendar a un agente IA autonomo
Google Calendar centralizza appuntamenti e disponibilità di tutta l'azienda. Un agente Atako può proporre slot, creare eventi e individuare conflitti, senza mai vedere la tua password Google.
Prossimamente — crea il tuo account e ti avviseremo non appena questa integrazione sarà pronta.
Workflow possibili
Fissare un appuntamento con un cliente senza andirivieni
Un commerciale o un team di supporto riceve una richiesta di appuntamento. L'agente verifica gli slot liberi con check_availability sul calendario interessato, propone due o tre slot compatibili, quindi crea l'evento con create_event una volta confermato lo slot scelto. L'invito parte automaticamente ai partecipanti non appena l'evento viene creato, se il grant create_event è concesso in scrittura; senza di esso, l'agente si limita a elencare gli slot disponibili in un messaggio preparato, senza mai fissare l'appuntamento da solo.
Rilevamento di conflitti e doppie prenotazioni
L'agente elenca gli eventi in arrivo con list_events, individua due riunioni sovrapposte o un appuntamento rimasto senza conferma per diversi giorni, e prepara una proposta di risoluzione. Non sposta né annulla nulla di propria iniziativa: cancel_event e update_event restano azioni distinte, concesse separatamente se l'azienda vuole che l'agente agisca direttamente invece di limitarsi a segnalare il conflitto all'organizzatore.
Ricerca di uno slot comune per un colloquio o una riunione di team
Per organizzare un colloquio di selezione o una riunione con più calendari, l'agente elenca i calendari accessibili con list_calendars, interroga la loro disponibilità con check_availability, quindi individua il primo slot comune nel periodo richiesto. Crea l'evento solo dopo che quello slot è stato convalidato da una persona, a meno che create_event non sia stato esplicitamente concesso per automatizzare interamente la prenotazione.
Azioni del connettore
list_events
Lettura. Elencare gli eventi di un calendario in un periodo determinato.
get_event
Lettura. Recuperare i dettagli completi di un evento, inclusi i partecipanti.
search_events
Lettura. Cercare eventi con una query testuale.
check_availability
Lettura. Verificare gli slot liberi e occupati di uno o più calendari.
list_calendars
Lettura. Elencare i calendari accessibili all'account connesso.
create_event
Scrittura. Creare un evento con i relativi partecipanti.
update_event
Scrittura. Modificare un evento esistente: orario, partecipanti o descrizione.
respond_to_event
Scrittura. Rispondere a un invito ricevuto: accettare, rifiutare o provvisorio.
add_attendee
Scrittura. Aggiungere un partecipante a un evento esistente.
cancel_event
Scrittura. Annullare un evento esistente del calendario.
Prerequisiti
- Ruolo di amministratore nell'azienda Atako per collegare l'integrazione.
- Account Google, personale o Workspace, il cui calendario deve essere collegato.
- Consenso OAuth Google, ambito https://www.googleapis.com/auth/calendar.events.
- Un grant esplicito per agente, in particolare per create_event e cancel_event.
Come connettersi
- 1
Aprire Impostazioni → Integrazioni
Un amministratore sceglie Google Calendar dall'elenco dei connettori disponibili.
- 2
Verificare le azioni esposte
La finestra mostra tutte le azioni di calendario, lettura e scrittura, prima dell'autorizzazione.
- 3
Autenticarsi tramite la schermata Google
Reindirizzamento al consenso Google, nessuna password trasmessa ad Atako.
- 4
Concedere l'accesso a un agente
Si scelgono le azioni precise per agente, per esempio solo check_availability e list_events per restare in sola lettura.
Perché collegare un agente autonomo a Google Calendar
Google Calendar riunisce appuntamenti, riunioni e disponibilità per gran parte delle aziende, in particolare quelle su Google Workspace. Un agente autonomo collegato a esso non si limita a rispondere a un singolo comando: funziona in modo continuo e decide, in base all'istruzione ricevuta, di verificare uno slot libero, individuare un conflitto o proporre un appuntamento, grazie al tool calling.
La connessione utilizza OAuth 2.0 e l'ambito Google Calendar calendar.events (ambiti OAuth di Google). Questo ambito permette di leggere, creare e modificare eventi di calendario, mai di eliminare l'account Google stesso o modificarne le impostazioni di sicurezza.
Questo è ciò che rende utile un flusso come la ricerca di uno slot comune per un colloquio, vicino a quanto fa un agente di operazioni HR, o la fissazione di un appuntamento commerciale, vicina a un agente di operazioni revenue: riceve una richiesta e prepara il passo successivo (uno slot, un evento, un promemoria di conferma) senza attendere che una persona apra il proprio calendario per confrontare a mano la disponibilità di più persone. Google Calendar è tra le integrazioni coperte dal piano Standard, senza voce di fatturazione separata per connettore.
Limiti e buone pratiche
L'azione più sensibile del connettore è create_event: una volta concessa con ambito scrittura, l'agente fissa un appuntamento e Google invia automaticamente l'invito a tutti i partecipanti, senza tornare a interpellarti. La pratica più sicura consiste nel concedere solo check_availability e list_events: l'agente propone slot, una persona crea l'evento definitivo e attiva l'invio degli inviti da sola.
L'ambito calendar.events copre l'intero calendario dell'account connesso, non un calendario secondario specifico. Il limite reale deriva dunque dal grant: elenca le azioni esatte di cui l'agente ha bisogno, per esempio la sola lettura per un uso di semplice consultazione, invece di concedere creazione e annullamento tutti in una volta al momento del collegamento.
update_event e cancel_event modificano o rimuovono un evento esistente, anche per gli altri partecipanti se hanno già accettato l'invito originale. Riserva queste due azioni a un agente il cui ruolo lo richieda davvero, e mantieni cancel_event separato da create_event nel grant se vuoi che possa proporre senza mai poter annullare.
La documentazione non menziona un limite di frequenza specifico per il connettore Google Calendar, si applicano le quote standard dell'API di Google Calendar. Ogni chiamata, inviata o rifiutata, resta consultabile nel registro di controllo della pagina dell'agente. E come per qualsiasi account OAuth, se il token scade o viene revocato lato Google, la connessione passa allo stato di errore fino alla riconnessione.
Casi d'uso correlati
Integrazioni correlate
Domande frequenti
L'agente può creare un appuntamento e inviare l'invito senza convalida?
Sì, se il grant include create_event con ambito scrittura, l'agente crea l'evento e Google invia automaticamente l'invito ai partecipanti. La maggior parte delle aziende preferisce limitare l'agente a check_availability e list_events: propone slot, una persona crea l'appuntamento definitivo.
Serve un piano a pagamento per collegare Google Calendar?
Sì, è necessario un piano Atako attivo, ma Google Calendar è tra le integrazioni già incluse nel piano Standard, senza sovrapprezzo per connettore.
Come si revoca l'accesso di Atako al mio calendario Google?
Da Impostazioni → Integrazioni, clicca su Revoke sulla connessione Google Calendar. Il token cifrato viene eliminato immediatamente, e tutti gli agenti che lo usavano perdono l'accesso subito.
L'ambito calendar.events permette di vedere i calendari di altri colleghi?
No, questo ambito copre solo l'account Google connesso. L'agente vede il calendario di un collega solo se questo è stato esplicitamente condiviso in precedenza con tale account, e solo entro i limiti di tale condivisione.
Cosa leggere dopo
Fonti
- Google Calendar API, guida di riferimento · consultato il 7 settembre 2026
- OAuth 2.0 Scopes for Google APIs · consultato il 7 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.