Cal.com Calendar Integration Overview

In today's rapidly evolving digital landscape, seamless integration between calendars and chatbots is essential for efficient scheduling and user engagement. The latest addition to this ecosystem is the Cal.com integration, which went live recently, offering a compelling alternative to Calendly.

This integration simplifies connecting your Google Calendar with chatbots or AI agents, enabling automated scheduling, booking, and management directly within your conversational workflows.

This summary provides a detailed, structured overview of Cal.com’s features, setup process, and functionalities, ensuring you understand how to leverage this tool effectively.

Deep Dive into Cal.com Integration

Getting Started with Kel.com

To activate Cal.com within your platform:

Navigate to the Integrations menu on the left sidebar.
Scroll down to the Calendar section.
Select Cal.com from the options.
Enter your API key, which you can fetch from your Kel.com account dashboard.
Once the API key is verified, the status will display as verified.

This initial setup establishes a secure connection between your system and Cal.com, enabling subsequent actions.

Using the Flow Builder

Within your chatbot or automation flow:

Add an Action Note.
Choose Add Item > Integrations.
Select Cal.com from the list of available integrations.

Cal.com offers a variety of actions, but we'll focus on the most fundamental ones to maximize utility:

Action	Purpose	Key Parameters	Notes
Fetch Event Types	Retrieve available event types for booking	None or specify slug	Essential for identifying event IDs
Find Available Time Slots	Check open slots for a specific event	Event Type ID, Start Time, End Time, Time Zone	Can be dynamic or manual
Create Booking	Schedule a new appointment	Event Type ID, Start Time, Attendee Info, Location	Supports direct booking within chatbot
Generate Booking Link	Send a booking URL to users	User Info, Event Type ID	Facilitates self-scheduling

Fetching Event Types

To create bookings, you need the Event Type ID:

Use the List Event Types action.
Optionally filter by slug.
Copy the Event Type ID for use in subsequent steps.

Example:

Event Type: Demo Call
ID: 12345

Finding Available Time Slots

This action helps identify open slots for a specific date:

Input Event Type ID.
Set Start Time and End Time (manual or dynamic, e.g., using a now variable).
Leave Date blank to fetch slots for today or specify a date (e.g., 20th).

Sample configuration:

Parameter	Value	Description
Start Time	2023-10-16 13:00	1 PM on October 16th
End Time	2023-10-16 17:00	5 PM on October 16th
Time Zone	Default (UTC)	Adjust as needed

The response provides available slots, which can be stored in custom fields or used directly.

Creating Bookings

Bookings can be generated in two ways:

Generate a Booking Link: Sends a URL to the user for self-scheduling.
Create a Booking Directly: Schedules an appointment within the chatbot.

Booking Details:

Event Type ID
Start Time
Attendee Email, Name, Phone, Time Zone
Optional Attendee Language and Guests (comma-separated).
Location Type: e.g., Google Meet, with specific integration code.

Example:

Attendee: John Doe
Email: john@do.com
Start Time: 2023-10-16 14:00
Location: Google Meet
Guests: jane@do.com, mike@do.com

Google Meet Integration

Use the Google Meet location type.
Copy the Google Meet code provided.
Add metadata if needed (max 50 keys, 40 characters each, string values up to 500 characters).

Metadata Usage

Metadata allows attaching additional info to bookings, such as:

Key	Value	Description
source	chatbot	Origin of booking
campaign	fall_promo	Marketing campaign

Booking Confirmation

Once a booking is created, cal.com returns a confirmation, which can be sent back to the user within the chatbot.

Additional Actions & Features

Cal.com provides a comprehensive suite of actions:

Action	Functionality	Notes
Get User Profile	Retrieve user details	Useful for personalization
Find Bookings	Search by event type, email, name, status	For reminders or management
Get Booking Details	Fetch specific booking info via UID	For updates or cancellations
Reschedule / Cancel	Modify or delete bookings	Based on UID
Mark Absence / Confirm / Decline	Manage booking statuses	For attendance tracking
Get Calendar Links	Retrieve booking URLs	For user access
Get Booking References	Obtain booking IDs	For internal tracking
Manage Event Types & Schedules	List or delete events	No creation support yet
Find / Reserve / Delete / Update Slots	Slot management	For precise scheduling

Slot Management

Find Available Slots: Check open times.
Reserve Slot: Temporarily hold a slot before confirmation.
Delete / Update Slot: Manage reservations.

This flexibility ensures smooth scheduling workflows, accommodating various user scenarios.

Summary

The Cal.com integration introduces a powerful, flexible, and user-friendly way to connect your Google Calendar with chatbots, streamlining appointment scheduling and management.

Its rich set of actions—from fetching event types to managing slots—empowers developers and businesses to create seamless booking experiences. Whether generating links for self-scheduling or directly creating bookings within conversations, Cal.com offers a robust alternative to Calendly, with the added benefit of free accounts and Google Calendar integration.

In summary:

Easy setup via API key.
Versatile actions for fetching, creating, and managing bookings.
Supports multiple location types, including Google Meet.
Metadata for enhanced context.
Slot management for precise scheduling control.
User profile and booking retrieval for personalized interactions.

This integration is poised to enhance automation workflows, reduce manual effort, and improve user engagement. For any questions or further assistance, reach out to support or explore Cal.com’s documentation.

All Training