Cal.com gives you full control over your scheduling—it's open-source, self-hostable, and packed with features. Your dialnote AI agents can check your Cal.com availability and book meetings directly during phone calls. No more back-and-forth emails or missed opportunities.

What You'll Need#

Before connecting Cal.com to your AI agent, gather these items:

• A Cal.com account (cloud or self-hosted)
• At least one Event Type created in Cal.com
• Your Cal.com API key

Getting Your API Key#

1. Log into your Cal.com account
2. Go to Settings → Developer → API Keys
3. Click Create API Key
4. Give it a name like "dialnote Integration"
5. Set an expiration date (or choose "No expiration")
6. Copy the key immediately—you won't see it again

Your API key connects dialnote to your Cal.com calendar. Treat it like a password.

Creating a Cal.com Tool#

You can add two types of Cal.com tools to your AI agent:

Most agents use both tools together. The agent first checks what times are open, then books the caller's preferred slot.

Adding the Check Availability Tool#

1. Go to Settings → AI Agents and select your agent
2. Click Add Action in the Capabilities section
3. Choose Check Availability
4. Select Cal.com as the provider
5. Enter your Cal.com API key
6. Once validated, select the Event Type you want to use
7. Set your default timezone
8. Click Create Action

When configured, your agent can answer questions like "What times do you have available on Thursday?" by checking your actual Cal.com schedule.

Adding the Book Meeting Tool#

1. Follow the same steps above, but choose Book Meeting
2. After entering your API key and selecting an Event Type, you'll see location options
3. Pick the meeting location callers can use:
   • Cal Video — Cal.com's built-in video conferencing
   • Google Meet — Creates a Meet link
   • Zoom — Generates a Zoom link
   • Microsoft Teams — Creates a Teams link
   • Whereby — Whereby video link
   • Phone — Phone call appointment
   • Ask Attendee — Let the caller choose

How Booking Works#

Here's what happens during a call when someone wants to schedule:

1. Caller asks to book an appointment
2. Agent uses Check Availability to find open slots
3. Agent offers available times to the caller
4. Caller picks a time
5. Agent collects their name and email
6. Agent uses Book Meeting to create the appointment
7. Cal.com sends confirmation emails to both parties

The entire process takes less than a minute. Callers get instant confirmation without callbacks or manual scheduling.

Location Types Explained#

Cal.com supports several meeting formats. Here's what each means for your AI agent:

Troubleshooting#

"Invalid Cal.com API key" Your API key may have expired or been deleted. Generate a new one in Cal.com's Developer settings and update the tool.

"Event type not found" The selected Event Type may have been deleted or deactivated in Cal.com. Go back to the tool settings and select a different Event Type.

"This time slot is no longer available" Someone else booked that slot between when the agent checked and when the caller confirmed. The agent will automatically offer alternative times.

"No event types found" Make sure you have at least one Event Type created in Cal.com. The API key needs to have access to read your event types.

Best Practices#

• Use clear Event Type names — Your agent tells callers what they're booking, so "30 Min Consultation" works better than "Meeting Type 1"
• Set buffer times in Cal.com — Add buffer periods between meetings to avoid back-to-back bookings
• Enable email reminders — Cal.com can send automatic reminders to reduce no-shows
• Test before going live — Use your agent's test mode to try booking a few appointments yourself
• Keep your API key secure — If you think your key was compromised, revoke it and create a new one