Cal.com Integration

Cal.com is a tool that shows when you're free and lets people book time with you. With this integration, your AI agent can check your open times and book an appointment while the caller is still on the phone. 📅

You only set this up once for your company. After that, any agent you turn "appointment booking" on for will use it.

---

What You'll Need

• A Cal.com account.
• A Cal.com API key (you get this inside Cal.com).
• At least one Event Type in Cal.com (like "30-minute consult").

---

Step 1 — Connect Cal.com to Kayse AI

1. In Kayse AI, open Company Settings → Integrations.
2. Find the Scheduling card and click Connect.
3. Paste your Cal.com API key and click Save.
4. You should see a green Connected badge on the card. ✅

That's it — every agent in your company can now share this one key.

Encrypted and Safe

Your key is encrypted and hidden in the app. Even admins see it masked.

---

Step 2 — Turn Booking On for an Agent

Once your scheduling integration is connected, open any agent and switch on appointments.

In the Agent Builder

1. Open the agent in Agent Builder.
2. Scroll to the Capabilities section.
3. Toggle on Appointments.
4. A small dialog opens. Type in your Event Type ID.
5. Save the agent.

In the Agent Builder Wizard

1. Start (or edit) an agent in the Wizard.
2. On the review step, toggle Appointment Booking on.
   • If you don't see the toggle, your company doesn't have the Scheduling integration connected yet — do Step 1 above.
3. Add your Event Type ID.
4. Finish the wizard.

That's all you need — no separate key per agent.

---

How to Find Your Event Type ID

The Event Type ID tells Cal.com which kind of appointment to book. Each event type (for example, a 30-minute intake call) has its own number.

1. Log in to Cal.com.
2. Click Event Types in the left menu.
3. Click the event you want the AI to book.
4. Look at the URL in your browser. It ends in /event-types/<number>.
5. The number at the end is your Event Type ID.

Example

If the URL is:

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

Then your Event Type ID is 1427703.

Paste that number into the Kayse AI agent settings.

---

What Happens on a Call

When a caller asks to book a time, your AI agent:

1. Checks Cal.com for real open time slots.
2. Shares a few real options with the caller (it never makes up times).
3. Repeats the date, time, and time zone out loud to confirm.
4. Books the appointment in Cal.com once the caller says yes.

Your company time zone is used by default. Set your company time zone in Company Settings → Company Info so bookings land at the right local time.

---

How to Update or Disconnect

Need to swap keys or turn this off?

1. Open Company Settings → Integrations → Scheduling.
2. Click Settings to update your key, or Disconnect to remove it.

If you disconnect, agents that had booking turned on will stop being able to book until a new key is added. Your other agent settings stay the same. ✅

---

Troubleshooting

"Cal.com integration is missing" warning. Connect the Scheduling integration in Company Settings → Integrations → Scheduling.

The AI can't find any open times.

• Double-check the Event Type ID is right.
• Open Cal.com and make sure the event type is active.
• Make sure your Cal.com calendar has availability in the next few days.

Appointments show up at the wrong time. Your company time zone and your Cal.com event type time zone must match. Check both and update either one if needed.

---

Want to Send Bookings to GoHighLevel?

If you use GoHighLevel (GHL / LeadConnector), you can also send bookings made by Kayse AI into your GHL calendar using Zapier. See the full guide here: How Kayse AI Books Appointments and Sends Them to GHL.