Agenda
Collegare Google Calendar a un agente IA autonomo
Google Calendar centralizza appuntamenti e disponibilità di tutta l'azienda. Il connettore Google Calendar arriverà presto: un agente Atako potrà proporre slot, creare eventi e segnalare conflitti, 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
Fissare un appuntamento con un cliente senza andirivieni
Un commerciale o un team di supporto riceve una richiesta di appuntamento. L'agente verificherà gli slot liberi con check_availability sul calendario interessato, proporrà due o tre slot adatti, poi creerà l'evento con create_event una volta confermato lo slot. Se il permesso create_event è in scope scrittura, Google invierà subito l'invito ai partecipanti; altrimenti l'agente si limiterà a elencare gli slot disponibili in un messaggio preparato, senza mai prenotare da solo.
Rilevamento di conflitti e doppie prenotazioni
L'agente elencherà gli eventi in arrivo con list_events, individuerà due riunioni sovrapposte o un appuntamento non confermato da giorni, e preparerà una proposta di soluzione. Non sposterà né annullerà nulla da solo: cancel_event e update_event resteranno azioni distinte, concesse separatamente se l'azienda vuole che l'agente agisca direttamente invece di segnalare il conflitto all'organizzatore.
Ricerca di uno slot comune per un colloquio o una riunione di team
Per organizzare un colloquio o una riunione con più calendari, l'agente elencherà i calendari accessibili con list_calendars, ne interrogherà la disponibilità con check_availability, poi individuerà il primo slot comune nel periodo richiesto. Creerà l'evento solo dopo che un umano avrà convalidato lo slot, salvo che create_event sia stato concesso esplicitamente per automatizzare del tutto 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 Contesto → Integrazioni
Quando il connettore sarà attivo, un admin sceglierà Google Calendar nell'elenco dei connettori.
- 2
Verificare le azioni esposte
La finestra mostrerà tutte le azioni sul calendario, lettura e scrittura, 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 check_availability e list_events per restare in lettura.
Perché collegare un agente autonomo a Google Calendar
Il connettore Google Calendar non è ancora disponibile. Questa pagina descrive cosa farà una volta attivo.
Google Calendar concentra appuntamenti, riunioni e disponibilità di gran parte delle aziende, soprattutto quelle su Google Workspace. Un agente autonomo collegato non si limiterà a rispondere a un comando puntuale: lavorerà in continuo e deciderà, in base all'istruzione ricevuta, di verificare uno slot libero, individuare un conflitto o proporre un appuntamento, grazie al tool calling.
La connessione userà OAuth 2.0 e lo scope calendar.events di Google Calendar (scope OAuth di Google). Questo scope permette di leggere, creare e modificare eventi, mai di eliminare l'account Google stesso o di cambiarne le impostazioni di sicurezza.
È ciò che renderà utile un flusso come la ricerca di uno slot comune per un colloquio, vicino a ciò che fa un agente di operazioni HR, o la prenotazione di un appuntamento commerciale, vicino a un agente di revenue operations: riceverà una richiesta e preparerà il passo successivo (uno slot, un evento, un promemoria di conferma) senza aspettare che qualcuno apra il calendario e confronti a mano la disponibilità di più persone. Google Calendar 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à create_event: una volta concessa in scope scrittura, l'agente prenoterà un appuntamento e Google invierà l'invito a ogni partecipante, senza ripassare da voi. La pratica più sicura sarà concedere solo check_availability e list_events: l'agente propone gli slot, un umano crea l'evento finale e invia gli inviti.
Lo scope calendar.events copre l'intero calendario dell'account collegato, non un singolo calendario secondario. Il limite reale verrà quindi dal permesso: elencate le azioni esatte di cui l'agente ha bisogno, per esempio la sola lettura per una semplice consultazione, invece di concedere creazione e annullamento tutti insieme.
update_event e cancel_event modificheranno o rimuoveranno un evento esistente, anche per i partecipanti che avevano già accettato l'invito originale. Riservate queste due azioni a un agente il cui ruolo lo richieda davvero, e separate cancel_event da create_event se volete che possa proporre senza mai annullare.
Si applicheranno le quote standard dell'API Google Calendar. 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.
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à creare un appuntamento e inviare l'invito senza convalida?+
Solo se il permesso include create_event in scope scrittura; allora l'agente creerà l'evento e Google invierà l'invito. Limitare l'agente a check_availability e list_events mantiene un umano nel ciclo: propone gli slot, un umano crea l'appuntamento finale.
Google Calendar sarà incluso nel piano Standard?+
Sì. Come tutte le integrazioni, Google Calendar sarà incluso nel piano Standard, senza costi aggiuntivi per connettore.
Come revocherò l'accesso di Atako al mio calendario Google?+
Da Contesto → Integrazioni, con Revoke sulla connessione Google Calendar. Il token cifrato verrà eliminato subito e tutti gli agenti che lo usavano perderanno l'accesso all'istante.
Lo scope calendar.events permetterà all'agente di vedere i calendari dei colleghi?+
No. Questo scope copre solo l'account Google collegato. L'agente vedrà un altro calendario solo se è stato condiviso esplicitamente con quell'account in precedenza, e solo nei 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.