Larsa AI – Cal.com Integration for Meeting Scheduling

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

⚠ Important: 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.

Prerequisites

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

• A Cal.com account (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 account.

2. Create a new event type specifically for AI assistant bookings.

   • Give it a clear name, e.g., “Meeting with AI Assistant.”

   • Configure duration, availability, and other settings.

3. Once created, note down the event ID from the URL.

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:

• Define email in your assistant’s input variables.

• Pass the customer’s email as the email variable when creating the lead.

• 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:

• Go to your event settings in Cal.com.

• Click on “Add a question.”

• Configure the field with these exact values:

  
  

  

  
  

  Identifier: phone (must match exactly)

• Save your changes.

3. Adding Cal.com to Your Assistant

1. In your AI assistant settings, go to the Tools section.

2. Add the Cal.com integration.

3. Configure the tool with:

   • Your Cal.com API key.

   • The event type ID.

Best Practices

• Create dedicated event types for AI bookings to track usage.

• Set clear buffer times between meetings.

• Configure appropriate meeting durations.

• Use descriptive event names that are clear to 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 event.

5. Confirming the customer receives the invitation email.

6. Verifying confirmation emails are sent correctly.

Troubleshooting

If you encounter issues:

• Verify your API key is active and has correct permissions.

• Ensure the event type ID is correct.

• Check your Cal.com availability settings.

• Confirm no required custom fields are added.

• Verify the phone field identifier is exactly phone.

• Make sure the email variable is set in assistant settings.

• Check that the customer email is being passed correctly in leads.

• Confirm your timezone settings are correct.