Appointment Booking

Let your AI agent check availability and book appointments through Cal.com while the caller is still on the line. 📅

Prerequisites

Before enabling appointment booking on an agent, you need a Cal.com API key configured at the company level.

1. Go to Company Settings → Integrations → Scheduling
2. Enter your Cal.com API key and save

All agents in your company share this key — you only need to set it once.

Enabling Appointment Booking

In Agent Builder, open the Capabilities panel and toggle on Appointments. Once enabled, a settings dialog will appear where you configure the Event Type ID.

Finding the Event Type ID

The Event Type ID is the numeric identifier for a specific Cal.com event type (e.g. a 30-minute consultation, an intake call). Each event type has a unique ID.

Steps to find it:

1. Log in to your Cal.com account
2. Click Event Types in the left sidebar
3. Click the event type you want to use for appointment booking
4. Look at the URL in your browser's address bar — it ends with /event-types/<number>
5. The number at the end is your Event Type ID

Example:

If the URL in your browser is:

https://app.cal.com/event-types/1427703

Then the Event Type ID is 1427703.

Enter this number in the Event Type ID field in the agent's appointment booking settings.

How the Agent Books Appointments

When appointment booking is enabled, the agent follows a strict flow to ensure accurate bookings:

1. Checks availability — queries Cal.com for real open slots before offering any times to the caller
2. Presents real options — never invents or assumes available times
3. Confirms with the caller — repeats the exact date, time, and timezone before booking
4. Books only after confirmation — submits the booking to Cal.com once the caller agrees

TIP

The agent uses the company timezone by default for all bookings. Make sure your Cal.com event type timezone matches your company timezone to avoid scheduling mismatches.

Troubleshooting

Issue	Solution
"Cal.com integration is missing" warning	Add your Cal.com API key in Company Settings → Integrations → Scheduling
Agent cannot find available slots	Check that the Event Type ID is correct and the event type is active in Cal.com
Appointments booked in the wrong timezone	Verify your company timezone in Company Settings matches your Cal.com event type timezone