Skip to main content

​
How Calendar Booking Works

The Booking tool lets your AI agents schedule appointments during live conversations. Integrated with Cal.com, your agents can check availability, present time slots, confirm bookings, and send automatic confirmations.
Requires a Cal.com account and active integration. Works with Cal.com’s free tier.
How it works: The booking tool provides two functions to your agent:
  1. Get available slots - Fetches available time slots from Cal.com
  2. Book appointment - Creates the booking with customer details
This handles the core booking flow. For advanced workflows like confirming existing appointments, rescheduling, or cancelling, you’ll need to build custom logic using Custom API Actions that integrate directly with the Cal.com API or another calendar provider’s API (e.g., Calendly).

​
Setup

1

Create Cal.com Event Types

Set up event types in Cal.com for each appointment type:
  • Duration (15 min, 30 min, 60 min, etc.)
  • Meeting location (Zoom, Google Meet, phone, in-person)
  • Availability windows
Cal.com event types documentation
2

Test Event Types

Book a test appointment in Cal.com to verify availability, meeting links, and notifications work correctly.
3

Connect Cal.com

Get your Cal.com API key and connect it to itellicoAI:
  1. Go to Cal.com Settings → Developer → API Keys
  2. Click + Add, name it (e.g., “itellicoAI”), and save
  3. In itellicoAI, go to Settings → Developers → Integrations
  4. Open the Cal.com card, then select or create a secret that stores the API key
  5. Click Test Connection
  6. Click Connect after the test succeeds

​
Using Your Existing Calendar System

A common question: “We use Google Calendar / Microsoft Outlook / Microsoft 365. Can we still use Cal.com?” Yes! Cal.com integrates with your existing calendar system to prevent double bookings and check availability across all your calendars.

​
How It Works

Cal.com connects to your company’s calendar system (Google Calendar, Microsoft Outlook, Microsoft 365, Exchange) and:
  1. Checks availability - Reads your existing calendar to determine when you’re free
  2. Prevents conflicts - Cross-references all connected calendars before showing available slots
  3. Syncs bookings - Adds confirmed appointments to your existing calendar automatically
  4. Updates in real-time - When customers book through itellicoAI, the appointment appears in your company calendar immediately
Cal.com acts as a scheduling layer on top of your existing calendar system. You continue using Google Calendar, Outlook, or Microsoft 365 as normal - Cal.com just reads availability and writes bookings to it.

​
Supported Calendar Systems

Cal.com integrates with:
  • Google Calendar - Personal and Google Account accounts
  • Microsoft Outlook - Outlook.com and Outlook desktop
  • Microsoft 365 - Business and enterprise accounts
  • Microsoft Exchange - Exchange 2013, 2016, and newer
  • Apple Calendar - iCloud calendar

​
Setting Up Calendar Integration

1

Connect Your Calendar to Cal.com

In Cal.com, go to Settings → Calendars and connect your calendar:
  • Google Calendar: Click “Connect” and authorize Cal.com
  • Microsoft Outlook/365: Click “Connect” and sign in with Microsoft
  • Exchange: Click “Connect” and enter your Exchange server details
Cal.com calendar connection guide
2

Configure Conflict Checking

Once connected, Cal.com automatically checks this calendar for conflicts. When someone tries to book with you:
  1. Cal.com checks all connected calendars
  2. Only shows times when you’re actually available
  3. Prevents double bookings across all systems
3

Select Booking Destination

Choose which calendar receives new bookings:
  • In Cal.com event type settings
  • Select the calendar where appointments should be created
  • This can be different from the calendars Cal.com checks for conflicts
Multiple calendars: You can connect multiple calendars (e.g., personal Google Calendar + work Outlook). Cal.com checks all of them for conflicts and you choose which one receives new bookings.

​
Common Scenarios

Setup:
  1. Connect your Microsoft 365 account to Cal.com
  2. Cal.com reads your availability from Microsoft 365
  3. New bookings appear in your Microsoft 365 calendar
  4. Your AI agent books appointments through itellicoAI → Cal.com → Microsoft 365
Benefit: You and your team continue using Microsoft 365 normally. The AI agent automatically respects everyone’s existing calendar commitments.
Setup:
  1. Connect your Google Account account to Cal.com
  2. Cal.com reads your availability from Google Calendar
  3. New bookings appear in your Google Calendar
  4. Your AI agent books appointments through itellicoAI → Cal.com → Google Calendar
Benefit: Direct integration with your existing Google Account setup. All bookings sync automatically.
Setup: Each team member connects their own calendar to their Cal.com account:
  • Alice connects her Google Calendar
  • Bob connects his Microsoft 365 calendar
  • Carol connects her Outlook calendar
Benefit: Cal.com handles the complexity. Each person’s availability is checked in their native calendar system.

​
Add Booking Tool

1

Create Tool

  1. Go to your agent → Tools tab
  2. Click Add and select Calendar Booking
  3. Select your Cal.com event type
2

Configure Settings

The tool is automatically named “Book [Event Type]” based on your Cal.com event. See configuration options below.

​
Configuration

​
Event & Platform

Cal.com Event Type (Required)
  • Select from dropdown or enter event ID manually
  • Each tool maps to one Cal.com event type
Meeting Platform (Required)
  • Choose how meetings are hosted:
    • Cal Video - Built-in Cal.com video
    • Zoom - Requires Zoom connected in Cal.com
    • Google Meet - Requires Google Meet connected
    • Microsoft Teams - Requires Teams connected
    • Phone - Phone call appointment
    • In Person - Physical meeting (address required)
Timezone (Required)
  • Defaults to your browser’s timezone (can be changed)
  • All suggested times are presented in this timezone
  • Searchable dropdown with all available timezones

​
Scheduling Preferences

Days to Look Ahead (1-3 days, default: 2)
  • How many future days the agent considers when finding slots
Time Slots Per Day (2-5 slots, default: 3)
  • How many time slots per day the agent offers
Hours Between Suggestions (1-4 hours, default: 3)
  • Minimum spacing between suggested times
Start Date (Optional)
  • Earliest date the agent can suggest
  • Leave blank for immediate availability

​
Email Configuration

The agent uses this priority to find customer email:
  1. Dynamic Context - cal_email from your context API
  2. Contact Record - Email stored in itellicoAI contact
  3. Fallback Email - Team inbox (configure below)
  4. Ask Customer - Agent requests email during call
Fallback Email (Optional)
  • Used when customer email is unavailable
  • Leave blank to force agent to always collect email

​
SMS Notifications

Send SMS Confirmation (Default: enabled)
  • Sends SMS after booking completes
  • Includes meeting details and join link
SMS confirmations only work on phone calls where the caller’s phone number is available in the system. They will not send for web calls or when the phone number is unavailable.
SMS Template
  • Customize the message with placeholders:
    • {date} - Appointment date
    • {time} - Appointment time
    • {link} - Meeting link
    • {location} - In-person address
    • {duration} - Meeting duration
Use default booking instructions (Default: enabled)
  • Adds the built-in scheduling script to the agent prompt
  • Recommended for most agents
  • Disable only if you are replacing the complete booking flow in your own prompt

​
Scheduling for Multiple Employees

A common scenario: “We have 3 employees who can handle appointments, each with different availability. How do we schedule across the team?” Solution: Use Cal.com Teams with Round Robin scheduling. This distributes appointments across team members based on their individual availability.

​
What is Cal.com Teams?

With Cal.com Teams, you can create event types that multiple team members handle. Instead of booking with a specific person, customers book with your team, and Cal.com automatically assigns the appointment to an available team member.
Cal.com Teams requires a Teams or Organization plan. The round robin feature intelligently distributes appointments based on availability, priority, or rotation.

​
How Round Robin Works

When a customer books an appointment:
  1. Checks availability - Cal.com checks each team member’s calendar
  2. Applies distribution logic - Selects the best team member based on your chosen method:
    • Priority: Assign to higher-priority team members first
    • Weighted: Distribute proportionally (e.g., senior staff get more bookings)
    • Least recently booked: Rotate evenly by who was booked least recently
  3. Books with one person - Cal.com schedules the customer with the selected team member
  4. Updates calendar - Appointment appears in that team member’s calendar

​
Setting Up Team Event Types

1

Create a Team in Cal.com

In Cal.com:
  1. Go to Teams → Create Team
  2. Name your team (e.g., “Sales Team”, “Support Team”)
  3. Invite team members by email
  4. Each member connects their own calendar (Google, Microsoft, etc.)
2

Create Team Event Type

In your Cal.com team:
  1. Go to Event Types → New Event Type
  2. Select Round Robin as the event type
  3. Configure duration, meeting platform, etc.
  4. Select which team members can handle this event type
3

Configure Distribution Method

Choose how appointments are distributed:Priority Ranking:
  • Assign each team member a priority (High, Medium, Low)
  • Higher priority members get bookings first
  • Use for senior staff or specialists
Weighted Distribution:
  • Give each member a weight percentage (default 100%)
  • Higher weights = more bookings
  • Use for part-time vs full-time staff
Least Recently Booked:
  • Automatically rotates through team members
  • Ensures even distribution
  • Use for equal workload sharing
4

Add to itellicoAI

Once your team event type is created:
  1. In itellicoAI, go to your agent → Tools tab
  2. Click Add and select Calendar Booking
  3. Select your team event type from the dropdown
  4. The booking tool will now schedule with your team

​
Advanced: Fixed + Round Robin Hosts

For scenarios where one person must always attend, while others rotate: Example: Sales calls need a sales rep (rotating) + sales manager (always present) Setup in Cal.com:
  1. Create round robin event type
  2. Select Fixed Hosts: Sales Manager (always attends)
  3. Select Round Robin Hosts: Sales reps (one attends per call)
  4. Cal.com checks availability for both and books when both are free

​
Team Scheduling Examples

Scenario: 3 sales reps should share demo calls equallySetup:
  • Create team “Sales Team” with 3 members
  • Use Least Recently Booked distribution
  • Each rep connects their calendar to Cal.com
  • Create event type “Sales Demo” (30 min, round robin)
Result: Demos are automatically distributed evenly. Rep availability is checked in real-time from their individual calendars.
Scenario: Senior support staff should get complex issues, junior staff get routine issuesSetup:
  • Create event type “Technical Support Call” with priority distribution
  • Senior staff: High priority
  • Junior staff: Medium priority
Result: Senior staff get booked first when available. Junior staff handle overflow.
Scenario: 2 full-time employees and 1 part-time employeeSetup:
  • Full-time staff: 100% weight each
  • Part-time staff: 50% weight
  • Use weighted distribution
Result: Part-timer gets half as many bookings as full-time staff.
Scenario: Customer needs both a technical specialist and account managerSetup:
  • Use Round Robin Groups (advanced feature)
  • Group 1: Technical specialists (one attends)
  • Group 2: Account managers (one attends)
Result: Cal.com selects one person from each group, ensuring both roles are covered.

​
Team Integration with itellicoAI

When you connect a Cal.com team event type to itellicoAI:
  1. Your AI agent books with the team - Not a specific person
  2. Cal.com handles assignment - Automatically selects the best team member
  3. Customer gets confirmation - With the assigned team member’s details
  4. Team member’s calendar updates - Appointment appears in their individual calendar
In your agent prompt: 
When a customer wants to schedule a consultation:

1. Use 'Book Team Consultation' action
2. The system will automatically assign an available team member
3. Confirm: "Perfect! You're scheduled with [assigned team member]
   on [date] at [time]. You'll receive a confirmation email."
Flexibility: Team members can update their individual Cal.com availability, and the round robin automatically respects those changes. No need to update anything in itellicoAI.

​
Using Booking in Your Prompt

The booking tool already has Use default booking instructions enabled by default. Keep it enabled unless you are writing and maintaining the complete booking flow yourself. When default booking instructions are enabled, use your agent prompt for business-specific booking rules, not for duplicating the step-by-step scheduling script:
  • who should be offered this appointment type
  • which cases should be transferred instead of booked
  • what information the agent should collect before offering booking
  • what fallback path to use if booking is not possible
Avoid defining a separate booking sequence in both your prompt and the Call Flow tab while Use default booking instructions is enabled. Conflicting instructions can cause the agent to ask for the same information twice, offer times too early, or call the booking tool before the caller clearly confirms.
Reference the tool by its auto-generated name only when you need business-specific behavior: 
For consultation requests:

- Use the "Book 30-Minute Consultation" booking tool.
- Before offering booking, confirm the customer wants a product consultation, not billing support.
- If the customer asks for billing help, offer to transfer instead of booking a consultation.
- If no suitable slot is available, collect a callback number and preferred timeframe.
The tool name is automatically generated from your Cal.com event type title (e.g., “30-Minute Consultation” becomes “Book 30-Minute Consultation”).

​
Replacing the Default Booking Flow

Only turn off Use default booking instructions if you need full control over the scheduling conversation. If you disable it, your prompt must cover consent before checking availability, collecting email when needed, confirming the exact slot before booking, and handling no-availability cases.

​
Handle Booking Failures

If 'Book 30-Minute Consultation' fails:

1. Apologize: "I'm having trouble accessing the calendar right now"
2. Offer alternative:
   - "I can have someone call you back to schedule"
   - Collect callback number and best time
3. If no availability: "We're fully booked for [timeframe].
   Would [alternative timeframe] work?"

​
Testing

1

Verify Integration

  • Cal.com integration shows “Connected”
  • Event types appear in dropdown
  • Meeting platforms configured in Cal.com
2

Test Booking Flow

  1. Start test call with your agent
  2. Request appointment booking
  3. Verify agent presents available times
  4. Confirm booking completes
3

Check Confirmations

  • Email confirmation received
  • SMS confirmation sent (if enabled)
  • Meeting link works
  • Calendar updated
4

Test Edge Cases

  • Request dates outside availability
  • Test without email in contact record
  • Verify failure handling

​
Troubleshooting

Cause: Cal.com not connectedSolution:
  • Go to Settings → Developers → Integrations
  • Open the Cal.com card
  • Verify status shows “Connected”
Cause: No event types in Cal.com or sync issueSolution:
  • Create event types in Cal.com
  • Disconnect and reconnect integration if needed
Cause: Platform not connected in Cal.comSolution:
  • Go to Cal.com event type settings
  • Connect the platform (Zoom, Google Meet, etc.)
  • Disconnect and reconnect integration to sync changes
Possible causes:
  • Wrong email address
  • Spam folder
  • Cal.com email settings
Solution:
  • Check spam/junk folder
  • Verify email in booking confirmation
  • Check Cal.com notification settings
Possible causes:
  • Action name not referenced in prompt
  • Agent doesn’t recognize booking intent
  • LLM not performing well with function calling
Solution:
  • Reference exact auto-generated name (e.g., ‘Book 30-Minute Consultation’)
  • Check the Actions tab to see the actual name
  • Verify action is added to the agent
  • Add explicit booking flow to your prompt
  • Test with clear: “I want to book an appointment”
  • Try GPT-4.1 or GPT-4.1-mini for most reliable function calling
  • Reduce temperature for more consistent behavior

​
Next Steps

Tools Overview

Learn about all tool types

Custom API Actions

Build custom booking flows

Transfer Tools

Route to human schedulers if needed

Test Your Agent

Test your booking flow end to end

Booking Example

See a full worked example with Cal.com integration