20 October 2026
بوت واتساب يحجز مواعيد عيادتك مع Claude وKapso: من رقم التجربة إلى أول حجزA WhatsApp Bot That Books Your Clinic Appointments with Claude and Kapso: From Test Number to First Booking
Connect Claude Code to an official WhatsApp number through Kapso, give the bot its instructions, and let it answer and book while staying inside Meta's rules.
Who this guide is for
Clinic and small practice owners, and the people who build WhatsApp bots for them
Key terms
- WhatsApp Business Platform
- Meta's official platform for businesses. The bot sends and receives through it, not through the regular WhatsApp app.
- Kapso
- A Meta Business Partner that gives you a cloud WhatsApp number, a dashboard and an MCP server so Claude Code can operate it.
- MCP
- A way to connect Claude to an outside tool so it can read, send and change things there on your instructions.
- The 24 hour window
- After a customer's last message you have 24 hours to reply freely. After that you can only reach them with an approved template.
- WhatsApp Flows
- A form that opens inside the chat itself, such as picking a day, a time and a name.
The steps
Step 1
Decide the bot's job before any code
Write three jobs only: answer the repeat questions, check open slots and book, and hand any medical question to a person.
Everything else stays with reception. The bot books. It is not a doctor.
PromptAsk Claude for the question listI run a [type of clinic] in [city]. List the 15 questions patients send most on WhatsApp, each with a short reply. Put any question about diagnosis or treatment in a separate list called: hand to staff.
Tip: Keep prices and opening hours in one file the bot reads, so it never invents a number.
Step 2
Create a Kapso project
Go to kapso.com, tap Start free and create a project.
Kapso is a Meta Business Partner and messages go through the official WhatsApp Business Platform.
The Meta Business Partners badge above the titleSource: kapso.com Step 3
Start on the test number
The free plan includes a sandbox number and 2,000 messages a month. Test everything there before you touch the clinic's number.
When you are ready, the real number must receive one verification code by SMS or a call.
Step 4
Connect Claude Code to Kapso
In the Kapso dashboard open API keys and create a project key. Then run the two commands below in your terminal.
Open claude and ask it to list your numbers. Claude Code asks for permission before it runs a tool.
PromptCommandsexport KAPSO_API_KEY="[your project key]" claude mcp add --transport http kapso https://api.kapso.ai/mcp --header "Authorization: Bearer $KAPSO_API_KEY"
Step 5
Write the bot's instructions
This prompt is the bot's personality and its limits. Keep it short and clear, and spell out when it stops and hands over.
PromptClinic bot instructionsYou are the booking assistant for [clinic name] on WhatsApp. Reply in simple Arabic, in short sentences. Your job: answer from this file [questions, prices and hours file], offer the 3 nearest open slots, and book once the patient confirms the name and time. Never: diagnose, give treatment advice or talk about medication. If a question is medical, say: I will pass you to our reception team, and hand over the chat. Never ask for health information in the chat.
Step 6
Let it book with a form inside the chat
Ask Claude Code to build a WhatsApp Flow with the day, the time and the name, connected to the calendar your clinic already uses.
Have it check the slot again before it confirms, so two people never get the same time.
PromptBuild the booking formBuild a booking WhatsApp Flow with: day, time from the open slots, name, contact number. After it is sent, check [calendar system] that the slot is still free, then confirm with a message that states the day and time. Explain each step before you run it.
Step 7
Follow Meta's rules
You have 24 hours from the patient's last message to reply freely, and every new message from them restarts the clock.
After that you can only message them with a template Meta approved, such as an appointment reminder. Before you start a conversation yourself, the patient must have clearly agreed to messages from your clinic, by name.
PromptReminder templateWrite an Arabic utility template for an appointment reminder with variables for name, day and time, and two buttons: Confirm, and I need to change it. Prepare it for Meta review and do not send anything until I approve.
Step 8
Test, then move to the clinic's number
Run ten different chats on the test number, including medical questions, and check it hands them over every time.
Then verify the clinic's number with its code, and have someone watch the chats for the first week.
Tip: Ask Claude every morning: show me the chats nobody answered.
Ready prompts to copy
Show me yesterday's chats that were handed to staff, and list the 3 most repeated questions so I can add their replies to the questions file.
The takeaway
The bot answers and books, a person handles anything medical. Start on the test number today.
Most value
Start building with me now
We sit together, break down your problem, and I build the AI solution with you step by step
- A private session with you
- Real building during the session
- Results you take with you when we finish
100% free
A free consultation about your problem
The full path
Access to every guide (49), starting from 29 AED


