This example demonstrates how to set up two tools that work together to handle appointment scheduling through Cal.com. One tool is used to fetch available time slots, and the other is used to book a selected time once the customer confirms.
User level:
Admin
Before you start
Before you start, make sure you have:
active account in Cal.com and admin access to it
active AI Receptionist or AI Specialist subscription on your account
Tool 1: Fetching Available Time Slots
Section | Field | Value | Description |
General | Tool Name |
| Describes what the tool does. |
| Description | When the customer asks for available slots, use this tool to get the list. The response will include dates and times in UTC. | Helps LLM decide when to call this tool. |
| Awaiting Response Message | Let me check the availability. One moment please. | Message played while the tool request is being processed. |
Request Definition | Method |
| Request method. |
| URL | Endpoint URL with parameters. | |
Headers | cal-api-version |
| Required by Cal.com. |
| Authorization |
| Replace with your Cal.com API key. |
Path Parameters | username | Constant: | Your Cal.com username. Can be found in your profile. |
| eventType | Constant: | Slug from the event’s detail page in Cal.com. Use LLM Prompt if multiple types are available. |
| startDate | Parameter: | Define the start of the search window. Should be passed as a System Prompt variable. |
| endDate | Parameter: | Define the end of the search window. Also passed via System Prompt variable. |
Tool 2: Booking the Appointment
Section | Field | Value | Description |
General | Tool Name |
| Descriptive tool name. |
| Description | This tool books a meeting in the calendar after the customer chooses a time. | Helps the LLM understand when to use the tool. |
| Awaiting Response Message | I'm scheduling the meeting now. Please wait. | Message played while booking is in progress. |
Request Definition | Method |
| Request method. |
| URL | Endpoint for booking a meeting. | |
Headers | cal-api-version |
| As required by Cal.com. |
| Authorization |
| Replace with your API key from Cal.com API settings. |
Body Parameters | username | Constant: | Your Cal.com username. |
| eventTypeSlug | Constant: | Type of event being scheduled. |
| start | LLM Prompt: The start time of the booking in ISO 8601 format in UTC timezone, e.g. | Extracted from the conversation. |
| attendee.name | Parameter: | Passed via System Prompt. |
| attendee.email | LLM Prompt: Email of the customer booking the meeting. | Extracted dynamically. |
| attendee.timezone | Constant or LLM Prompt | Set based on your workflow. |
If you need any further assistance please do not hesitate to reach out to our Support team, we are always happy to help!