What You Get
Once connected, your AI assistant can:- Check real-time availability — Your assistant queries your live Cal.com calendar during calls.
- Book appointments instantly — Appointments are created directly through Cal.com without back-and-forth scheduling.
- Send automatic confirmations — Both you and the caller receive confirmation emails when an appointment is booked.
- Sync across calendars — Cal.com works with Google Calendar, Outlook, and other calendars you’ve connected within Cal.com itself.
Prerequisites
Before you begin, make sure you have:- An active Cal.com account with at least one event type configured.
- Access to your Cal.com API key (we’ll show you where to find it below).
- You are logged in to VozAgent.
Getting Your Cal.com API Key
- Log in to your Cal.com account.
- Go to Settings > Developer > API Keys (direct link: app.cal.com/settings/developer/api-keys).
- Click Create new API key.
- Give it a name like “VozAgent” so you remember what it’s for.
- Copy the generated key. It will look something like
cal_live_xxxxxxxxxxxxx.
Important: Keep your API key secure. Don’t share it publicly. You can revoke it from Cal.com at any time if needed.
Connecting During Assistant Setup
The quickest way to connect Cal.com is during the assistant creation wizard:- In the Set up appointment booking step, turn on the Appointment Booking toggle.
- You’ll see four calendar provider buttons. Click Cal.com.
- A text field labeled Cal.com API Key appears. Paste your API key.
- Click the Connect Cal.com button.
- VozAgent validates your API key by contacting Cal.com. If the key is valid, you’ll see a success message: “Cal.com connected!”
- A green checkmark with “Connected to Cal.com” confirms the connection is active.
- 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 Cal.com afterward:- Navigate to Integrations in the sidebar.
- Find the Cal.com card and click on it to open the Cal.com integration page.
- The page shows a Connection Status card. Click Connect Cal.com.
-
A dialog opens with two steps:
- Enter your API key — Paste your Cal.com API key into the field.
- Test the key — Click Test API Key to validate it. VozAgent will contact Cal.com and verify the key works. On success, you’ll see a message like “API key validated. Found 3 event type(s)”.
- Select an event type (optional) — After the key is validated, a dropdown appears listing your Cal.com event types with their names and durations (e.g., “30 Min Meeting (30 min)”). Pick the event type you want to use for bookings, or leave it unselected to use your default.
- Click Connect Cal.com to save the connection.
- The integration page updates to show a green “Connected” badge and the name of your selected event type.
Updating Your Settings
After connecting, you can update your Cal.com settings without disconnecting:- Go to Integrations > Cal.com.
- Click the Update Settings button.
- The connection dialog opens with your current API key pre-filled. You can change the API key or select a different event type.
- Click Connect Cal.com to save your changes.
How the Booking Flow Works
When your Cal.com account is connected and a caller asks to schedule an appointment, here’s what happens:- Caller requests an appointment — The caller asks about scheduling during the call.
- Assistant checks availability — Your assistant queries your Cal.com calendar in real time.
- Slots are offered — Available time slots are presented to the caller.
- Appointment is confirmed — The booking is created on your Cal.com calendar and confirmation emails are sent to both you and the caller.
Disconnecting Cal.com
If you need to disconnect your Cal.com account:- Go to Integrations in the sidebar and click Cal.com.
- Click the Disconnect button (shown in red).
- A confirmation dialog will appear: “Your assistants will no longer be able to check availability or book appointments. You can reconnect at any time.”
- Click Disconnect to confirm.