Docs · Channels

Connect Cal.com so meetings actually book themselves.

Cal.com owns the hard parts, hours, real cross-calendar busy state, confirmation emails, the meeting link, you don't reconfigure any of that inside Ciela. All Vance needs is an API key and the event type he should book against, then he can ask "does Tuesday at 2 work" mid-call and have the answer be true.

Before you start

What to have ready

The whole thing is one paste, but the event type matters.

A cal.com account. Free or paid both work. Sign up at cal.com if you don't have one.
At least one event type configured. The thing prospects book, e.g. 30-minute discovery call. Make sure the hours, buffer, and conferencing (Google Meet / Zoom) are exactly how you want a real meeting to land.
Calendar connected on cal.com side. Cal.com needs read access to your Google or Outlook calendar so it knows when you're busy. Set this up under cal.com Settings → Calendars before you continue.

Walkthrough

Open the Cal.com card in settings

Head to /dashboard/settings and click Connections. The Cal.com card is right under the Vapi block, click Connect Cal.com to expand the paste field.

Generate a cal.com API key

In a new tab open cal.com Settings → Developer → API keys, click + New, name it ciela, check Never expires, hit Create. Cal.com only shows the full key once, copy it now.

Paste and connect

Paste the key into the Ciela field and click Connect. Ciela validates it, snapshots your event types, and picks the first one as Vance's default. The card flips to show your username, the active event type, and a public booking URL you can share.

If you have more than one event type and the wrong one was picked as default, just click the event-type dropdown on the same card and switch, no reconnect needed.

Verify with a test booking

Click the public booking URL on the connected card, book yourself a slot from another browser or your phone. The confirmation lands in cal.com and on your real calendar inside a couple of seconds, that's the same path Vance will take live during a call.

Common errors

When the connect fails, read this first

Cal.com is forgiving, when it does fail it's almost always one of these.

Invalid API key
The key was pasted wrong or you copied a token from a different cal.com workspace. Regenerate from Settings → Developer → API keys, paste the fresh string, retry.
No event types found
Your cal.com account has zero event types defined yet, Ciela has nothing to book against. Create at least one event type on cal.com, then click Reconnect.
Calendar not connected on cal.com
Cal.com accepted the booking but your real Google or Outlook calendar isn't linked, so the meeting lives only inside cal.com. Open cal.com Settings → Calendars and connect Google or Outlook before launching campaigns.
Booking went through but no Meet link
Cal.com event type is missing a conferencing app. On cal.com, open the event type, scroll to Location, pick Google Meet or Zoom, save. Future bookings will include the link.

What happens next

Once cal.com is connected, Vance gains two tools mid-call, checkAvailability and bookAppointment, both pointed at the chosen event type. He'll only offer slots cal.com says are free, and he won't double-book if a meeting lands on your real calendar between the time he checks and the time he books. If you ever need to switch which event type Vance uses (e.g. swap from a 30-min discovery to a 15-min intro), do it from the same settings card, no reconnect, the switch is live on the next call.

Keep reading

Channels

Cold call setup

Vapi keys, phone number, Gemini, the rest of what Vance needs before he can dial.

Agents

Meet Vance

What Vance does on a real call, when he books, and when he gracefully walks away.

Need help?

Ciela can walk you through any step. Or write to support@ciela.ai and we'll jump on the connection with you.

Ask Ciela