Vai al contenuto

Pronto a creare con AnyBot?

Documentazione AnyBot
Integrazioni

Google Calendar

Collega un calendario e lascia che il tuo agente proponga slot liberi e prenoti appuntamenti, una reception public-safe che non rivela mai cosa c'è sul tuo calendario.

Collega Google Calendar con un solo accesso Google e il tuo agente si trasforma in una reception per le prenotazioni. Può proporre a un visitatore i tuoi slot liberi e prenotarne uno, mentre tutto ciò che rivela o modifica eventi reali resta owner-only. Sette strumenti in tutto, suddivisi in modo netto affinché uno sconosciuto arrivato dal sito web possa riservare un orario senza mai vedere il tuo calendario.

Collega

  1. Apri Integrazioni e scegli Google Calendar.
  2. Clicca su Accedi con Google e concedi l'accesso al calendario nella schermata di consenso.
  3. La connessione si collega a un solo agente, che ora può verificare la disponibilità e accettare prenotazioni.
il riquadro di connessione a Google Calendar con l'accesso Google

Il vero problema sono i tuoi orari di lavoro e il fuso orario. Disponibilità e prenotazione sono limitate dagli orari di lavoro della connessione; se non sono impostati, l'agente ripiega su UTC e potrebbe proporre slot al di fuori della tua giornata reale. Configura i tuoi orari e il fuso orario prima di puntare un agente pubblico sul calendario, altrimenti ogni slot proposto sarà sbagliato.

Strumenti

StrumentoAccessoTipoCosa fa
google_calendar_availabilityPubblico sicuroReadControlla un intervallo di date e restituisce solo gli slot di tempo liberi per ogni giorno, filtrati in base ai tuoi orari di lavoro. Non espone mai i titoli o i dettagli degli eventi.
google_calendar_book_appointmentPubblico sicuroWritePrenota un appuntamento. Verifica che lo slot richiesto rientri negli orari di lavoro e sia ancora libero, poi lo crea, senza rivelare alcun altro evento.
google_calendar_working_hoursSolo proprietarioReadRestituisce gli orari di lavoro configurati: fuso orario e orari di inizio e fine per ogni giorno.
google_calendar_list_eventsSolo proprietarioReadElenca gli eventi reali (titolo, inizio, fine, stato, luogo) per un intervallo di date. Rivela i dettagli degli eventi, a differenza della vista libero/occupato della disponibilità.
google_calendar_create_eventSolo proprietarioWriteCrea un evento a partire da un titolo e da un orario di inizio. La durata predefinita è di 30 minuti; descrizione, luogo e partecipanti sono opzionali.
google_calendar_update_eventSolo proprietarioWriteAggiorna il titolo, l'orario, la descrizione, il luogo o i partecipanti di un evento esistente.
google_calendar_delete_eventSolo proprietarioWriteElimina un evento tramite ID.

Public-safe vs owner-only

Solo availability e book appointment sono public-safe, la coppia da reception pensata apposta. La disponibilità restituisce blocchi libero/occupato senza titoli; la prenotazione conferma un solo slot e nient'altro. Entrambe sono sicure da attivare per un visitatore del sito web.

Gli altri cinque sono owner-only, raggiungibili solo da te e dal tuo team: working_hours, list_events (che sì restituisce titoli e dettagli degli eventi) e le tre mutazioni sugli eventi create / update / delete. Uno sconosciuto che chatta con il tuo agente pubblico può riservare un orario ma non può mai leggere ciò che è già prenotato né modificare una voce esistente.

Esempio pratico

Un visitatore chiede al tuo agente sul sito web, "Avete qualcosa giovedì pomeriggio?" L'agente chiama google_calendar_availability, vede i tuoi blocchi liberi entro l'orario e risponde "Ho disponibilità alle 14:00, alle 15:30 o alle 16:00." Il visitatore sceglie le 15:30 e fornisce un nome; l'agente chiama google_calendar_book_appointment, che ricontrolla che lo slot sia ancora libero, lo prenota e conferma, il tutto senza che il visitatore veda mai un altro appuntamento sul tuo calendario.

Limiti e onestà

  • Sola lettura dove conta per i visitatori. La coppia pubblica può solo leggere libero/occupato e aggiungere una prenotazione. Leggere i dettagli degli eventi o modificarli è owner-only per progettazione.
  • Orari e fuso orario guidano tutto. Gli slot sono calcolati dai tuoi orari di lavoro nel tuo fuso orario; un fuso orario non impostato ripiega su UTC. Vedi la nota sulla connessione qui sopra.
  • Un agente per connessione. Il calendario si collega all'agente a cui lo colleghi.
  • Questa integrazione non invia promemoria via SMS o email, prenota lo slot; le notifiche sono una questione a parte.

Risoluzione dei problemi

  • L'agente propone orari strani o il giorno sbagliato, gli orari di lavoro o il fuso orario non sono impostati, quindi ripiega su UTC. Configurali e ripeti la prova.
  • "Slot non più disponibile" in fase di prenotazione, lo strumento di prenotazione riverifica lo stato aggiornato al momento della prenotazione; qualcuno ha preso lo slot tra la proposta e la conferma. Proponi il successivo disponibile.
  • Il visitatore non riesce a vedere una prenotazione passata, è previsto. Elencare gli eventi è owner-only; gli agenti pubblici non leggono mai indietro il calendario.

FAQ

Un visitatore del sito web può vedere cosa c'è sul mio calendario? No. Gli strumenti pubblici restituiscono solo libero/occupato e una conferma di prenotazione. list_events è owner-only.

L'agente può riprogrammare o annullare? Solo i tuoi agenti rivolti al proprietario possono, update_event e delete_event sono owner-only. I visitatori pubblici possono prenotare, non modificare.

È la stessa cosa che collegare Gmail o Drive? No, quelle sono superfici Google separate. Vedi Google Workspace.

Prossimi passi