Skip to main content
Google Calendar is the most popular calendar integration for VozAgent users. It connects through a secure OAuth flow — you sign in with your Google account, grant permission, and you’re done. No API keys or technical setup required.

​
What You Get

Once connected, your AI assistant can:
  • Check real-time availability — Your assistant queries your live Google Calendar during calls to see when you’re free.
  • Support multiple calendars — If you have several Google Calendars (personal, work, team), availability is checked across all of them.
  • Book appointments instantly — Appointments are created directly on your Google Calendar in real time during the call.
  • Send automatic invites — Calendar invites are sent to callers automatically when an appointment is booked.

​
Prerequisites

Before you begin, make sure you have:
  • A Google account with Google Calendar enabled (any Gmail or Google Workspace account works).
  • You are logged in to VozAgent.

​
Connecting During Assistant Setup

The quickest way to connect Google Calendar is during the assistant creation wizard:
  1. In the Set up appointment booking step, turn on the Appointment Booking toggle.
  2. You’ll see four calendar provider buttons. Click Google Calendar.
  3. Click the Connect Google Calendar button that appears.
  4. You’ll be redirected to Google’s sign-in page. Sign in with the Google account whose calendar you want to use.
  5. Google will ask you to grant VozAgent permission to view and manage your calendar events. Review the permissions and click Allow.
  6. You’ll be redirected back to VozAgent. A success message confirms “Google Calendar connected!” and you’ll see a green checkmark showing the connection is active.
  7. Continue with the rest of the wizard to configure your availability hours and appointment settings.

​
Connecting from the Integrations Page

If you’ve already created your assistant and want to connect Google Calendar afterward:
  1. Navigate to Integrations in the sidebar.
  2. Find the Google Calendar card and click on it to open the Google Calendar integration page.
  3. The page shows a Connection Status card. Click Connect Google Calendar.
  4. Follow the same Google sign-in and permission flow described above.
  5. Once connected, the page updates to show a green “Connected” badge and your Google account email address.

​
How the Booking Flow Works

When your Google Calendar is connected and a caller asks to schedule an appointment, here’s what happens:
  1. Caller requests an appointment — The caller asks about scheduling during the call.
  2. Assistant checks availability — Your assistant queries your Google Calendar in real time to find open slots.
  3. Slots are offered — Available times are presented to the caller based on your configured availability hours and existing calendar events.
  4. Appointment is confirmed — The selected time is booked on your Google Calendar and the caller receives a confirmation.

​
Viewing Google Calendar Appointments

Appointments booked through Google Calendar appear on your VozAgent Calendar page. Click any event to see the full details including:
  • Appointment time and duration
  • Contact name, phone, and email
  • A “View in Google Calendar” link that opens the event directly in Google Calendar
See Calendar & Booking Overview for more on using the Calendar page.

​
Disconnecting Google Calendar

If you need to disconnect your Google Calendar:
  1. Go to Integrations in the sidebar and click Google Calendar.
  2. Click the Disconnect button (shown in red).
  3. A confirmation dialog will appear: “Your assistants will no longer be able to check your Google Calendar availability. You can reconnect at any time.”
  4. Click Disconnect to confirm.
Your assistants will stop checking your Google Calendar for availability. Any previously booked appointments remain on your Google Calendar — they are not deleted. You can reconnect at any time by following the connection steps above.

​
Troubleshooting

​
”Failed to initiate Google Calendar connection”

This usually means there was a network issue or a problem with the authentication request. Try again in a few seconds. If the problem persists, make sure you’re logged in to VozAgent and try refreshing the page.

​
Google asks for permissions again

If you previously connected and disconnected, Google may ask you to re-authorize VozAgent. This is normal. Grant the requested permissions to reconnect.

​
Appointments not showing up

If booked appointments aren’t appearing on your VozAgent Calendar page, make sure:
  • Your Google Calendar connection is still active (check the Integrations page for a green “Connected” badge).
  • The appointment was booked after the connection was established — previously existing events are not imported.