Setup Guide

Set up Cal.com Integration

In this guide you'll learn how to connect Cal.com with your BitPalm AI agent so it can automatically book appointments for your customers.

01

Create a Cal.com Account

If you don't have one yet, create a free account at cal.com.

Cal.com offers a generous free plan that works with BitPalm.

02

Create an Event Type

In your Cal.com dashboard, create the event type you want your agent to offer (e.g. "30-Minute Consultation"). Configure the duration and availability.

You can set duration, availability, and buffer times directly in Cal.com.

03

Generate an API Key

Go to Settings → Developer → API Keys and create a new API key.

Keep your API key safe — you'll need it in the next steps.

04

Find Your Event Type ID

In Cal.com, go to Event Types and open the event you want to use. Copy the ID from the URL — it's the number at the end.

Example URL: https://app.cal.com/event-types/123456
Event Type ID: 123456

The Event Type ID is the number at the end of the URL when viewing your event type.

05

Configure in BitPalm Dashboard

Open your BitPalm Dashboard, go to your agent's Settings > Tools and find "Book Appointment (Cal.com)".

Paste your API key in the Calcom Api Key field and your Event Type ID in the Calcom Event Type Id field, then click "Save Config".

Then check the box to enable the tool.

Your credentials are stored securely with AES-256 encryption.
06

Test the Integration

Open your agent's Playground and test the booking flow. For example:

"I'd like to book a consultation"
"Can I schedule a meeting for next week?"

The agent will use the Cal.com API to check availability and create bookings directly.

Bookings are tracked in the Appointments tab of your agent dashboard.