Interactive messages (buttons and lists) on WhatsApp
Learn how to use reply buttons and lists on WhatsApp, the limits Meta enforces, and how the contact's choice lands back in your inbox.
What interactive messages are
WhatsApp interactive messages show the contact tappable options instead of asking them to type. There are two types:
- Reply buttons: up to 3 buttons the contact taps to answer.
- List messages: one button opens a menu with sections and rows; great when there are many options.
Use them for support menus, quick surveys, confirming appointments, or routing to an agent without the customer typing anything.
Requirements
- They only work on WhatsApp channels.
- You need an open 24-hour window (a recent inbound message from the contact). Outside the window you must use an approved template; some templates can also carry buttons.
Meta limits you must respect
WhatsApp enforces strict rules. Break them and Meta rejects the message with error #131009 and no clear explanation:
Reply buttons:
- A maximum of 3 buttons per message.
- Each button label allows up to 20 characters.
- Titles must be unique within the message (case-insensitive). Two buttons both saying "Yes" cause a rejection.
Lists:
- A single button that opens the menu (label up to 20 characters).
- Up to 10 sections and, in total, up to 10 rows across all sections combined.
- Each row title allows up to 24 characters and must be unique across the whole message; the optional description up to 72 characters.
Common: the message body allows up to 1024 characters, and a list header can only be text.
How the contact replies
When the contact taps a button or picks a row, their choice comes back to Omnifox as a normal inbound message in the conversation: you'll see the text of the selected option. From there you can reply by hand or let a workflow or an AI agent react to that reply to automate the next step.
Verify it works
- Send the interactive message to a test contact.
- Check the buttons or menu show up in WhatsApp.
- Tap an option and confirm the choice arrives as an inbound message in the inbox.
If it doesn't work
- Send fails (#131009): almost always a repeated or too-long title. Trim to the limits and make every option distinct.
- Buttons don't appear: check the 24-hour window is still open; if it's closed, use a template.
- The menu looks cut off: reduce the number of rows or shorten the titles.
Tips
- Use short, action-driven labels: "See pricing", "Talk to sales", "Reschedule".
- For more than 3 options use a list; for quick decisions, buttons.
Related articles
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.