Google Calendar

Collega i tuoi agenti ElevenLabs alla pianificazione di Google Calendar

Panoramica

Collega i tuoi agenti IA di ElevenLabs a Google Calendar per gestire pianificazioni e appuntamenti del calendario. Questa integrazione consente ai tuoi agenti di verificare la disponibilità, creare eventi con partecipanti e videoconferenze Google Meet opzionali, elencare i prossimi eventi e individuare i calendari accessibili tramite conversazioni naturali.

Funzionalità

Funzionalità	Supporto
Modalità zero retention (ZRM)	Non supportata
Allegati negli strumenti	Non supportati — gli strumenti operano solo sul testo

Configurazione

Questa integrazione utilizza Google OAuth 2.0 per l’autenticazione. Autorizzi ElevenLabs ad accedere al tuo Google Calendar per tuo conto.

Fai clic su Connetti in ElevenLabs

Nella configurazione dell’integrazione ElevenLabs, fai clic su Connetti. Verrai reindirizzato a Google per autorizzare l’accesso.

Seleziona il tuo account Google

Scegli l’account Google i cui dati del calendario deve poter accedere il tuo agente. Se nel browser hai effettuato l’accesso a più account Google, seleziona quello corretto.

Autorizza l'accesso al calendario

Esamina le autorizzazioni richieste e fai clic su Consenti. L’integrazione richiede l’accesso per gestire gli eventi dei calendari di tua proprietà, visualizzare l’elenco dei calendari e controllare le informazioni sulla disponibilità.

Ambiti OAuth

L’integrazione richiede i seguenti ambiti Google OAuth 2.0:

Ambito	Scopo
`calendar.events.owned`	Crea, legge, aggiorna ed elimina eventi nei calendari di tua proprietà.
`calendar.calendarlist.readonly`	Visualizza l’elenco dei calendari accessibili al tuo account (nomi e ID).
`calendar.freebusy`	Verifica la disponibilità nei calendari senza esporre i dettagli degli eventi.

Come funziona

L’agente pianifica le riunioni utilizzando chiamate agli strumenti per seguire la procedura di prenotazione. Le schede seguenti mostrano un riepilogo generale e un prompt di sistema dettagliato.

Panoramica generale

Prompt di sistema dettagliato

Individua i calendari

L’agente elenca i calendari accessibili per identificare quello corretto per la pianificazione. Per la maggior parte degli utenti, è il calendario principale.

Verifica la disponibilità

L’agente verifica la disponibilità:

Utilizzando lo strumento google_calendar_check_availability per cercare gli intervalli di tempo occupati.
Verificando se l’orario richiesto è libero.
Suggerendo alternative se l’orario richiesto è in conflitto con un evento esistente.
Confermando l’orario selezionato con il chiamante.

Raccogli i dati dei partecipanti

Una volta concordato un orario, l’agente:

Raccoglie nome completo e indirizzo email del partecipante.
Conferma l’email rileggendola al chiamante.
Verifica le informazioni sul fuso orario.

Crea l'evento

L’agente:

Chiama lo strumento google_calendar_create_event con i dettagli confermati.
Aggiunge facoltativamente un link a Google Meet se viene richiesta una videoconferenza.
Conferma la creazione dell’evento e informa il partecipante che riceverà un invito del calendario.

Strumenti dell’agente

Quando aggiungi gli strumenti di Google Calendar a un agente, sono disponibili i seguenti strumenti integrati:

Strumento	Descrizione
`google_calendar_check_availability`	Verifica la disponibilità in uno o più calendari entro un intervallo di tempo. Restituisce gli intervalli occupati affinché l’agente possa trovare fasce libere. Usalo prima di creare eventi per evitare conflitti.
`google_calendar_create_event`	Crea un nuovo evento in Google Calendar con partecipanti, luogo e videoconferenza Google Meet facoltativi. Invia notifiche via email a tutti i partecipanti.
`google_calendar_list_events`	Elenca i prossimi eventi di un calendario entro un intervallo di tempo, ordinati per ora di inizio. Supporta la ricerca testuale libera tra riepiloghi, descrizioni, luoghi e dettagli dei partecipanti degli eventi.
`google_calendar_list_calendars`	Elenca tutti i calendari accessibili all’account Google connesso. Restituisce nomi e ID dei calendari. Usalo per individuare il calendario di destinazione prima di verificare la disponibilità o creare eventi.