Skip to main content

​
Overview

The Google Calendar integration gives your agent direct access to check free/busy times and create calendar events. When a lead is ready to book, the agent finds available slots and creates the appointment — no booking links needed.

​
Connect Google Calendar

1

Open integrations

Go to your agent’s Integrations page.
2

Click Connect

Click Connect next to Google Calendar. You’ll be redirected to Google’s OAuth consent screen.
3

Authorize access

Grant SetterMaxer AI permission to read and write your calendar events.
4

Select a calendar

Choose which calendar the agent should use for availability checking and booking. You can optionally use a shared team calendar.

​
How it works

The agent uses three capabilities: The agent can only offer times the availability check returned. All times are in the agent’s timezone: a booking time is always read as the agent’s local time, even if the AI attaches a UTC marker or offset to it. Change the timezone in the agent settings, not in the prompt script. If two leads try to book the same time at the same moment, only one gets it; the other is offered the nearest open times instead. When an appointment is created:
  • The event appears on your Google Calendar, with the video call link you chose (Google Meet, Zoom or Microsoft Teams)
  • The lead receives a confirmation message in the chat with the date, time and video-call link, plus the calendar invitation by email
  • The conversation is marked as appointment_booked = true
  • A appointment.booked webhook event is fired (if configured)
If you delete or move the event in Google Calendar, SetterMaxer notices the next time the lead writes: a deleted event marks the appointment as cancelled (the lead can book again), a moved one updates the appointment time.

​
Reschedule an appointment

After the agent books a Google Calendar appointment, the lead can ask for another date or time in the same conversation. The agent checks the requested time, updates the original event, and confirms the new appointment time.
  • The original invitation and video call link are preserved.
  • Google sends attendees an updated calendar notification.
  • SetterMaxer updates the conversation’s appointment details.
  • An appointment.rescheduled webhook event is fired (if configured).
Appointments created before rescheduling support was enabled do not contain the Google event identifier required for a safe update. Those existing appointments must be changed directly through Google Calendar.

​
Video call

Choose under Video call in the Google Calendar drawer what every booking gets:
  • Google Meet (default): a new Meet link for each booking.
  • Zoom or Microsoft Teams: one meeting link you provide, such as your Zoom Personal Meeting ID link or a recurring Teams meeting. It is added to the event’s location and description and sent to the lead, and the agent refers to the meeting as a Zoom or Teams call.
  • No video call: bookings are made without a link.
The Microsoft Teams add-on for Google Calendar only works when you add a meeting by hand in Google Calendar; it cannot add Teams links to events the agent creates. Choose Microsoft Teams and paste the link of a recurring Teams meeting instead.

​
Booking rules

Set these in the Google Calendar drawer on the agent’s Integrations page.

​
Token management

SetterMaxer automatically refreshes your Google OAuth tokens. If a refresh fails, you’ll need to reconnect the integration.
Make sure your prompt script mentions calendar booking so the AI knows when to check availability. If the prompt doesn’t reference scheduling, the agent won’t attempt to book.