Calendar Booking
Let visitors book a meeting in the chat through Cal.com or Calendly.
Let visitors book a meeting without leaving the chat. You set it up in Dashboard → Integrations, on the Calendar Booking tile. How that screen works is covered in Integrations.
What it does
Connect the scheduling tool you already use, and when a visitor wants to meet, the assistant offers real free slots from it and confirms the booking for you, in the visitor's language.
Two tools can be connected:
| Tool | How it connects |
|---|---|
| Cal.com | API key — paste your key, verify it, and choose one of the event types loaded from your account. Both cal.com and cal.eu accounts work; verifying the key tells which region the account is in. |
| Calendly | Sign-in — authorize access in a Calendly window, then choose an event type from your account. The access is renewed automatically while Calendly keeps it authorized. |
Google Calendar is not one of the choices. Booking straight into a Google calendar is not offered today. Cal.com and Calendly both work on top of a Google calendar: connect your Google calendar to one of them, then connect that tool here.
One website connects one tool at a time. To move from Cal.com to Calendly, or back, disconnect the current one first, then connect the other.
Bookings made through the assistant appear in Dashboard → Leads, where AI Assistant can send appointment reminders for them.
What you need
- A Cal.com account with an API key, or a Calendly account on a paid Calendly plan.
- At least one event type in that account with availability set, and switched on.
- A plan that includes Calendar Booking — see Plan and limits.
Calendly's scheduling API is a paid feature on Calendly's side, separate from your plan here. A new Calendly account works during its trial and then stops; after that, Calendly refuses the bookings the assistant makes for your visitors. The panel says this before you connect.
How to connect
The panel takes you through three steps: Connect your tool, Configure the event type, Verify the connection.
Connect Cal.com
- Open the Calendar Booking tile and choose Cal.com.
- Create an API key in Cal.com (Settings → Developer → API keys), paste it into Cal.com API key and click Verify & load event types. The panel then shows the account it is Connected as — with EU (cal.eu) beside it for a
cal.euaccount — and Change key if you pasted the wrong one. - Pick the Event Type visitors should book and click Connect Cal.com. Connecting runs the connection test for you and reports how many slots are free in the next 24 hours.
Connect Calendly
- Open the Calendar Booking tile, choose Calendly and click Connect Calendly. Calendly opens in a separate window; grant access there and the panel updates by itself. While that window is open, the panel asks before it lets you close it — closing would abandon the connection.
- Choose an active Event Type and click Save changes.
- Click Test connection before relying on it in conversations. It needs a saved event type; until then the panel says Select an event type to test.
Settings
- Event Type — what the assistant books. The list is loaded from your account; hidden event types are marked (Cal.com leaves them off your public booking page), and so are inactive ones. Refresh reloads the list after you change something in your tool.
- API key (Cal.com) — to replace it, paste the new key and save; leave the field empty to keep the stored one. The key is stored encrypted. If you replace it in Cal.com, save the new one here too.
- Fallback booking URL (optional) — a public booking link. The chat shows it as Open booking page under the free times it offers, and the assistant offers it when a booking fails in your tool or this month's bookings allowance is used up. If your tool does not answer when the assistant asks for free times, the assistant tells the visitor the calendar is unreachable for the moment.
- Webhook secret (provider → us) — see Send us cancellations.
Save changes saves these settings. It sits at the start of the block, above them, with Test connection beside it. The Connection section just below them names how the tool is connected and holds Disconnect — and, for Calendly, Reconnect.
Send us cancellations
The connection reads availability and creates bookings. Cancelling and rescheduling still happen in your tool — and once its webhook reports them to us, a one-to-one meeting that was cancelled, moved or (in Cal.com) rejected there gets no appointment reminder; group events and event types with several seats per slot keep theirs (Appointment reminders).
- Copy our webhook URL from the panel with Copy.
- In your tool, create a webhook subscription pointing at it, subscribed to the events below, with the default payload.
- Paste that subscription's signing secret into Webhook secret (provider → us) and click Save changes.
- Cal.com:
Booking Cancelled,Booking Rescheduled,Booking Rejected - Calendly:
invitee.canceled
Check that it works
Click Test connection. It fetches real free slots from your tool, the way the assistant will, and reports how many are available in the next 24 hours. If it finds slots, visitors will be offered them; if it fails, it says what your tool objected to.
If it isn't working
The panel shows the reason under the connection, with a link to the right place in your tool:
| What the panel says | What to do |
|---|---|
| Your Cal.com API key is missing, invalid or revoked | Create a new key in Cal.com and paste it into the panel. |
| Reconnect Calendly — its access expired | Click Reconnect and sign in to Calendly again. |
| Turn this event type back on | The event type was switched off in your tool. Switch it on there. |
| Pick the event type again — the saved one is gone | It was deleted in your tool. Choose another one and save. |
| Set working hours in Calendly so slots can be offered | The event type has no availability. Add working hours in Calendly. |
| Calendly's trial limit … is used up, or your Calendly trial has ended / Your Calendly plan does not include this | Booking through Calendly needs a paid Calendly plan. Upgrade it in Calendly's billing. |
| Too many requests / … is not answering | Your tool is limiting or unavailable for a moment. Try again shortly. |
| Popup blocked | Allow pop-ups for the dashboard and start the Calendly sign-in again. |
| This website already has a calendar connected | A website connects one calendar at a time, Cal.com or Calendly. Disconnect the one that is connected (see Disconnect), then connect the other. |
A connection that stops working shows Error on its tile and is listed in the banner at the top of the Integrations screen; clicking it opens this panel.
Disconnect, and what happens to your data
Open the Calendar Booking tile, click Disconnect in the Connection section and confirm. For Cal.com we delete the stored API key. For Calendly the access Calendly granted is deleted on our side, and we ask Calendly once to withdraw it, unless the same Calendly account is still connected to another website on our service, whether yours or someone else's, or the stored access does not name its Calendly account. If we did not ask, or Calendly does not confirm it, the connection is still removed on our side and the screen does not tell you; if our app is still listed among the apps connected to your Calendly account and no other website should keep using it, remove it there. Either way the assistant stops offering and creating bookings until you connect again.
Bookings already in your calendar stay there, and bookings already in Dashboard → Leads stay there too.
Plan and limits
Calendar Booking has two separate limits: our monthly bookings allowance, and your scheduling tool's own quotas and plan tiers, which we do not control. Which plans include it and how many bookings a month each plan carries: What each integration allows, by plan. This month's usage is in Website Analytics.