Skip to content
Explainer

Interactive WhatsApp Messages Explained: Reply Buttons and Lists

How WhatsApp reply buttons (up to 3) and list messages (up to 10 rows) work, their character limits, when to use each, and a worked example for a clinic.

By the chat.or.ke team 6 min read

Quick answer

Interactive WhatsApp messages are business messages that customers answer by tapping instead of typing. The two main types are reply buttons, with up to three buttons of up to 20 characters each, and list messages, which open a menu of up to ten rows. They are sent through the WhatsApp Business API inside the 24-hour customer service window, and each tap returns a clear choice your chatbot or team can act on.

Key takeaways

  • Interactive messages let customers tap a choice instead of typing, which reduces misunderstandings and speeds up chats.
  • Reply buttons show up to three options; list messages show a menu of up to ten rows, optionally grouped into sections.
  • Labels are short: 20 characters for a button, 24 for a list row title, so write tight wording in English and Kiswahili.
  • Free-form interactive messages are sent inside the 24-hour customer service window; outside it you need an approved template, which can carry its own buttons.
  • Buttons and lists are the building blocks of no-code chatbots and flows.

Interactive WhatsApp messages are messages a business sends through the WhatsApp Business API that include tappable elements, such as reply buttons or a pop-up list, so the customer chooses an option instead of typing an answer. They turn "Please reply with 1 for prices, 2 for delivery" into a menu customers can use with one thumb.

This explainer covers what each type does, the limits Meta sets, when to use buttons versus lists, what they cost and a worked example. It is written for business owners and managers planning a WhatsApp menu or chatbot, not for developers.

What types of interactive WhatsApp messages are there?

The two most used types are reply buttons and list messages. WhatsApp also supports several more specialised interactive messages.

  • Reply buttons: up to three buttons under a message. Best for quick decisions such as "Yes / No / Talk to us".
  • List messages: a single button that opens a menu of up to ten rows, each with a title and an optional description. Best for menus with four to ten options.
  • Call-to-action URL button: a button that opens a web link, useful for a booking page or a receipt.
  • Location request: asks the customer to share their location, handy for deliveries.
  • Product messages: show one product or a list of products from your WhatsApp catalog, which customers can browse and order from in the chat. chat.or.ke's Catalog & Orders uses these.
  • WhatsApp Flows: multi-screen forms inside WhatsApp, for longer data collection.

This article focuses on reply buttons and lists, because they are what most small businesses use first.

What are the limits for reply buttons and list messages?

Meta sets fixed limits for each element. The figures below come from Meta's developer documentation for reply buttons and list messages, as of October 2026.

Reply buttons List message
Number of options Up to 3 buttons Up to 10 rows in total, in up to 10 sections
Option label 20 characters per button 24 characters per row title
Option description None Up to 72 characters per row
Menu button label Not applicable 20 characters
Header Optional: text, image, video or document Optional: text only, up to 60 characters
Body text Up to 1,024 characters Up to 4,096 characters
Footer Optional, up to 60 characters Optional, up to 60 characters
Best for Quick yes/no or two-to-three-way choices Menus, services, branches, time slots

The 20 and 24 character limits catch people out. "Angalia bei na ofa zetu" fits a row title; "Check our latest prices and offers" does not fit a button. Write your labels, then count.

When should you use buttons and when should you use a list?

Use buttons for three or fewer options and lists for four to ten. Buttons are visible immediately and take one tap; lists need one tap to open and one to choose, but hold more options and allow a short description under each.

Rules of thumb:

  • Buttons: confirmations ("Confirm booking / Change time"), quick routing ("Sales / Support / Talk to us"), follow-ups after an answer ("Order now / More options").
  • Lists: a main menu, a list of services, branches across towns, delivery zones or appointment slots.
  • Neither: open questions like a name, an address or a description of a problem. Ask those as normal text.

If you have more than ten options, split them into two levels, for example "Women / Men / Kids" buttons first, then a list for each.

Can you send interactive messages at any time?

Not free-form ones. WhatsApp lets businesses send free-form messages, including reply buttons and lists, only within 24 hours of the customer's last message. In practice that is rarely a problem for menus, because they are sent in reply to a customer who just messaged you.

To start a conversation, or to message someone after the window has closed, you need an approved message template. Templates can carry their own quick-reply and call-to-action buttons, for example "Confirm / Reschedule" on an appointment reminder. Read the WhatsApp 24-hour window explained and template categories explained for the rules.

How does a worked example look?

Consider a clinic in Kisumu that receives most bookings on WhatsApp.

1. Welcome list. A patient sends "Hi". The clinic replies:

Habari! Welcome to Lakeview Clinic. How can we help today? [Menu]

Opening the menu shows a list with two sections:

Section Row title Description
Appointments Book a consultation General, paediatric or dental
Appointments Change my booking Move or cancel a visit
Information Hours & location Opposite the Kisumu bus park
Information Lab services Tests offered and turnaround
Information Insurance Covers we accept
Help Talk to reception Chat with our front desk

2. Buttons for a quick choice. The patient taps "Book a consultation". The clinic replies with three buttons: "General", "Paediatric", "Dental".

3. Text for details. The flow asks for the patient's name and preferred day as typed answers, then confirms that reception will reply with a time.

4. Hand-over. The chat appears in the clinic's shared inbox with the choices visible, and the receptionist confirms the slot.

Each tap returns a clear, unambiguous choice, so the clinic's automation can act on it without guessing what the patient meant. Building this in chat.or.ke's Automation & Flows needs no code; see how to build a WhatsApp chatbot without code for the full walkthrough.

How much do interactive WhatsApp messages cost?

They cost the same as any other message of that type: an interactive menu sent inside the 24-hour window is a customer reply. On chat.or.ke that is KES 0.75 per message from your prepaid M-Pesa wallet, and messages customers send you, including their button taps, are free. Template messages with buttons are charged by template category. See pricing for current rates.

What mistakes should you avoid with buttons and lists?

A few common ones:

  • Too many steps: three taps to reach a price is two too many. Put the most common request on the first screen.
  • Vague labels: "Option 1" and "Other" tell customers nothing. Use the words customers use.
  • No way out: always include a "Talk to us" option.
  • Ignoring typed replies: many customers type anyway. Make sure your automation understands "prices" as well as a tap on "Prices".
  • Duplicate titles: button titles in one message must be unique.

Published 20 October 2026 Updated 20 October 2026 Plain-text version

FAQ

Questions people ask

Can't find what you're looking for? Talk to us

What are interactive messages on WhatsApp?

Interactive messages are WhatsApp Business API messages that include tappable elements such as reply buttons, list menus, links, location requests or product cards. Customers choose an option by tapping instead of typing, which makes chatbots and menus faster and clearer.

How many buttons can you add to a WhatsApp message?

A reply-button message can have up to three buttons, each with a title of up to 20 characters. If you need more options, use a list message, which holds up to ten rows.

How many options can a WhatsApp list message have?

A list message can show up to ten rows in total, which can be grouped into up to ten sections. Each row has a title of up to 24 characters and an optional description of up to 72 characters.

Can I send WhatsApp buttons from the WhatsApp Business app?

No. Reply buttons and list messages are features of the WhatsApp Business API, usually used through a provider's inbox or chatbot builder. The free WhatsApp Business app does not let you create them.

Can interactive messages be sent outside the 24-hour window?

Free-form interactive messages can only be sent within 24 hours of the customer's last message. Outside the window you must use an approved template message, which can include its own quick-reply or link buttons.

Do interactive messages work in Kiswahili?

Yes. Button labels, list rows and message text can be written in any language, including Kiswahili. Keep labels within the character limits, which can be tight for longer Kiswahili phrases.

All articles

Ready to run sales and support from one inbox?

Create your free account today. When you are ready to go live, a one-off KES 2,500 setup connects your official WhatsApp Business profile, and then you only pay for the messages you send.

No monthly fee · Pay per message · Top up with M-Pesa