20 October 2026

دليل · Guide9 min read

بوت واتساب يحجز مواعيد عيادتك مع 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

  1. 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 list
    I 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.

  2. 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.

    kapso.com
    Kapso page: Use Claude Code with WhatsApp
    The Meta Business Partners badge above the titleSource: kapso.com
  3. 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.

  4. 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.

    The Kapso connect commands in a terminal and a request to list numbers
    Illustration
    PromptCommands
    export KAPSO_API_KEY="[your project key]"
    claude mcp add --transport http kapso https://api.kapso.ai/mcp --header "Authorization: Bearer $KAPSO_API_KEY"
  5. 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 instructions
    You 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.
  6. 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 form
    Build 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.
  7. 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 template
    Write 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.
  8. 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

PromptDaily review
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

60minutes
  • A private session with you
  • Real building during the session
  • Results you take with you when we finish
Book a build session

100% free

A free consultation about your problem

Start

The full path

Access to every guide (49), starting from 29 AED