How it works Features Pricing FAQ Install guides and videos For agencies Online stores
Log in Build my demo
Help guide

Connect Your Calendar So Your Assistant Books Real Appointments

Your assistant can show real open times in the chat and book them. Here is how to turn it on, connect your calendar, and send every booking where you need it.

Start 7-Day Free Trial What is BotDesk?

Turn on bookings

Pick How Your Assistant Handles Appointments

Open your BotDesk dashboard, then Knowledge, then What your bot can do, then the Appointments card. One control sets everything.

1

Choose one of three settings

  • Off: the assistant answers questions only.
  • Take booking requests: the visitor sends a preferred day and time, and you confirm.
  • Book real times: the assistant shows real open times as buttons in the chat and books the one the visitor picks.
2

Finish the 4-item checklist for Book real times

Before Book real times can be switched on, four things must be done:

  1. Services. For each service, set how long it takes (or choose Varies) and how it books: at an exact start time, in an arrival window, or as a request. BotDesk never guesses a length. A service with no length is taken as a request.
  2. Booking hours. Use your business hours from Business info, or set custom hours. Choose a time zone.
  3. Rules. Set the minimum notice, how far ahead people can book, and how often appointments can start.
  4. Who confirms. Choose who confirms each service, and who gets the booking emails.
3

Home services: arrival windows

If you arrive within a window instead of at an exact time, define your windows (for example 8 to 12) and how many jobs fit in each. These bookings stay pending until you confirm them, from the email or from the Bookings page.

4

Closed days always win

Closed days, holidays and vacations are never offered, whatever else is set. Add them under Knowledge, then Business info, then Hours.

After a booking

What You and Your Customer Get

✓

You get an email

Every booking sends you an email with all the details, Confirm and Cancel links, an .ics file, and Add to Google and Add to Outlook links.

✓

Your customer gets an email

They get a confirmation email with a Cancel or change link that uses the built-in calendar. You can also turn on a 24-hour reminder for customers and a morning email with the day's bookings.

✓

You see it in Bookings

Open Bookings in the left menu, under Leads. You get an upcoming list, a week view and a month view. You can Confirm, Cancel, Mark done, or mark a No-show. Use Time off to block hours.

Booking feed

Show BotDesk Bookings in Your Own Calendar

In the same card, Your bookings feed is a private address that looks like https://botdesk.studio/cal/<secret>.ics. It lists the bookings made through BotDesk. Subscribe to it once and they appear in your calendar app.

1

Google Calendar

Next to Other calendars, click +, then From URL. Paste the address and add it. Source: Google Calendar Help.

2

Outlook

Open Calendar, click Add calendar, then Subscribe from web. Paste the address, click Import, then Save. Source: Microsoft Support.

3

Apple Calendar

Choose File, then New Calendar Subscription. Paste the address and click Subscribe. Source: Apple Calendar on Mac.

Be aware: Google can take several hours to refresh subscribed calendars, and Outlook can be slow too. You always get the email and see the booking in BotDesk right away. If the address ever gets out, click Make a new address in the card. The old one stops working.

Pro plan

Use Cal.com or Calendly

If you already run bookings on Cal.com or Calendly, BotDesk can read that account's open times and create the booking there. These connections need the Pro plan.

1

Cal.com

  1. In Cal.com, create an API key. Cal.com's docs say it is under Settings, then Security. Some accounts show it under Settings, then Developer, then API keys. Copy the key when it is shown.
  2. In BotDesk, open Connect Cal.com (Appointments card, or Integrations), paste the key into Your Cal.com API key and click Connect Cal.com.
  3. Pick the event type to book.

Cal.com sends its own confirmation emails. Source: Cal.com docs.

2

Calendly

  1. In Calendly, open Integrations & apps, then API and webhooks.
  2. Under Personal access tokens, click Generate new token (Get a token now if it is your first). Name it, click Create Token, and copy it.
  3. In BotDesk, open Connect Calendly (Appointments card, or Integrations), paste the token into Your Calendly personal access token and click Connect Calendly.
  4. Pick the event type to book.

Booking inside the chat needs a paid Calendly plan (Standard or higher, per Calendly's API docs). On the free Calendly plan, the visitor confirms the chosen time on Calendly with one tap. Token source: Calendly developer docs.

One click

Connect Google Calendar, Square or Jobber

These connect with one click, with no key to copy. They are switching on one by one: in the Appointments card, under One-click connections, each shows a Connect button once it is on for your account, or Coming soon until then.

1

Google Calendar (Growth plan and up)

  1. Turn on Book real times and finish the checklist. Your services and booking hours still come from BotDesk.
  2. Under One-click connections, open Google Calendar and click Connect Google Calendar.
  3. Pick the Google account you use for work. Google shows two boxes, unticked: tick both (events on calendars you own, and your availability), then click Continue.

What it does: your assistant skips any time you are busy in Google Calendar, and every confirmed booking appears there with the customer's name, phone and email in the event. Limits: only your main (primary) Google calendar is read and written; BotDesk reads busy times only, never event titles. Google does not email your customer, because BotDesk already does. Deleting the event in Google does not cancel the booking, so cancel in Bookings (that removes the event too).

2

Square Appointments (Pro plan)

  1. In Square, turn on online booking, and check that your service has a length and can be booked online.
  2. Under One-click connections, open Square Appointments and click Connect Square Appointments. Sign in to Square and allow the permissions it asks for.
  3. Back in BotDesk, pick the service your assistant books (it is picked for you if you have only one).

What it does: your assistant offers the open times Square shows for that service and books them in Square, adding the customer to your Square customers. Limits: one location and one service per assistant. Square does not let other apps book a service that has a no-show fee. The free Square Appointments plan works. Cancelling in BotDesk cancels in Square only while your Square cancellation window is open; otherwise cancel it in Square too. Connecting Square replaces a Cal.com or Calendly connection.

3

Jobber (Pro plan)

  1. Turn on Book real times (or keep Take booking requests) in BotDesk.
  2. Under One-click connections, open Jobber, click Connect Jobber, sign in, and click Allow access.

What it does: every new booking and booking request lands in Jobber as the client (found by email, or added) and a request, with the time, service, phone, email and answers in a note. Limits: Jobber does not share open times with other apps, so your open times come from BotDesk. The request is not put on your Jobber schedule: schedule the visit in Jobber. Cancelling in BotDesk does not change Jobber.

If one of these loses access (for example you removed BotDesk in Google, Square or Jobber), we email you once, your assistant takes booking requests until you click Reconnect, and nothing already booked changes.

Send bookings anywhere

Webhooks, Zapier, Make and the API

Every booking also goes to your webhook from the Integrations tab. The events are booking.created, booking.confirmed, booking.cancelled and booking.rescheduled, signed the same way as leads. Slack and Discord get a readable message.

1

Recipe: Google Calendar through Zapier

Use Webhooks by Zapier with Catch Hook, then Google Calendar with Create Detailed Event. Map the start and end to data.booking.start and data.booking.end.

2

Recipe: Jobber request

In Zapier or Make, start with booking.created, then add Jobber with create request.

3

The REST API

List bookings with GET https://botdesk.studio/api/v1/bookings, or fetch one with GET /api/v1/bookings/{id}. Use a secret key that starts with bd_live_. See the API docs.

Privacy

What BotDesk Can See

BotDesk reads busy times only, from the link you give it, and never event titles. The link is stored encrypted, and you can remove it any time. Read more in the privacy policy.

FAQ

Calendar Questions

Which plan do I need?

The Free plan answers questions only. Starter takes booking requests: the visitor sends a preferred day and time and you confirm. Real open times that the assistant books in the chat need the Growth plan or higher. Cal.com and Calendly connections need Pro.

Can BotDesk see the names of my events?

No. For a calendar link, BotDesk reads only the busy times (a start and an end) and never the event titles or descriptions. The link is stored encrypted, and you can remove it from the Appointments card any time.

What happens if my calendar link stops working?

The assistant switches to taking booking requests until the link can be read again, and the Appointments card tells you so. Paste a fresh link to fix it.

Why is a booking slow to show up in my Google Calendar?

Google can take several hours to refresh a calendar you subscribe to from a web address. You always get the booking email and see the booking in BotDesk right away. For a faster calendar entry, use the Add to Google link in the owner email.

Can I connect Google Calendar, Square Appointments or Jobber directly?

Yes, with one click, as each connection is switched on. Your Appointments card shows a Connect button for it, or Coming soon until then. Google Calendar (Growth plan and up) blocks your busy times and adds each confirmed booking to your main calendar. Square Appointments (Pro) books the open times Square shows. Jobber (Pro) receives every booking and booking request as a client and a request. Until then, add a calendar link, or send bookings to Jobber with Zapier or Make.

What if someone gets my bookings feed address?

Anyone with that address can see your BotDesk bookings, so keep it private. In the Appointments card, click Make a new address. The new address works and the old one stops.

Get Started

Let Customers Book Without Calling You

Start free, turn on bookings, and your assistant works 24/7.

Start free, or try a paid plan for 7 days

✓ Free plan: no card needed   ✓ Paid plans from $29/mo: 7-day free trial, card at checkout, cancel anytime