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

# Cal.com Appointment Scheduling

> Learn how to enable your AI assistant to schedule appointments using Cal.com integration

Enable your AI assistant to seamlessly schedule meetings and appointments using Cal.com integration. This powerful feature allows your AI to check availability and book meetings directly during calls.

<Warning>
  Do not make any new fields required in your Cal.com event settings. The
  integration only supports default fields and the optional phone field. Adding
  required custom fields will cause the integration to fail.
</Warning>

## Prerequisites

Before setting up Cal.com integration, you'll need:

* A Cal.com account (either hosted or self-hosted)
* An event type configured in Cal.com
* An API key from Cal.com

## Setup Process

### 1. Cal.com Configuration

1. Sign up or log in to your [Cal.com](https://cal.com/) account
2. Create a new event type specifically for AI assistant bookings
   * Give it a clear name like "Meeting with AI Assistant"
   * Configure duration, availability, and other settings
3. Once created, note down the event ID from the URL
   <img height="200" src="https://mintcdn.com/d10/_c7q_uE88rLgkAg6/resources/cal-event-id.png?fit=max&auto=format&n=_c7q_uE88rLgkAg6&q=85&s=fc7804ec8931d05868de684674a85bfe" data-path="resources/cal-event-id.png" />
4. Generate an API key:
   * Go to Cal.com settings
   * Navigate to Developer Settings
   * Create a new API key
   * Copy and securely store the API key

### 2. Customer Contact Information

#### Email Configuration

To send calendar invites to customers:

1. Define `email` in your assistant's input variables
2. Pass the customer's email as the `email` variable when creating the lead
3. The system will automatically use this email for calendar invitations

#### Phone Number in Calendar Events

To include the caller's phone number in calendar events:

1. Go to your event settings in Cal.com
2. Click on "Add a question"
   <img height="200" src="https://mintcdn.com/d10/_c7q_uE88rLgkAg6/resources/cal-event-settings.jpeg?fit=max&auto=format&n=_c7q_uE88rLgkAg6&q=85&s=e9a89657bd605267aabc36ccbf57f5a8" data-path="resources/cal-event-settings.jpeg" />
3. Configure the field with these exact values:
   * Identifier: `phone` (this must be exact)
     <img height="200" src="https://mintcdn.com/d10/_c7q_uE88rLgkAg6/resources/cal-phone-field.jpeg?fit=max&auto=format&n=_c7q_uE88rLgkAg6&q=85&s=aaf70be50a2d4c6b1dbbe9e442ca5c6d" data-path="resources/cal-phone-field.jpeg" />
4. Save your changes
   <img height="200" src="https://mintcdn.com/d10/_c7q_uE88rLgkAg6/resources/cal-save.jpeg?fit=max&auto=format&n=_c7q_uE88rLgkAg6&q=85&s=5602f3c3915c75e2404bba82c09e1668" data-path="resources/cal-save.jpeg" />

### 3. Adding Cal.com to Your Assistant

1. In your [AI assistant settings](/ai-assistants/settings/prompt-and-tools#default-tools), locate the Tools section
2. Add the Cal.com integration
3. Configure the tool with:
   * Your Cal.com API key
   * The event type ID
     <img height="200" src="https://mintcdn.com/d10/_c7q_uE88rLgkAg6/resources/cal-tool.png?fit=max&auto=format&n=_c7q_uE88rLgkAg6&q=85&s=dbf12c8be81f3605ae73b93d9b6367b0" data-path="resources/cal-tool.png" />

## Best Practices

* Create dedicated event types for AI bookings to track their usage
* Set clear buffer times between meetings
* Configure appropriate meeting durations
* Use descriptive event names that make sense to your customers
* Keep only default fields and the phone field optional
* Always include customer email in lead creation for calendar invites

## Testing

After setup, we recommend:

1. Making a test call to your AI assistant
2. Requesting to schedule a meeting
3. Verifying the booking appears in your Cal.com dashboard
4. Checking that the phone number appears in the calendar event
5. Verifying the customer receives the calendar invitation email
6. Checking the confirmation emails are received

## Troubleshooting

### Quick Fixes:

**Missing API Key Error:**

* **Solution:** Enter correct API key and event ID in assistant settings
* **Steps:** Go to [assistant settings](/ai-assistants/settings/prompt-and-tools#default-tools) → Appointment Scheduling → Enter API key and event ID → Save

**Booking Failures:**

* **Email Required:** Ensure assistant has email defined in [assistant settings](/ai-assistants/settings/prompt-and-tools#call-variables)
* **Phone field setup:** Add phone field in Cal.com event settings with identifier "phone". See [Phone Number in Calendar Events](#phone-number-in-calendar-events) for detailed setup.
* **Test with real phone calls:** Use phone call (not web call) for testing
* **No custom fields:** Don't add required custom fields in Cal.com event settings

**Connection Issues:**

* **Verify API key** is active in Cal.com developer settings
* **Check event ID** from your Cal.com event URL
* **Confirm phone field** identifier is exactly "phone"

<Note>
  For comprehensive Cal.com troubleshooting, including detailed solutions and additional issues, see [Cal.com Issues](/troubleshooting/cal-com).
</Note>