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

# Cal.com Issues

> Troubleshoot common problems with Cal.com integration for appointment scheduling

This guide provides solutions for common issues encountered when integrating Cal.com with your AI assistant.

## Connection Issues

### Invalid API Key

Problem: Events not loading or sync fails

Solution:

1. Verify API key is active in Cal.com → Settings → Developer → API Keys
2. Ensure key includes cal\_live\_ prefix
3. Generate a new API key if needed

### Events Not Loading

Problem: Event dropdown is empty after entering API key

Solution:

1. Check API key is correct
2. Click outside the API key field to trigger event loading
3. Refresh the page if events still don’t appear
4. 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:

1. Click “Troubleshoot” to reset fields
2. Only name, email, phone should be required
3. All other fields (location, guests, etc.) should be optional

## Booking Failures

Problem: Bookings succeed but customer doesn’t receive invite

1. Define email variable in assistant settings
2. Pass customer email when creating leads
3. Verify email format is valid

### Phone Number Missing

Problem: Phone number doesn’t appear in calendar events Solution:

1. Click “Sync Event” or “Troubleshoot” button
2. This automatically adds the phone field to the event
3. Phone number is included after sync

### Booking Time Zone Issues

Problem: Appointments scheduled at wrong time

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

## Testing Issues

### Web Call Bookings Fail

Problem: Bookings work inconsistently with web calls

1. Use real phone calls for testing (not web calls)
2. Web calls may not pass phone variable correctly
3. When using web calls, provide phone in international format with + prefix (e.g., “+49 89 12345678”)
4. Phone calls ensure all variables are transmitted correctly

### Multiple Calendars Not Working

Problem: Only one calendar works or events conflict

1. Each calendar should have different event selected
2. Use distinct event names (e.g., “15min”, “30min”)
3. Sync each event separately after adding

## Getting Help

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