Skip to main content
If your calendar integration isn’t working as expected — appointments aren’t showing up, your assistant can’t check availability, or you’re seeing authorization errors — this guide covers the most common issues and how to fix them.

​
Calendar Not Connected or Shows Disconnected

Symptoms: Your assistant can’t book appointments, or the Integrations page shows your calendar as disconnected even though you previously connected it. Solutions:
  1. Check the integration status. Go to Integrations in the sidebar and find your calendar provider (Google Calendar, Calendly, or Cal.com). Look for a green “Connected” badge. If it shows disconnected, you’ll need to reconnect.
  2. Reconnect your calendar. Click on the calendar integration card and follow the connection steps again. For Google Calendar and Calendly, this means going through the OAuth sign-in flow. For Cal.com, you’ll need to re-enter your API key.
  3. Check if the token expired. Calendar tokens can expire over time, especially for Google Calendar and Calendly. When this happens, the integration silently disconnects. Reconnecting generates a fresh token.
Tip: After reconnecting, test the integration by placing a call to your VozAgent number and asking about scheduling. This confirms the assistant can read your calendar in real time.

​
Google Calendar Issues

​
”Failed to initiate Google Calendar connection”

This error appears when the OAuth handshake with Google fails. Solutions:
  1. Try again in a few seconds. This is often a temporary network issue.
  2. Refresh the page and attempt the connection again.
  3. Make sure pop-ups are allowed. Some browsers block the redirect to Google’s sign-in page. Allow pop-ups for the VozAgent domain.
  4. Clear your browser cache. Stale cached data can interfere with the OAuth flow. Try a hard refresh (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows).

​
Google Asks to Re-Authorize Permissions

If Google prompts you to grant permissions again after you previously connected, this is normal. It happens when:
  • You disconnected and are reconnecting
  • Google revoked the token due to inactivity or a security policy change
  • You changed your Google account password
Simply review the permissions and click Allow to reconnect.

​
Appointments Not Appearing on Google Calendar

If your assistant books an appointment during a call but it doesn’t appear on your Google Calendar:
  1. Verify the connection is still active. Go to Integrations > Google Calendar and check for the green “Connected” badge.
  2. Check the correct calendar. If you have multiple Google Calendars (personal, work, shared), the appointment may be on a different calendar than the one you’re viewing.
  3. Wait a moment. There can be a short delay (up to 30 seconds) between when the appointment is booked and when it appears on Google Calendar.
  4. Refresh Google Calendar. In the Google Calendar web app, try refreshing the page or pressing “R” to reload events.

​
Calendly Issues

​
No Event Types Showing After Connection

If you connected Calendly but VozAgent doesn’t show any event types:
  1. Check your Calendly account. Make sure you have at least one active event type configured. Inactive or archived event types won’t appear in VozAgent.
  2. Disconnect and reconnect. Go to Integrations > Calendly, disconnect, then reconnect. This forces VozAgent to re-import your event types.

​
Calendly Sync Delays

Calendly appointments may take a short time to sync back to VozAgent.
  1. Wait 1-2 minutes. Calendly sends booking notifications through webhooks, which may have a slight delay.
  2. Check the VozAgent Calendar page. Go to Calendar in the sidebar and look for the appointment. It should appear with a “calendly” provider badge.
  3. Verify the booking was created. Log in to your Calendly dashboard and confirm the appointment exists there.

​
OAuth Callback Error

If you see an error after being redirected back from Calendly:
  1. Try the connection process again. Close the error and start a new connection from the Integrations page.
  2. Make sure you’re not blocking redirects. Check your browser settings for pop-up or redirect blockers.
  3. Try a different browser. If the issue persists in one browser, try Chrome, Firefox, or Safari.

​
Cal.com Issues

​
”Invalid API key” or “Failed to validate API key”

This means VozAgent couldn’t authenticate with Cal.com using the key you provided. Solutions:
  1. Check for extra spaces. When copying the API key, make sure no spaces were accidentally added before or after the key.
  2. Verify the key is still valid. Log in to Cal.com and go to Settings > Developer > API Keys. Make sure the key hasn’t been revoked or expired.
  3. Generate a new key. If the existing key doesn’t work, create a new API key in Cal.com and try connecting again.

​
”Failed to connect Cal.com”

This can happen when:
  • Your Cal.com account doesn’t have any event types set up
  • The API key has been revoked
  • Cal.com is experiencing an outage
Solutions:
  1. Check your Cal.com event types. Make sure you have at least one active, published event type.
  2. Generate a fresh API key. Go to Cal.com’s Settings > Developer > API Keys, create a new key, and use it in VozAgent.
  3. Check Cal.com’s status. Visit Cal.com’s status page to see if there are any ongoing service issues.

​
No Event Types Appearing After Key Validation

If the test passes but no event types show in the dropdown:
  1. Verify your event types are published. Go to your Cal.com dashboard and make sure your event types are published and not in draft mode.
  2. Check that event types are active. Disabled event types won’t appear in VozAgent.

​
Appointments Not Showing on the VozAgent Calendar

Symptoms: Your assistant confirms it booked an appointment during a call, but the appointment doesn’t appear on the VozAgent Calendar page. Solutions:
  1. Check the date range. The Calendar page shows appointments for the currently displayed date range. Use the navigation arrows or click Today to make sure you’re viewing the correct period.
  2. Switch to the correct view. If you’re in Month view, the appointment may be a small dot on the day. Switch to Week or Day view for a more detailed look.
  3. Verify the calendar connection. If the integration was disconnected between when the call happened and when you’re checking, the appointment may not have synced.
  4. Refresh the page. Calendar data refreshes automatically, but a manual page refresh can help if data appears stale.
  5. Check the appointment in your calendar provider. Log in to Google Calendar, Calendly, or Cal.com directly and verify the appointment exists there. If it does but doesn’t appear in VozAgent, there may be a sync delay.

​
General Tips

  • Reconnect periodically. If you notice calendar issues after a long period without changes, try disconnecting and reconnecting your calendar. This refreshes the authentication token.
  • Only one calendar provider at a time. VozAgent connects to one calendar provider per organization. If you switch from Google Calendar to Calendly (or vice versa), the previous connection is replaced.
  • Check your availability settings. Even if the calendar is connected, your assistant uses the availability hours you configured during setup. Make sure those hours match your actual schedule. See Booking Settings and Availability.

​
Next Steps