> ## 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 Calendly from your AI agent

> Let customers see your Calendly availability in the chat and pick a slot to book on Calendly

The Calendly Action lets your Chatbase AI agent show live availability from one of your Calendly event types in the chat. The customer picks a date and time in a slot picker, and Calendly's own scheduling page opens in a new tab for that slot so they can finish the booking. It works on the **Chat Bubble**, **Help Page**, and **Center Stage**, and needs the Calendly integration, which needs a paid plan.

> [card] Best for:
>
> Showing open times for demos, consultations, and support calls right in the conversation, so customers go straight to the slot they want.

**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]
>
> **Prerequisite:** Before using the Calendly Action, connect your Calendly account from the **Integrations** tab. If you'd rather not set up an integration, [Cal.com](https://chatbase.co/docs/user-guides/chatbot/actions/cal.md) works from an event URL alone, and it books the meeting inside the chat.

## 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. A start date in the past is moved to now.
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. Picking a time opens Calendly's scheduling page for that slot in a new tab. The customer completes the booking there.
4. The card in the chat then reads "You attempted to book a slot at {time} on {date}."

The AI agent never sees the individual times, and Chatbase doesn't learn whether the customer finished booking on Calendly. That's why the AI agent may only say the customer *attempted* to book.

### Example

An example conversation on the Chat Bubble:

> **Customer:** Can I book an essay feedback session next week?
>
> **AI agent:** I have found available slots between Monday and Friday. Pick a time below.
>
> *(Jane Doe picks Wednesday at 14:00. Calendly opens in a new tab, where she confirms the booking.)*
>
> **Card:** You attempted to book a slot at 14:00 on Wednesday.

## How to create the Action

**1. Connect Calendly**

Go to the **Integrations** tab and connect your Calendly account.

**2. 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.

**3. Create the Action**

Click **Create Action**, then select **Calendly Get Slots**.

**4. 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. You can also add instructions the AI agent should follow once the Action runs. 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.

**5. Select your event**

Choose the event you want the AI agent to show slots for from the **Event** dropdown. It lists the active event types of the connected Calendly user, by name (the first 100). If none are active, it shows "No events found".

![Selecting a Calendly event in the Action configuration](https://mintcdn.com/chatbase/EhvCUQ4ZmSlhciUK/user-guides/chatbot/images/actions/actions-42.png?fit=max\&auto=format\&n=EhvCUQ4ZmSlhciUK\&q=85\&s=218161f15668153624a88183c1cb6d30)

**6. 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.

**7. Enable and Test**

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

## Settings

**Time format:** You can display Calendly 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, pick a slot, finish the booking on the Calendly page that opens, and confirm it appears on your Calendly calendar.

## Examples

A detailed **When to use** description that controls the search window, the wording of the reply, and how the AI agent reports the outcome:

```text theme={null}
Use when the user mentions booking an appointment for Essay Feedback.

If no date is specified, automatically set the window from today to 1 week from
today and display these dates to the user without asking for confirmation.

If a date window is specified, set the search window to that specific date window
and display it to the user.

After performing the search, respond with either "I have found available slots"
or "I have not found available slots".

Display the search window but do not provide a list of slots or links.

After using the tool, check whether the user attempted to book an appointment.
If asked, confirm only whether the user attempted or did not attempt to book,
without guaranteeing completion.
```

"Do not provide a list of slots or links" applies to the AI agent's own text: the slot picker already shows the times, and picking one opens the Calendly link.

## Troubleshooting

> [accordion] The card shows "Something went wrong. Please try again."
>
> Chatbase couldn't fetch slots from Calendly. This happens when Chatbase's access was revoked on Calendly's side or the selected event type was deleted. Reconnect Calendly under **Integrations**, then check the **Event** selected in the Action.

> [accordion] The Event dropdown shows "No events found"
>
> The connected Calendly user has no active event types. Turn an event type on in Calendly, then reopen the Action.

> [accordion] The Calendly Action disappeared
>
> Disconnecting Calendly in Chatbase deletes the Calendly Action. Connect Calendly again and recreate the Action.

## 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. Name the event type if you run more than one.

> [card] Set the Search Window
>
> Tell the AI agent what to do when the customer gives no date, so it doesn't ask a clarifying question it could have answered with a sensible default.

> [card] Confirm the Outcome
>
> Instruct the AI agent to report only that the customer attempted to book. The booking is finished on Calendly, so Chatbase can't confirm it completed.

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

## Frequently asked questions

> [accordion] Is the meeting booked inside the chat?
>
> No. The customer picks a slot in the chat, and Calendly's scheduling page opens in a new tab for that slot, where they complete the booking. To book inside the chat, use the [Cal.com Action](https://chatbase.co/docs/user-guides/chatbot/actions/cal.md).

> [accordion] Which Calendly events can I pick?
>
> The active event types of the connected Calendly user, up to the first 100.

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

> [accordion] How far ahead does it search?
>
> The AI agent picks the window. By default it's today to 28 days later. To search further ahead, say so in **When to use**.

> [accordion] Which Chatbase plan do I need?
>
> Any paid plan. The Calendly integration isn't available without one.

> [accordion] What happens if I disconnect Calendly?
>
> Disconnecting Calendly in Chatbase deletes the Calendly Action. If you reconnect, create the Action again.


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