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

# Cal.com Issues

> Troubleshoot common Cal.com integration issues in Famulor: failed bookings, OAuth errors and event-type mismatches during AI voice agent appointments.

> Troubleshoot common Cal.com integration issues

Solutions for common Cal.com integration problems.

## Connection Issues

### Invalid API Key

**Problem:** Events not loading or sync fails

**Solution:**

* Verify API key is active in Cal.com -> Settings -> Developer -> API Keys
* Ensure key includes `cal_live_` prefix
* Generate a new API key if needed

### Events Not Loading

**Problem:** Event dropdown is empty after entering API key

**Solution:**

* Check API key is correct
* Click outside the API key field to trigger event loading
* Refresh the page if events still don't appear
* Verify you have events created in Cal.com

## Sync Issues

### Sync Event Failed

**Problem:** "Sync Event" button fails or shows error

**Solution:**

1. Click **"Troubleshoot"** button instead
2. This resets all booking fields to correct configuration
3. Verify changes in Cal.com event settings

### Field Configuration Errors

**Problem:** Getting errors about required fields or missing fields

**Solution:**

* Click **"Troubleshoot"** to reset fields
* Only name, email, phone should be required
* All other fields (location, guests, etc.) should be optional

## Booking Failures

### No Calendar Invites Sent

**Problem:** Bookings succeed but customer doesn't receive invite

**Solution:**

* Define an email variable in [Assistant Prompt & Tools](/en/ai-assistants/prompt-and-tools)
* Pass customer email when creating leads
* Verify email format is valid

### Phone Number Missing

**Problem:** Phone number doesn't appear in calendar events

**Solution:**

* Click **"Sync Event"** or **"Troubleshoot"** button
* This automatically adds the phone field to the event
* Phone number is included after sync

### Booking Time Zone Issues

**Problem:** Appointments scheduled at wrong time

**Solution:**

* Check time zone in Cal.com event settings
* Verify assistant is getting correct time from customer
* Test with specific time mentions during call

## Testing Issues

### Web Call Bookings Fail

**Problem:** Bookings work inconsistently with web calls

**Solution:**

* Use real phone calls for testing (not web calls)
* Web calls may not pass phone variable correctly
* When using web calls, provide phone in international format with `+` prefix (for example, `+1 555-123-4567`)
* Phone calls ensure all variables are transmitted correctly

### Multiple Calendars Not Working

**Problem:** Only one calendar works or events conflict

**Solution:**

* Each calendar should have a different event selected
* Use distinct event names (for example, `15min`, `30min`)
* Sync each event separately after adding

## Getting Help

If issues persist:

1. Check call transcripts for booking attempts
2. Verify Cal.com event shows in Cal.com dashboard
3. Test with simple phone call booking
4. Contact support with:

* Error message screenshot
* Cal.com event settings screenshot
* Call transcript showing booking attempt

## Related Docs

* [Cal.com Scheduling Setup](/en/ai-assistants/cal-com-scheduling)
* [Assistant Testing](/en/ai-assistants/testing)
* [Support](/en/support)