Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.servicebooked.ca/llms.txt

Use this file to discover all available pages before exploring further.

Cal.com is an open-source scheduler that sits in front of your real calendar. It supports Google Calendar, Outlook, iCloud, Exchange, and others. If you’re not on Google Calendar, Cal.com is the recommended path.

​
How it works with ServiceBooked

Two integration points:
  1. The AI links customers to your Cal.com booking page when they want to schedule. Customers pick their slot in Cal.com’s interface.
  2. A webhook from Cal.com tells ServiceBooked when a booking happens — we update the customer’s contact in your CRM, log the appointment, and add it to your inbox timeline.
This way, your real calendar (Outlook, iCloud, etc.) stays the source of truth; ServiceBooked stays informed; the AI knows where to send people for booking.

​
Set up

1

Get your Cal.com booking link

From your Cal.com dashboard, copy the public booking link for the event type you want customers to book (e.g., “30-min consultation”). Looks like https://cal.com/your-name/30min.
2

Paste it in ServiceBooked

Open Settings → Integrations in your ServiceBooked dashboard. Find the Cal.com section. Paste the booking link in the Cal.com booking URL field. Save.From this point on, when the AI is in a conversation and the customer wants to book, the AI will share your Cal.com link.
3

Set up the webhook (so bookings sync back)

Without the webhook, Cal.com can take bookings — but ServiceBooked won’t know they happened. To wire that up:
  1. Still in Settings → Integrations → Cal.com, click Generate webhook secret. Copy the secret value (you’ll only see it once).
  2. Note the webhook URL shown right above. Looks like https://app.servicebooked.ca/api/integrations/calcom-webhook.
  3. In your Cal.com dashboard, go to Settings → Developer → Webhooks → Create. Paste the URL, paste the secret, and subscribe to the events:
    • BOOKING_CREATED
    • BOOKING_RESCHEDULED
    • BOOKING_CANCELLED
  4. Save the webhook in Cal.com.
4

Test

Book a test appointment via your Cal.com link. Within seconds, you should see:
  • The contact land in your Contacts with the booker’s info
  • The appointment appear in Calendar view
  • A new conversation in Inbox with the booking detail
If nothing shows up, double-check the webhook secret matches and that the webhook URL is correct.

​
What the AI says about booking

When a customer in a conversation wants to schedule, the AI links your Cal.com page:
Great — you can pick a time that works for you here: cal.com/your-name/30min. I’ll see your booking come through and we’ll lock it in.
If you don’t want the AI to link out (preferring to handle scheduling manually), turn off Cal.com integration and the AI will instead capture the customer’s preferred time and surface it as a task for you.

​
Webhook secret — security

The webhook secret is what verifies that incoming requests to ServiceBooked are actually from Cal.com (and not someone pretending to be Cal.com to inject fake bookings). Keep it secret — don’t paste it into a public chat or commit it to git. You can rotate the secret any time from Settings → Integrations → Cal.com → Rotate secret. Doing so requires updating the secret in Cal.com’s webhook settings too.

​
Multiple event types

If you have multiple Cal.com event types (e.g., “30-min quote” and “1-hour install consultation”), pick the most common one as your default. The AI will mention the others in conversation if relevant (“if you’d rather a longer call to walk through specifics, here’s the 1-hour link…”). A first-class “AI picks the right event type based on conversation” feature is on the roadmap.

​
Disconnecting

To disconnect: clear the booking URL field in Settings → Integrations → Cal.com and disable the webhook in your Cal.com dashboard. Existing bookings remain in ServiceBooked; future ones just stop syncing.

​
Next

Calendly setup

Same idea but for Calendly users.

ICS feed

A read-only feed of your ServiceBooked appointments you can subscribe to from any calendar app.