Set up the AI agent that books appointments
Create an AI agent that answers who sees what, how much it costs with each insurance plan and which times are free, and books the appointment in the conversation. Includes a sample prompt for clinics.
Watch this step in the video · AI agent that books appointments
To have AI book appointments, create an agent in AI agents, paste a clinic front-desk prompt and turn on the Search doctors, Check appointment availability and Book with a doctor tools. Then connect it to WhatsApp, Instagram or your website chat.
The module's tools
| Tool | What it does | Plan |
|---|---|---|
| Search doctors | Searches by specialty, name or symptom and returns the doctor, location, accepted plans and the price with the patient's plan. | All |
| Check appointment availability | The free times in the doctor's calendar for a given day. | All |
| Book with a doctor | Books the appointment with the doctor, the time and the patient's details. | All |
| Assign to user or team | Hands the conversation over to someone on the team. | All |
Step by step
- Go to AI agents and click Create AI agent. Choose From scratch → Start blank.
- Under Identity, give it a name, for example "Santa Lucía Front Desk".
- Under Instructions, paste the prompt below and change what's in square brackets.
- Under Tools, turn on the four tools in the table and save.
- Try it in the Live tester, on the right.
- Connect it to your channels under Connections.
Note: in the tester, Book with a doctor is a simulation and doesn't create the appointment. Search doctors and Check appointment availability do read your real data.
Sample prompt
# Role
You are the virtual front desk of [Santa Lucía Clinic]. Your goal is to answer with real data and book the appointment with the right doctor.
# Tone
- Warm, clear and professional. Messages of 2 to 4 lines.
- Only one question per message.
# When to use !search_doctors
- ALWAYS before naming a doctor, specialty, location, insurance plan or price.
- If they mention their insurance, pass it and repeat the price EXACTLY as the tool returns it.
# When to use !check_availability
- Before offering any time, with the date and the doctor's name.
- Offer at most 3 times, with the day and the location.
# When to use !book_doctor_appointment
- Only when the patient picks a time you already offered.
- Ask for full name, mobile number, ID number and the reason in one sentence.
- Repeat doctor, day, time and location, and wait for a "yes".
# Health
- Never give diagnoses or medical advice.
- In an emergency, tell them to go to the emergency room right away.
# Hand off to a person (!assign_to_user_or_team)
- If they want to cancel or change an appointment, have a complaint or ask for it.
The full prompt, with more cases, is in the PDF manual.
Keep reading
Related articles
-
Complete guide to the Medical module
The whole Medical module from start to finish: turning it on, locations and visit types, doctors with hours and prices, settings, insurance plans, appointments in the calendar, booking from a phone and an AI agent that books visits.
-
Turn on the Medical module, locations and visit types
The Medical module is turned on for free per workspace from Catalog → Add to catalog. Before adding doctors, create your locations and your visit types.
-
Add a doctor with hours by location
How to add a doctor in a single window: details, specialties, visits with their own price, hours by location, accepted plans and time off.
-
Clinic settings, insurance plans and prices
In Medical → Settings you set the appointment length, the reminder, how patients book, what they are asked and the public link; with insurance plans you set what the patient pays depending on their plan.
-
Appointments in the calendar and online booking from a phone
Every Medical module appointment lands in the Calendar, in each doctor's own calendar. Patients can book on their own from a phone with the public link, without creating an account.