Calendly AI Receptionist — What If You Have Different Types of Appointments?

Your Calendly AI Receptionist Also Includes 4 Advanced Skills and 3 Tools for Complex Appointment Booking Scenarios

When to Use What

Skill 1: Cache Calendly User Profile

Guides the agent through calling getCalendlyUserProfile once and caching the result for the session. Subsequent tool calls reuse this data automatically — no redundant API calls.

Skill 2: Register Contact Only

A structured flow for lead capture without booking. Walks the agent through collecting name, email, phone, and an optional note, then calling createCalendlyContact.

Industry examples:

• Law firm — A potential client calls and says "I need help with a custody case." The AI receptionist captures their name, email, phone, and a note about their situation. A paralegal reviews the intake and calls them back to schedule a paid consultation at the right time with the right attorney.
• HVAC / Handyman — A homeowner fills out a website form: "My AC unit is making a grinding noise." The form submits to createCalendlyContact via the API. The dispatcher reviews the note and books the right technician based on the issue type and service area.
• Real estate agency — A visitor on your website says "I'm interested in selling my home in the next 3 months." The AI receptionist registers the lead with their details and a note. An agent follows up personally rather than auto-booking a generic showing.
• Dental clinic — A new patient calls but your office is closed. The voice AI receptionist captures their info and insurance details in the note field. The front desk books them into the right appointment type the next morning.

Skill 3: Filter & Book/Reschedule By Event Type

The key skill for multi-event-type setups. When your Calendly has multiple event types, this skill guides the agent through presenting the options, letting the customer choose, checking availability for that specific type, and booking or rescheduling accordingly. Without it, the core tools default to your first/only event type. With it, your agent handles "I'd like a 30-minute consultation, not the 15-minute call."

Industry examples:

Skill 4: Find, Filter & Update Specific Bookings

Handles multi-appointment disambiguation. When a customer has multiple upcoming appointments and says "Cancel my Thursday appointment" or "Reschedule the consultation, not the discovery call", this skill guides the agent through searching, presenting, and acting on the correct appointment.

Industry examples:

• Salon — A client has a haircut booked on Tuesday and a colouring on Friday. She calls and says "I need to move my Friday appointment." The AI receptionist searches her bookings, finds both, and confirms: "I see a Colour & Cut on Friday at 2pm — would you like to reschedule that one?" Without this skill, it might cancel the Tuesday haircut instead.
• Dental clinic — A patient has a cleaning next Monday and a crown fitting next Thursday. He calls: "Cancel the one on Thursday." The AI receptionist pulls up both appointments, confirms the crown fitting, and cancels only that one.
• HVAC company — A homeowner has a furnace diagnostic on Wednesday and an AC maintenance on the following Monday. She calls: "Actually, push back the AC appointment — Wednesday is fine." The AI receptionist identifies the correct booking and reschedules only the AC maintenance.
• Lawyer — A client has a free phone screening tomorrow and a paid consultation next week. They call: "I need to reschedule the consultation." The AI receptionist disambiguates and only touches the paid session.
• Med spa — A client has a Botox appointment Tuesday, a facial Thursday, and a follow-up the next week. She calls: "Cancel the facial but keep everything else." The AI receptionist identifies and cancels only the Thursday facial.

The 3 Advanced Tools (Enable When Needed)

These are set to private by default. To enable the advanced tools, log in at secondbrainos.com, find getCalendlyUserProfile, createCalendlyContact, and searchCalendlyMeetings, and set their visibility to public and status to active. See Step 5 (next step) for more details.

Note: Enable only the ones that your agent requires to avoid overload. More tools = more tokens used.

getCalendlyUserProfile — Fetches your complete Calendly profile: user URI, name, email, timezone, organization, scheduling URL, and all your active event types with their URIs, names, slugs, durations, and location types. Call this once per session to cache everything.

When you need it: If you have multiple event types in Calendly (e.g. "15-min Free Discovery Call", "30-min Paid Consultation", "60-min Group Workshop"). Your agent needs to know which event types and slots exist so it can offer the right options. If you only have one event type, you don't need this — the core tools handle it automatically.

Real-world examples where you need this:

• A dental practice with cleanings, consultations, and procedures — each a different duration and sometimes a different dentist
• A law firm with free screenings, paid consultations, and case reviews — different rates and time commitments
• An HVAC company with diagnostic visits, installation consults, and follow-up checks — different technician skill levels
• A salon with cuts, colour, bridal packages, and beard trims — different stylists and time blocks
• A fitness studio with trial sessions, 1:1 training, and group classes — different instructors and capacities

createCalendlyContact — Creates or finds a contact (invitee) by searching existing scheduled events for the given email. Accepts name, email, phone, and a note. Does NOT book an appointment — just registers the contact.

When you need it: Lead capture scenarios. A website visitor wants to be contacted later but doesn't want to pick a time. A voice caller asks for a callback. You want to register someone in the system before routing them elsewhere. If every interaction leads to a booking, createCalendlyContactMeeting handles contact creation and booking in one call.

Real-world examples where you need this:

• A personal injury lawyer — a caller describes their accident but the attorney needs to review the case before scheduling a paid consultation
• A home renovation company — a homeowner wants a quote but the estimator needs to check their schedule and service area first
• A wedding planner — a couple inquires about availability for their date but the planner needs to check venue partnerships before booking a meeting
• A financial advisor — a prospect wants to discuss retirement planning but the advisor pre-screens clients before committing time
• A commercial cleaning company — a business manager fills out a contact form asking for a quote; the operations team reviews square footage and scope before scheduling a walkthrough

Golden Tip: Instead of throwing money at a CRM and Zapier, you can use createCalendlyContact as the webhook/API endpoint behind forms on your website.
How do use createCalendlyContact behdin forms on your website?

Log into the Second Brain OS Dashboard > My Action > Find "createCalendlyContact" and get the API details from there. Copy those details (except your API key) and ask ChatGPT/Claude to help you add it to your website in a secure way. Here's the prompt

"Here are the createCalendlyContact API details from Second Brain OS. My website is built in {WordPress/Wix/HTML/Whatever}. Help me add it in a secure way so that my API key is never exposed.
// Paste Details here

searchCalendlyMeetings — Searches Calendly scheduled events for a contact by email. Returns event details including invitee info, reschedule/cancel URLs, and location. Supports filtering by status (upcoming vs done) and date range.

When you need it: Lookup scenarios — "When's my next appointment?", "Do I have anything booked this week?", "Can you check if my appointment went through?" Also essential when a customer has multiple upcoming appointments and you need to identify the right one before rescheduling or cancelling. BUT if your customers typically only book one appointment at a time, then updateCalendlyMeeting and cancelCalendlyMeeting can easily handle reschedules/cancellations without having to search first.

Real-world examples where you need this:

• HVAC / Plumbing — a homeowner calls: "When is the technician coming? I booked something last week but can't remember the day." The AI receptionist looks up their email and confirms: "You have a furnace diagnostic scheduled for Wednesday at 10am."
• Dental clinic — a patient calls: "I think I have something booked this month but I'm not sure when." The AI receptionist searches and responds: "You have a cleaning on the 15th at 3pm and a crown fitting on the 22nd at 11am."
• Salon — a client messages via the website chat: "Did my appointment actually go through? I booked online but never got a confirmation." The AI receptionist searches and confirms the booking details.
• Lawyer — an existing client calls: "I have a couple of meetings with you coming up — which one is the case review?" The AI receptionist pulls up their upcoming appointments and identifies each by type.
• Auto mechanic — a customer calls: "I dropped off my car for an oil change — do I also have the brake inspection scheduled?" The AI receptionist searches and confirms both appointments with dates and times.

Step 5: Configure Tool Visibility

Every tool in Second Brain OS has two settings that control whether external channels (ChatKit, ElevenLabs, etc.) can access it:

• Visibility — set to public for tools you want accessible from external channels
• Status — set to active for tools that are ready to use

To configure your tools:

1. Log in at secondbrainos.com
2. Navigate to your Calendly AI Receptionist's tools
3. The 4 core tools should already be public and active — verify this
4. For any advanced tools you want to enable, set both visibility to public and status to active

Recommendation: Start with just the 4 core tools. Add the advanced tools once you encounter a scenario that needs them. You can change visibility at any time — no redeployment needed.

This is part of a Crash Course on Calendly AI Agent. Access all the Automations to build a web & voice ai receptionist for booking, rescheduling & cancelling appointments by clicking the button below

Umair Kamil

Install Calendly AI Agent