Passa al contenuto principale
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

Collega Google Calendar così i tuoi agenti vocali IA possono verificare la disponibilità e prenotare appuntamenti reali mentre un chiamante è ancora in linea. Una volta connesso, ogni agente del tuo account può usare il calendario — non è necessaria una riautorizzazione per agente.

Disponibile su tutti i piani

Google Calendar è disponibile su tutti i piani incluso Free. Nessun costo aggiuntivo — le verifiche di disponibilità e la creazione di eventi utilizzano alcune parole di output LLM per turno, fatturate alla tua normale tariffa al minuto.

Cosa fa​

  • Verifiche di disponibilità — l'agente legge il tuo calendario per confermare se uno slot richiesto è libero.
  • Creazione di eventi — l'agente prenota un appuntamento confermato come nuovo evento del calendario, con il nome del chiamante, il telefono e qualsiasi nota catturata durante la chiamata.
  • Link di cancellazione — ogni prenotazione include un link self-service di cancellazione che il chiamante riceve via email o SMS, così può modificare i piani senza richiamare.

L'agente non legge i dettagli degli eventi di altre persone, non modifica eventi non correlati e non espone il contenuto del calendario — solo gli slot di cui ha bisogno per rispondere al chiamante.

Connessione del tuo account Google​

  1. Apri Integrazioni nella barra laterale e clicca su Connetti Google Calendar.
  2. Vieni reindirizzato alla schermata di consenso standard di Google.
  3. Accedi con l'account Google che possiede il calendario che vuoi usare.
  4. Rivedi il permesso richiesto — Visualizza e modifica eventi sui tuoi calendari — e clicca su Consenti.
  5. Vieni riportato in HANC e la card di integrazione mostra Connesso con l'indirizzo email utilizzato.

Ambito richiesto​

HANC richiede un singolo ambito OAuth: https://www.googleapis.com/auth/calendar.events.

Questo è un ambito Sensibile (non Limitato), il che significa:

  • HANC può leggere e creare eventi, ma non può leggere l'intero elenco dei tuoi calendari, le impostazioni di condivisione o accedere ad altri servizi Google (no Gmail, no Drive, no contatti).
  • Google non richiede una Security Assessment per questo ambito e non c'è una riverifica annuale.

A livello di account, non per agente​

La connessione vive a livello di account HANC. I token vengono memorizzati una sola volta in uno store condiviso e resi disponibili a ogni agente vocale IA del tuo account. Autorizzi una volta e poi abiliti lo strumento del calendario su tutti gli agenti che vuoi.

Questo è diverso dalle impostazioni per agente come prompt, knowledge base o voce — quelle sono configurate separatamente su ciascun agente.

Configurazione dello strumento per agente​

Connettere Google al tuo account HANC rende lo strumento disponibile. Per usarlo effettivamente, aggiungi lo strumento Google Calendar alla scheda Azioni dell'agente e configuralo.

ImpostazioneCosa fa
CalendarioQuale calendario connesso l'agente legge e scrive
Fuso orarioIl fuso orario utilizzato per ogni slot citato dall'agente (vedi sotto)
Orari di lavoroGiorni e intervalli di tempo che l'agente offrirà (es. lun-ven, 09:00-18:00)
Durata slotDurata predefinita dell'appuntamento (es. 30 minuti)
BufferPadding tra appuntamenti consecutivi (es. 15 minuti)

Ogni agente sul tuo account può configurare queste impostazioni in modo indipendente — utile quando un agente prenota demo di vendita di 30 minuti e un altro prenota consulenze di 90 minuti dallo stesso calendario.

Per il walkthrough di setup completo incluso l'equivalente Outlook, vedi Integrazioni → Google Calendar.

Gestione del fuso orario​

Tutte le offerte di slot, conferme ed eventi creati utilizzano il fuso orario configurato sullo strumento del calendario dell'agente (es. Europe/Vienna, Europe/Berlin, America/New_York). L'agente dice ad alta voce il fuso orario quando offre uno slot — ad esempio, "Martedì alle tre del pomeriggio ora di Vienna, va bene?" — così il chiamante non deve mai indovinare.

Se il tuo chiamante è in un fuso orario diverso, configura l'agente per confermare verbalmente l'equivalente locale prima di prenotare. L'evento Google Calendar creato memorizza sempre l'ora nel fuso orario configurato; Google gestisce la visualizzazione nel fuso orario locale di ciascun partecipante.

Disconnessione e riconnessione​

Puoi disconnettere Google Calendar in qualsiasi momento dalla pagina Integrazioni.

Quando disconnetti:

  • I token memorizzati vengono rimossi.
  • Ogni strumento Google Calendar su ogni agente del tuo account viene disattivato — lo strumento rimane in posizione su ciascun agente ma non si attiva più durante le chiamate.
  • Gli eventi prenotati esistenti in Google stesso non vengono eliminati o modificati.

Quando ti riconnetti (o connetti un account Google diverso), gli strumenti precedentemente disattivati si riattivano automaticamente con le loro vecchie impostazioni di orari di lavoro, durata slot e fuso orario — non devi riaggiungere lo strumento su ciascun agente.

Puoi anche revocare l'accesso di HANC dalle impostazioni di sicurezza del tuo account Google. L'effetto è lo stesso della disconnessione dall'interno di HANC; la prossima chiamata che tenta di utilizzare il calendario fallirà in modo pulito e gli strumenti si disattiveranno alla prossima sincronizzazione.

Appuntamenti prenotati in HANC​

Ogni evento che l'agente crea appare anche in CRM → Calendario insieme a qualsiasi prenotazione Outlook, con un link al record contatto del chiamante. Vedi CRM → Calendario per la vista unificata.

Correlati​