Google Calendar Connection

Connect Google Calendar for AI-powered scheduling

Google Calendar Connection#

Connect Google Calendar to enable your AI agent to book appointments and manage scheduling.


What You Can Do#

With Google Calendar connected, your AI can:

CapabilityDescription
Check availabilitySee when you're free
Book appointmentsSchedule meetings with customers
Send invitesAutomatic calendar invitations
Handle reschedulingManage booking changes
Respect blocksHonor busy time and focus blocks

Setting Up#

Step 1: Navigate to Connections#

  1. Go to your agent dashboard
  2. Click SettingsConnections
  3. Find Google Calendar in the list

Step 2: Authorize Access#

  1. Click Connect
  2. Sign in with your Google account
  3. Review permissions
  4. Click Allow

Permissions We Request#

  • View your calendars
  • View and edit events
  • Send event invitations

Configuring Calendar Booking#

After connecting, configure in CapabilitiesGoogle Calendar:

Select Calendar#

Choose which calendar to use for bookings:

  • Primary calendar
  • Specific work calendar
  • Shared team calendar

Set Available Hours#

Define when bookings are allowed:

Code
Monday-Friday: 9:00 AM - 5:00 PM
Saturday: 10:00 AM - 2:00 PM
Sunday: Closed

Buffer Time#

Time between appointments:

  • 15 minutes (default)
  • 30 minutes
  • Custom

Booking Window#

How far in advance customers can book:

  • 1 day minimum
  • 30 days maximum (adjustable)

Appointment Duration#

Default meeting length:

  • 30 minutes
  • 60 minutes
  • Custom/variable

How It Works#

Customer Interaction#

Code
Customer: "I'd like to book an appointment"
AI: "I'd be happy to help! What day works best for you?"
Customer: "How about Thursday?"
AI: "I have availability at 10:00 AM, 2:00 PM, and 4:00 PM on Thursday. Which works for you?"
Customer: "2 PM please"
AI: "Perfect! I've booked you for Thursday at 2:00 PM. You'll receive a calendar invite shortly. What's your email?"

Behind the Scenes#

  1. AI checks your calendar for availability
  2. Confirms with customer
  3. Creates calendar event
  4. Sends invite to customer
  5. Adds to your calendar

Event Details#

Appointments created include:

  • Title: Customer name + service (configurable)
  • Description: Conversation summary, customer questions
  • Attendees: Customer email, your email
  • Reminders: Default calendar reminders apply

Managing Bookings#

View Appointments#

  • Check your Google Calendar directly
  • View in AlonChat ActivityCalendar

Rescheduling#

AI can handle reschedule requests:

  • Customer requests change via chat
  • AI proposes new times
  • Updates calendar automatically

Cancellations#

  • Customer can cancel via chat
  • Event is removed from calendar
  • Both parties notified

Multiple Team Members#

For teams:

Shared Calendar#

Create a shared "Bookings" calendar that all team members access.

Round-Robin (Coming Soon)#

Automatically distribute bookings among team members.


Troubleshooting#

"Calendar not loading"#

  • Refresh Google Calendar connection
  • Check calendar permissions
  • Try signing out and back in

"No available slots"#

  • Verify available hours are set
  • Check if calendar is fully booked
  • Ensure date range is correct

Events not syncing#

  • Force sync in Settings → Connections
  • Check Google Calendar is accessible
  • Verify no API limits exceeded

Best Practices#

  1. Create dedicated calendar - Keep AI bookings separate
  2. Block personal time - Use "Busy" for breaks
  3. Set realistic buffers - Avoid back-to-back meetings
  4. Test thoroughly - Book test appointments first
  5. Monitor bookings - Review weekly for patterns

Privacy & Security#

  • We only access calendars you select
  • Customer data is encrypted
  • Events are created in your name
  • You can remove access anytime

Google Calendar Connection | AlonChat Docs