Ayra AI
|Docs
Google Calendar

Google Calendar Integration

Scheduling & Availability

Transform AI voice agents into scheduling assistants that check availability, book appointments, send invites, and manage calendars through natural conversation.

Why Calendar Integration Matters

Calendar integration transforms AI voice agents from simple information providers into capable scheduling assistants that actually book appointments without human intervention. This is transformative for appointment-based businesses.

❌ Without Calendar Integration

Customer asks about availability → Agent transfers to human → Customer waits on hold → Human checks calendar → Manually books appointment. Minutes wasted.

✓ With Calendar Integration

Customer asks → AI checks real-time availability → Offers slots → Customer selects → Booked instantly with calendar invite. Under 60 seconds.

Instant Scheduling

No waiting or transfers

24/7 Availability

Book any time

Auto Reminders

Reduce no-shows

No Double-Booking

Real-time sync

Integration Capabilities

Real-Time Availability Checking

Query Google Calendar in real-time. "Do you have any openings on Tuesday?" returns available slots based on existing appointments, business hours, and blocked time.

Natural language understanding: "Do you have any late afternoon slots this week?" → AI interprets 3-6 PM, next 7 days, returns matching slots.

Appointment Booking

Create calendar events immediately when customers select times. Events include title, duration, description with customer details, attendees for invite delivery, and location.

Calendar Invite Management

Automatic invites sent to customers via email with date, time, location/join link, and preparation instructions. "Add to Calendar" functionality works with any calendar app.

Rescheduling & Cancellation

Self-service 24/7 schedule management. Customers reschedule or cancel via voice conversation. AI confirms existing appointment, offers alternatives, and updates calendar.

Multi-Calendar Management

Manage multiple calendars—individual providers, resource calendars for rooms/equipment, or different appointment types. Check availability across all and book on appropriate calendar.

Recurring Appointments

Schedule recurring events through conversation—weekly sessions, monthly check-ins. Handle holidays, reschedule individual instances, and manage series intelligently.

Setting Up Google Calendar Integration

Prerequisites

  • Google account with Google Calendar access
  • Permissions to authorize third-party apps
  • Understanding of appointment types, durations, and scheduling rules

OAuth Authentication

1

Navigate to Calendar

In Ayra: Integrations → Calendar & Scheduling → Google Calendar

2

Click Connect

Begin OAuth flow to Google

3

Select Google Account

Choose account with calendars to integrate

4

Grant Permissions

Allow read/write access to calendars and events

5

Verify Connection

Ayra displays your Google account and accessible calendars

Configuration Settings

Calendar Selection

Select which calendars to check for conflicts and which to create appointments on.

Business Hours

Define operating days/hours, lunch breaks, and holidays when scheduling is disabled.

Appointment Types

Configure type names, default durations, prep time, and cleanup time for each appointment type.

Buffer Time & Constraints

Set buffer between appointments, minimum lead time, maximum booking horizon, daily limits.

Usage Scenarios

Customer Appointment Booking

Customer: "I'd like to schedule an appointment."

Agent: "What day works best for you?"

Customer: "Tuesday afternoon if possible."

Agent: "I have Tuesday at 2 PM, 3 PM, and 4 PM. Which works?"

Customer: "2 PM works."

Agent: "Perfect, I've scheduled you for Tuesday at 2 PM. You'll receive a calendar invite by email."

Automated Reminders

Trigger reminders at 24 hours, 2 hours, and 15 minutes before. Customers can confirm, reschedule, or cancel through reminders.

Group Scheduling

Collect attendee information, check availability across all, create events inviting all attendees simultaneously.

Virtual Meeting Links

Automatically generate Google Meet links or integrate with Zoom/Teams. Join links included in calendar invites.

Waitlist Management

Add customers to waitlists when slots are full. Auto-contact when cancellations create openings.

Advanced Features

Cross-Platform Sync

Appointments appear on all devices where Google Calendar is accessed—phones, tablets, computers.

Time Zone Handling

Events store in specific time zones and display correctly for each user's local time.

Location & Directions

Physical addresses trigger Google Maps integration. Include parking and entrance details.

Google Workspace

For Workspace users: shared calendars, resource booking, and delegation support.

Best Practices

Maintain Calendar Accuracy

Keep all appointments in Google Calendar—not just AI-booked ones. Block personal time to prevent conflicts.

Use Descriptive Event Titles

"Initial Consultation - John Smith" provides context at a glance vs generic "Appointment".

Leverage Event Descriptions

Include customer contact info, appointment reason, special requests, and preparation requirements.

Configure Appropriate Defaults

Set sensible defaults for duration, buffer times, and booking horizons matching your operations.

Troubleshooting

Connection Issues

Verify OAuth authorization current, confirm Google account active, check calendar access permissions granted.

Availability Check Failures

Verify read access to relevant calendars, confirm business hours configured correctly, check buffer constraints.

Booking Failures

Verify write access to target calendar, confirm required event fields populated, check API quotas.

Sync Delays

Check internet connectivity, review Google Calendar sync status, verify no calendar conflicts or errors.

Ready to transform your agency?

Start building with Ayra today. No credit card required.