> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Book meetings on Cal.com from your AI agent

> Let customers check your availability and book meetings on your Cal.com calendar without leaving the chat

The Cal.com Action lets your Chatbase AI agent show live availability from one of your Cal.com events and book a meeting inside the conversation. The customer picks a date and time in a slot picker, fills in your event's booking form, and the booking is created on your Cal.com calendar without leaving the chat. It works on the **Chat Bubble**, **Help Page**, and **Center Stage**.

> [card] Best for:
>
> Booking demos, consultations, and support calls without sending the customer off to a separate scheduling page.

**Common Use Cases:**

* "I'd like to book a call"
* "What times are you free this week?"
* "Can I schedule a demo for Thursday?"

> [!NOTE]
>
> **No integration required.** Cal.com works from your event URL alone, so you don't need to connect anything under **Integrations**. If you use [Calendly](https://chatbase.co/docs/user-guides/chatbot/actions/calendly.md) instead, that one does require an integration.

## How it works

1. The customer asks to book a meeting. Based on your **When to use** instructions, the AI agent calls the Action and picks a search window. By default, the window runs from today to 28 days later.
2. A slot picker card appears in the chat. The customer picks a date, then a time. Times are shown in the customer's browser time zone.
3. The customer fills in the booking form. It shows your Cal.com event's own booking questions. If the event returns none, the form asks for name and email.
4. If your Cal.com event requires email verification, Cal.com emails the customer a 6-digit code, which they enter in the form.
5. Chatbase creates the booking through Cal.com, and the card confirms: "Your appointment has been booked successfully on {date} at {time}".

The AI agent never sees the individual times. It only learns whether slots were found and whether a booking was made, and it's told never to list times or booking links in its own reply, because the picker already shows them.

### Example

An example conversation on the Chat Bubble:

> **Customer:** Can I book a demo next week?
>
> **AI agent:** I have found available slots. Pick a time that works for you below.
>
> *(The slot picker opens. Jane Doe picks Tuesday at 10:00, enters [jane@example.com](mailto:jane@example.com), and submits.)*
>
> **Card:** Your appointment has been booked successfully on Tuesday at 10:00.

## How to create the Action

**1. Navigate to Actions**

Go to your [Chatbase dashboard](https://www.chatbase.co/dashboard/) and select your AI agent. Click **Build > Actions** in the left sidebar.

**2. Create the Action**

Click **Create Action**, select the **Cal** card, then choose **Retrieve and book slots** and click **Start customizing**. The editor opens with the header **Cal.com get available slots**.

**3. Configure General Settings**

**Action Name:** Give the Action a descriptive name. The AI agent uses this name to help decide when the Action applies, so make it specific.

**When to use:** Describe when the Action should be triggered and the kind of customer queries that should trigger it. See [Examples](#examples) below.

To restrict the Action to [Procedure](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md) steps only, turn on [**Only use in Procedures**](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#only-use-in-procedures). When it's on, the **When to use** field is hidden, because the AI agent no longer decides when to call the Action.

**4. Add your Cal.com Event URL**

Enter your event URL in the **Cal.com Event URL** field, for example `https://cal.com/jane-doe/30min`. This tells the Action which event to make bookings into. See [Supported event links](#supported-event-links) for which URLs work.

![The Cal.com Event URL field in the Action configuration](https://mintcdn.com/chatbase/EhvCUQ4ZmSlhciUK/user-guides/chatbot/images/actions/actions-46.png?fit=max\&auto=format\&n=EhvCUQ4ZmSlhciUK\&q=85\&s=0475ccb458d8a9b2bf1f8517c8a97a67)

**5. Choose Channels**

This Action is compatible with the **Chat Bubble**, **Help Page**, and **Center Stage** channels only. Every other channel is incompatible and can't be selected. Toggle it on or off for each configured channel. See [Channels](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#channels) for what configured, unconfigured, and incompatible mean.

**6. Enable and Test**

Ensure the Action is toggled to **Enabled**, then test it.

## Settings

**Time format:** You can display Cal.com meeting times in a **12-hour format (AM/PM)** instead of the default 24-hour format.

> [!TIP]
>
> Test the Action by asking your AI agent to book an appointment, and confirm the booking appears on your Cal.com calendar.

![The AI agent showing Cal.com slots and booking a meeting in chat](https://mintcdn.com/chatbase/DIWSTyTSabxfVW3B/user-guides/chatbot/images/actions/actions-47.gif?s=a20f577135e6ec0f83396f0deab9de9d)

## Supported event links

The event URL must be a personal event link on `cal.com` itself, such as `https://cal.com/jane-doe/30min`. These don't work:

* Self-hosted Cal.com instances and custom domains
* Team links (`cal.com/team/...`)
* Group links that combine several users (`cal.com/jane-doe+john-doe/...`)

Required booking questions work when they use one of these field types: text, textarea, number, email, phone, address, name, url, select, multiselect, radio, checkbox, boolean, or multiemail. Hidden fields and the `location` field aren't shown in the chat form. If one of those is required on your event, Cal.com rejects the booking with "Please ensure all information is correct…".

## Examples

Use these as starting points for the **When to use** field:

```text theme={null}
Call this action when the user mentions that he/she wants to book an appointment.
```

```text theme={null}
Check if the user booked an appointment or not from the tool result.
```

## Troubleshooting

> [accordion] The card shows "No slots found."
>
> The event has no free time in the searched window, or every slot in it has already passed. The AI agent says the window has no availability and offers a wider or later date range. Check your availability in Cal.com, or ask for a later date.

> [accordion] The card shows "Something went wrong. Please try again."
>
> Cal.com returned an error or couldn't find the event, for example because the event slug in the URL is wrong or the event was deleted. Check that the **Cal.com Event URL** opens your booking page and is a [supported event link](#supported-event-links).

> [accordion] The booking fails with "Please ensure all information is correct…"
>
> Your event has a required field the chat form can't show, such as a hidden field or `location`. Make that field optional in Cal.com, or remove it.

## Best Practices

> [card] Clear Action Triggers
>
> Write a specific **When to use** description so the AI agent knows exactly which requests should open the booking flow. Include example phrases customers actually type.

> [card] Use a Descriptive Name
>
> The Action name helps the AI agent understand what the Action does. Name it for the meeting type, such as `Book_Demo` or `Book_Support_Call`.

> [card] Confirm the Outcome
>
> Instruct the AI agent to check the tool result and tell the customer whether the booking went through, rather than assuming it did.

> [card] Test Thoroughly
>
> Test the Action with several phrasings before going live, and verify each booking lands on the right Cal.com event.

## Frequently asked questions

> [accordion] Is the meeting booked inside the chat?
>
> Yes. The customer picks a slot and fills in the booking form in the chat, and Chatbase creates the booking on your Cal.com calendar. The customer fills in the form themselves; the AI agent doesn't collect their name or email.

> [accordion] Which time zone are the slots shown in?
>
> The customer's browser time zone.

> [accordion] How far ahead does it search for slots?
>
> The AI agent picks the search window. By default it's today to 28 days later. You can steer it in **When to use**, for example by telling it to search the next 7 days when the customer gives no date.

> [accordion] Can I use a team event or a self-hosted Cal.com?
>
> No. Only personal event links on `cal.com` work. Team links, group links, custom domains, and self-hosted Cal.com aren't supported.

> [accordion] Why doesn't the AI agent list the available times in its reply?
>
> The slot picker card shows them, so the AI agent doesn't list times or booking links in its reply.

> [accordion] Does Cal.com work on WhatsApp or other messaging channels?
>
> No. The slot picker only works on the **Chat Bubble**, **Help Page**, and **Center Stage**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.