Skip to main content
If you already use Calendly to manage your scheduling, you can connect it to VozAgent so your AI assistant can check your availability and help callers book during phone calls. The connection uses a secure OAuth flow — you sign in with your Calendly account and authorize VozAgent.

​
What You Get

Once connected, your AI assistant can:
  • Check real-time availability — Your assistant queries your live Calendly availability during calls.
  • Support multiple event types — If you have different meeting types set up in Calendly (e.g., “15-Minute Consultation”, “1-Hour Service Call”), VozAgent sees them all and shows their names and durations.
  • Generate scheduling links — Your assistant can provide callers with a personalized Calendly booking link to complete the appointment.
  • Send appointment notifications — You receive notifications when appointments are booked or cancelled through Calendly.

​
Prerequisites

Before you begin, make sure you have:
  • An active Calendly account with at least one event type configured.
  • You are logged in to VozAgent.

​
Connecting During Assistant Setup

The quickest way to connect Calendly 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 Calendly.
  3. Click the Connect Calendly button that appears.
  4. You’ll be redirected to Calendly’s authorization page. Sign in with your Calendly account if prompted.
  5. Calendly will ask you to authorize VozAgent to access your account. Review the permissions and click Allow (or Authorize).
  6. You’ll be redirected back to VozAgent. A success message confirms “Calendly connected!” and you’ll see a green checkmark with “Connected to Calendly” displayed.
  7. Continue through the wizard to set your availability hours and appointment duration.

​
Connecting from the Integrations Page

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

​
Event Types

After connecting, VozAgent automatically imports your Calendly event types. You’ll see them listed on the Calendly integration page under Available Event Types, each showing its name and duration in minutes (e.g., “30 Min Meeting (30 min)”). Your assistant uses these event types to understand what kinds of appointments you offer and how long they last.

​
How the Booking Flow Works

When your Calendly account 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 Calendly availability in real time.
  3. Slots are offered — Available times are presented to the caller.
  4. Booking link is sent — The caller receives a personalized Calendly link to complete the booking, or the appointment is booked directly depending on your configuration.

​
Viewing Calendly Appointments

Appointments booked through Calendly appear on your VozAgent Calendar page alongside appointments from other providers. Click any event to see the full details. The provider badge on each event shows “calendly” so you can easily tell which appointments came from Calendly versus other calendar integrations. See Calendar & Booking Overview for more on using the Calendar page.

​
Disconnecting Calendly

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

​
Troubleshooting

​
”Failed to initiate Calendly connection”

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

​
No event types showing after connection

Make sure you have at least one active event type configured in your Calendly account. Inactive or archived event types won’t appear in VozAgent.

​
OAuth callback error

If you see an error after being redirected back from Calendly, try the connection process again. Make sure you’re not blocking pop-ups or redirects in your browser.