Skip to main content
Your Voice Agent can now book into Cal.com directly through the Appointment Booking skill. You no longer need to build custom Tools to fetch slots and book meetings. This article shows how to connect Cal.com and how to move from the earlier custom-Tools setup.
User level: Admin

Before you start

Make sure you have:
  • a Cal.com cloud account with the event type you want the agent to book already set up (self-hosted Cal.com isn’t supported)
  • Voice Agents enabled on your CloudTalk account
  • Admin access to edit the Voice Agent

Create a Cal.com API key

  1. Log in to Cal.com and go to Settings > Developer > API keys. To book a team event type, log in as a team admin or owner.
  2. Click New, or Create your first API key if you don’t have one yet.
  3. Give the key a name, for example “CloudTalk”, and turn on Never expires so the connection doesn’t break when the key expires. Creating an API key in Cal.com
  4. Click Create, then copy the key. Cal.com shows it only once. If you lose it, delete it and create a new one.

Connect Cal.com in the Appointment Booking skill

  1. Open your Voice Agent and go to Skills.
  2. Click Add next to Appointment Booking, or Edit if the skill is already added.
  3. Choose Cal.com, click Open API keys in Cal.com and create a key and paste your API key. Choosing Cal.com in the Appointment Booking skill Pasting the Cal.com API key in the Appointment Booking skill
  4. Select the event type the agent should book into. To book across a team, choose a round-robin event type, and Cal.com assigns the host. Event types the agent can’t book are greyed out with the reason. See the list of event types the agent can’t book.
  5. Check the invite e-mail setting. It names the variable the calendar invite takes the caller’s email from, and starts as contact.emails, the emails on the caller’s CloudTalk contact. When it’s empty for a call, the agent can’t book an event type that needs an email and texts the caller your scheduling link instead, if you set up the booking-failed SMS. See the caller’s email address.
  6. Review the SMS scenarios for booking confirmations and for bookings that can’t be completed. SMS scenarios for the Appointment Booking skill
  7. Click Save, then make a test call and check that the booking appears in Cal.com.

How bookings work with Cal.com

  • Availability comes from your event type; the agent proposes a few of those slots. Availability, buffers and booking limits are all set in Cal.com.
  • Cal.com assigns the host and, when the booking has an email address, sends the caller the invite.
  • The agent tells the caller the appointment is booked only after Cal.com has created it.
  • The agent never asks the caller for an email address. The invite goes to the address in the invite e-mail variable, by default the email on the caller’s CloudTalk contact. Event types that only ask for a phone number book without an email, and Cal.com sends no confirmation for them: the caller’s only confirmation is CloudTalk’s booking-confirmed SMS, if you set it up.
  • If the booking can’t be made and you set up the booking-failed SMS, the caller gets an SMS with your event type’s scheduling link. Otherwise the agent offers a callback.
  • Each Voice Agent books into one event type. The agent can’t reschedule or cancel bookings, and changes made in Cal.com aren’t synced back to CloudTalk.
  • You can connect more than one Cal.com connection per company, even the same account more than once. Re-enter API key refuses a key that belongs to a different account.
  • If the API key is deleted or expires, the connection asks you to Re-enter API key, and the agent stops booking until you do.
For the full details, see Appointment Booking Skill for Voice Agents.

Move from custom Tools to the native skill

If you set up the get_free_slots and book_meeting Tools from the earlier version of this guide, or connected Cal.com through an automation platform such as Zapier, Make or n8n, that setup keeps working. To switch:
  1. Connect Cal.com in the Appointment Booking skill as described above.
  2. Make a test call and check that the booking appears in Cal.com.
  3. Remove the custom Tools or the automation from the Voice Agent, so the agent books through the skill only.
Your Customer Success manager can help with the move.
This setup used two Tools that work together: one fetches available time slots, and the other books the selected time once the customer confirms.Tool 1: Fetching available time slotsTool 2: Booking the appointment

Need help or have a question? Just reach out through our Support portal — we’re here for you.