Google Calendar
Collega Google Calendar così i tuoi agenti vocali possono verificare la disponibilità e prenotare appuntamenti reali mentre il chiamante è ancora in linea. Una volta collegato, ogni agente del tuo account può usare il calendario — nessuna ri-autorizzazione per singolo agente necessaria.
Google Calendar è disponibile su tutti i piani, incluso Free. Nessuna commissione extra — le ricerche sul calendario e la creazione di eventi usano poche parole di output LLM per turno, addebitate 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 le eventuali note raccolte durante la chiamata.
- Link di annullamento — ogni prenotazione include un link di annullamento self-service che il chiamante riceve via email o SMS, così può cambiare programmi senza richiamare.
L'agente non legge i dettagli degli eventi di altre persone, non modifica eventi non correlati né espone i contenuti del calendario — solo gli slot di cui ha bisogno per rispondere al chiamante.
Se gestisci gli appuntamenti tramite un sistema di prenotazione dedicato, collega invece eTermin (servizi, riprogrammazione, annullamento, protezione contro le doppie prenotazioni) o, per i tavoli dei ristoranti, resmio. Quelle integrazioni prenotano direttamente nel sistema che il tuo team già usa.
Collegare il tuo account Google
- Apri Integrations nella barra laterale e clicca Connect Google Calendar.
- Vieni reindirizzato alla schermata di consenso standard di Google.
- Accedi con l'account Google proprietario del calendario che vuoi usare.
- Rivedi l'autorizzazione richiesta — Visualizza e modifica gli eventi sui tuoi calendari — e clicca Allow.
- Torni in HANC e la scheda dell'integrazione mostra Connected con l'indirizzo email usato.
Scope richiesto
HANC richiede un singolo scope OAuth: https://www.googleapis.com/auth/calendar.events.
Questo è uno scope Sensitive (non Restricted), il che significa che:
- HANC può leggere e creare eventi, ma non può leggere l'elenco completo dei tuoi calendari, le impostazioni di condivisione, né accedere ad alcun altro servizio Google (niente Gmail, niente Drive, niente contatti).
- Google non richiede una Security Assessment per questo scope e non c'è alcuna ri-verifica annuale.
A livello di account, non per singolo 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 del tuo account. Autorizzi una volta e poi abiliti lo strumento calendario su quanti agenti vuoi.
Questo è diverso dalle impostazioni per singolo agente come prompt, knowledge base o voce — quelle sono configurate separatamente su ciascun agente.
Configurazione dello strumento per singolo agente
Collegare Google al tuo account HANC rende lo strumento disponibile. Per usarlo davvero, aggiungi lo strumento Google Calendar alla scheda Actions dell'agente e configuralo.
| Impostazione | Cosa fa |
|---|---|
| Calendar | Quale calendario collegato l'agente legge e scrive |
| Timezone | Il fuso orario usato per ogni slot che l'agente propone (vedi sotto) |
| Work hours | Giorni e fasce orarie che l'agente proporrà (es. lun–ven, 09:00–18:00) |
| Slot duration | Durata predefinita dell'appuntamento (es. 30 minuti) |
| Buffer | Margine tra appuntamenti consecutivi (es. 15 minuti) |
Ogni agente del tuo account può configurare queste impostazioni in modo indipendente — utile quando un agente prenota demo di vendita da 30 minuti e un altro prenota consulenze da 90 minuti dallo stesso calendario.
Per la procedura completa di configurazione, incluso l'equivalente Outlook, vedi Integrazioni → Google Calendar.
Gestione del fuso orario
Tutte le proposte di slot, le conferme e gli eventi creati usano il fuso orario configurato sullo strumento calendario dell'agente (es. Europe/Vienna, Europe/Berlin, America/New_York). L'agente dice il fuso orario ad alta voce quando propone uno slot — ad esempio, "Martedì alle tre del pomeriggio, ora di Vienna, ti va bene?" — così il chiamante non deve mai indovinare.
Se il tuo chiamante si trova 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'orario nel fuso orario configurato; Google gestisce la visualizzazione nel fuso locale di ciascun partecipante.
Disconnessione e riconnessione
Puoi disconnettere Google Calendar in qualsiasi momento dalla pagina Integrations.
Quando disconnetti:
- I token memorizzati vengono rimossi.
- Ogni strumento Google Calendar su ogni agente del tuo account viene disattivato — lo strumento resta al suo posto su ciascun agente ma non si attiva più durante le chiamate.
- Gli eventi già prenotati in Google non vengono eliminati o modificati.
Quando riconnetti (o colleghi un account Google diverso), gli strumenti precedentemente disattivati si riattivano automaticamente con le loro vecchie impostazioni di orari di lavoro, durata degli slot e fuso orario — non devi ri-aggiungere lo strumento su ciascun agente.
Puoi anche revocare l'accesso di HANC dalle impostazioni di sicurezza del tuo account Google. L'effetto è lo stesso di una disconnessione da dentro HANC; il prossimo tentativo di chiamata che prova a usare il calendario fallirà in modo pulito e gli strumenti si disattiveranno alla successiva sincronizzazione.
Appuntamenti prenotati in HANC
Ogni evento creato dall'agente compare anche in CRM → Calendar insieme alle eventuali prenotazioni Outlook, con un link alla scheda contatto del chiamante. Vedi CRM → Calendar per la vista unificata.
Correlati
- Integrazioni — configurazione della connessione ed equivalente Outlook Calendar
- Agenti vocali → Azioni — aggiungere lo strumento Calendar a un agente
- CRM → Calendar — vista unificata degli appuntamenti prenotati