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

# Cal.com Appointment Scheduling

> Enable your AI assistant to schedule appointments using Cal.com

Enable your AI assistant to schedule meetings using Cal.com integration. The system automatically configures booking fields for you.

## Setup

### 1. Get API Key

1. Log in to [Cal.com](https://cal.com/)
2. Go to **Settings** → **Developer** → **API Keys**
3. Create a new API key and copy it

<img height="200" src="https://mintcdn.com/robosite/ecz2Sncb3h7cMDeZ/resources/calcom-api-key.png?fit=max&auto=format&n=ecz2Sncb3h7cMDeZ&q=85&s=27211449de78b4f981f5b7379f0b9e8c" data-path="resources/calcom-api-key.png" />

### 2. Connect Cal.com

1. In your assistant settings → **Tools** tab → **Appointment Scheduling**
2. Select **Cal.com** from calendar type
3. Paste your API key
4. Select an event from the dropdown

<img height="200" src="https://mintcdn.com/robosite/ecz2Sncb3h7cMDeZ/resources/calcom-connect.png?fit=max&auto=format&n=ecz2Sncb3h7cMDeZ&q=85&s=a7e5e22561a8826db0da18f5710bbab7" data-path="resources/calcom-connect.png" />

### 3. Sync Event

Click the **"Sync Event"** button to automatically configure booking fields.

<img height="200" src="https://mintcdn.com/robosite/ecz2Sncb3h7cMDeZ/resources/calcom-sync.png?fit=max&auto=format&n=ecz2Sncb3h7cMDeZ&q=85&s=27b0301e8cd322aeb8374fa62c7f6d23" data-path="resources/calcom-sync.png" />

<Check>
  The sync configures: name, email, phone (required) + notes (optional). All other fields become optional.
</Check>

## Multiple Calendars

Click **"+"** next to Appointment Scheduling to add more calendars (e.g., 15min, 30min meetings).

## Email Setup

For calendar invites to work:

1. Define `email` in assistant [input variables](/ai-assistants/settings/prompt-and-tools#call-variables)
2. Pass customer email when creating leads

The phone number is automatically included after sync.

## Troubleshooting

**Invalid API Key:** Verify it's active in Cal.com settings and includes `cal_live_` prefix

**Sync Failed:** Click **"Troubleshoot"** button to reset fields

**No Invites Sent:** Ensure `email` variable is defined and passed with leads

**Field Errors:** Use "Troubleshoot" to reset. Only name, email, phone should be required.

<Note>
  For detailed troubleshooting, see [Cal.com Issues](/troubleshooting/cal-com).
</Note>

## Testing

1. Make a test call and request a meeting
2. Verify booking appears in Cal.com
3. Check calendar invitation email was received