What is Check Calendar Slots?
The Check Calendar Slots function lets your Voice AI agent query available appointment slots from Cal.com in real-time. When callers ask about availability, your agent instantly fetches open slots and presents options.
Configuration Options
| Setting | Description |
|---|---|
| Description (Prompt) | When to check availability - e.g., “Fetch available slots before booking an appointment” |
| Pre-tool Message | What agent says while fetching - e.g., “Just a moment, let me check our availability” |
| API Key | Your Cal.com API key |
| Select Events | Choose event types from your Cal.com account (15 min, 30 min, etc.) |
| Choose Timezone | Timezone for accurate slot times |
Select Events and Choose Timezone dropdowns appear only after entering a valid Cal.com API key.
How to Set Up
Open Tools Tab
Navigate to Tools Tab in your agent configuration.
Select Event Type
Choose which event to check - 15 min meeting, 30 min meeting, or your custom events.
Example Conversation
Caller asks about availability
Caller asks about availability
Caller: “Hi, I’d like to schedule a meeting with your team.”Agent: “Of course! Let me check our available slots for you.”Agent triggers check_availability_of_slots functionAgent: “I have openings tomorrow at 10 AM, 2 PM, and 4 PM. We also have slots on Friday at 11 AM and 3 PM. Which works best for you?”
Best Practices
Detailed Descriptions
Use “Fetch available slots when caller wants to schedule or asks about times” instead of just “Check availability”
Match Timezones
Ensure Bolna timezone matches Cal.com event timezone to avoid confusion
Add Pre-tool Message
Set a friendly message like “Just a moment…” so callers know to wait
Test Before Deploying
Verify slots are being fetched correctly with test calls