Calendar Integration
Connect Google or Outlook calendars to enable AI-powered appointment booking.
Calendar Integration
Under the Calendar menu item in the sidebar, you connect your Google or Outlook calendar with ScaleTalk. This connection is the prerequisite for your AI agents to book appointments during calls.
Overview
On the Calendar page you can:
- Connect calendars — Link Google or Outlook calendars via OAuth
- View appointments — Display all booked appointments in the calendar view
- Manage connections — Disconnect or renew calendar connections
Connecting Your Calendar
Google Calendar
- Navigate to Calendar in the sidebar
- Click Connect Google Calendar
- Sign in with your Google account
- Grant ScaleTalk permission to access your calendar
- Select which calendars to sync
For a detailed guide, see Google Calendar Setup.
Permissions
ScaleTalk only accesses calendar data necessary for scheduling. We never read event details beyond what is needed for availability checking.
Microsoft Outlook
- Navigate to Calendar in the sidebar
- Click Connect Outlook Calendar
- Sign in with your Microsoft account
- Grant ScaleTalk permission to access your calendar
- Select which calendars to sync
For a detailed guide, see Outlook Calendar Setup.
Personal Context Only
Calendar connections are made in your personal context. Switch to personal context (not a User Group) before connecting your calendar.
Calendar View
After connecting, the Calendar page shows:
- Upcoming appointments in the "Today" section
- Monthly calendar view with all appointments
- Switch between Month, Week, and Day using the buttons in the top right
Use the arrow buttons and the Today button to navigate between dates.
Booked Appointments
Appointments booked by your agent appear in your calendar with:
- Event title (e.g., "AI Booking: John Smith")
- Caller information
- Notes from the conversation
Calendar Sync
Calendar changes sync in real time:
- New appointments appear immediately
- Cancellations free up time slots
- Changes to existing appointments update availability
Next Steps
After connecting your calendar here, you still need to activate and configure it in the Agent Configurator:
- Go to Agents → select your agent → Capabilities tab
- Create a calendar assignment with an appointment condition
- Define appointment duration, buffer time, and description in the system prompt
Calendar Tools in the Agent
Create calendar assignments and learn which details need to be defined in the prompt.
Appointment Types
Set up different appointment types with prompt examples for duration, buffer, and description.
Disconnecting
To disconnect a calendar connection:
- Navigate to Calendar in the sidebar
- Click the red text button (Disconnect Google or Disconnect Outlook)
- The connection is removed immediately
Active Agents
If agents use the calendar tools with this calendar, disconnecting will disable their appointment scheduling capability. Update those agents before disconnecting.
Troubleshooting
Calendar Not Syncing
- Check your calendar connection status
- Re-authenticate if the connection has expired
- Verify calendar permissions
- Contact support if issues persist
Double Bookings
To prevent double bookings:
- Add buffer time between appointments (in the calendar tool configuration)
- Ensure all relevant calendars are connected
Time Zone Issues
- Verify your time zone settings in ScaleTalk
- Check your calendar app's time zone
- Test with a known time to confirm accuracy