
When a customer needs to confirm an appointment, choose a support category or enquire about a product, an open-ended text reply is not always the clearest option. WhatsApp interactive messages let applications present structured choices that customers can select directly in a conversation.
Through MoceanAPI WhatsApp API, developers can send supported reply buttons, lists and product-related interactions. The important part is what happens around the message: your backend defines the choices, receives the customer’s response and decides what business action follows. This guide explains the interaction layer without treating it as a workflow platform.
An interactive message presents predefined ways to respond to business content. Instead of asking a customer to type an unrestricted answer, an application can offer selectable options with a known purpose.
For example, a plain text message might ask, “Would you like to confirm, reschedule or cancel your appointment?” The customer could respond with “later”, “maybe Friday” or a spelling variation that your application must interpret. An interactive message can display Confirm, Reschedule and Cancel as distinct choices.
Plain text communicates information; media changes its format; interactive content provides structured responses. Those responses are easier to map to an intended action, but your application—not MoceanAPI—decides what that action means.
MoceanAPI’s current WhatsApp API documentation identifies four interactive types: button, list, product and product_list.
Type | Customer experience | Suitable use | Application responsibility |
Reply buttons (button) | Taps a visible choice | A few clear decisions | Interpret the selected button |
List (list) | Opens a list and selects a row | Organised categories or options | Map the chosen row to an action |
Product (product) | Interacts with a specified catalogue item | One relevant product | Handle the product-related response |
Product list (product_list) | Browses products presented in sections | Multiple catalogue items | Handle the resulting product interaction |
These are messaging formats, not prebuilt workflows or a helpdesk.
Reply buttons work well for a few clear decisions. Your backend prepares the choices, sends the interactive message and receives the selection through inbound messaging.
Application defines choices → message is sent → customer taps a button → inbound response arrives → backend maps the choice → application acts.
For developers looking for a WhatsApp buttons API, MoceanAPI currently documents a maximum of three ordinary interactive reply buttons per message. Recheck this limit when implementing; template buttons are a separate capability.
Each reply button has a customer-visible title and an internal id in MoceanAPI’s documented structure. The title helps the customer understand the choice. The ID lets your application identify it reliably when the button is selected; MoceanAPI documents its return in the inbound webhook event.
For example:
Reschedule → internal reschedule identifier → appointment application checks the booking → rescheduling logic starts.
Keep the business meaning in your application rather than inferring it from button text. Refer to the API reference for current field requirements.
A list message shows an entry point that customers open to view selectable rows. It is useful when the choices benefit from more organisation than a short set of visible buttons.
For example, a customer might select Billing from a list of Billing, Technical issue, Account access and Orders. The returned selection can map to an internal support category.
For developers implementing WhatsApp API list messages, the key detail is that each documented list row has an identifier and a customer-facing title. An item’s ID identifies the choice; the displayed title helps the customer make it. MoceanAPI documents the selected list-item ID and title in interactive_list inbound content.
List sections, rows, optional descriptions and current structural limits are defined in the API documentation. Avoid designing around copied limits or assuming that the chosen item automatically starts a business process.
Choose reply buttons when actions are immediate, short and distinct, such as Confirm, Reschedule and Cancel. Visible options can reduce ambiguity when the decision is simple.
Choose a list when a customer needs to navigate categories or a more structured set of options, such as billing enquiries, technical issues or account matters. Organisation is more important here than the number of choices alone.
In either case, ensure the options are clear and each has an application response. Follow current technical limits rather than an invented universal UX formula.
MoceanAPI also documents interactive messages that reference products in a Meta catalogue. A product message centres on a particular catalogue item; a product_list message can present multiple catalogue items arranged in sections.
The MoceanAPI product-message setup guide sets out the prerequisites: create and populate a catalogue in Meta Commerce Manager, have the relevant items approved by Meta, and connect the catalogue to the WhatsApp Business Account (WABA) associated with the sender. An item that has not been approved is not ready for the documented product-messaging process.
The API uses catalog_id to identify the connected catalogue. For a single-product interaction, product_retailer_id identifies the item. Product-list messages reference catalogue products through product items within sections. The current API documentation owns the precise parameters and structures.
Product messaging support does not mean MoceanAPI manages the catalogue or supplies an ecommerce platform. Catalogue creation and item management take place through the appropriate Meta tools. Shopping carts, checkout, payment processing, inventory and fulfilment require separate business systems and arrangements; they should not be inferred from the messaging API.
Interpret resulting product-related inbound information according to its documented content type; do not assume it is identical to a button or list response.
For WhatsApp API interactive messages, the broader message-sending process remains familiar: an application event leads to backend logic, which prepares interactive content for MoceanAPI’s authenticated WhatsApp send operation. The customer receives the supported message and can interact with it.
Application event → backend selects interaction → MoceanAPI WhatsApp API → customer sees choices → customer responds → inbound webhook → backend interprets response → business action.
Authentication, sender and recipient details remain part of the normal send operation. The documentation covers them; here, the focus is structured choices.
Under the current WhatsApp Business Messaging Policy, businesses can reply without an approved template within 24 hours of the customer’s last message. Outside that customer-service window, businesses must use an approved message template to contact the user. Ordinary, non-template interactive buttons and lists are not a way around that requirement. Applicable opt-in and other messaging-policy rules still apply.
Check the customer’s conversation context before trying to send a non-template interaction rather than assuming every message format can be used at any time.
The sending operation delivers choices; the inbound path reports a selection. MoceanAPI documents interactive_button and interactive_list events with selected id and title values.
Conceptually, the return path is:
Customer selection → inbound message/event → webhook → backend → business logic.
The choice alone is not a completed business action. Your backend needs to identify the customer and relevant message or transaction, check the selected identifier against expected options, and decide what state change is appropriate.
A button that reads Confirm may map to an appointment-confirmation action; Billing may map to a support category; a product identifier may map to a particular item in your own system. Labels can be revised for clarity without forcing business rules to rely on matching customer-visible text.
Your backend should reject unknown choices and prevent stale selections from changing the wrong booking or request. The webhook carries the event; it does not decide.
Each WhatsApp interactive message example below shows the interaction layer alongside the application action it enables.
An appointment system needs a customer’s decision. It sends Confirm | Reschedule | Cancel as reply buttons. The customer taps Reschedule; the corresponding ID returns through inbound messaging. The appointment backend recognises that choice, checks the relevant booking and initiates its own rescheduling process. MoceanAPI delivers the interaction; it does not manage the calendar.
A support application presents a list containing Billing, Technical issue, Account, Orders and Other. The customer chooses Billing. The returned list identifier lets the application classify the enquiry and follow its own support process. The API itself does not supply an agent-routing system or shared inbox.
A business application selects an eligible catalogue product or product list and sends the appropriate supported message. The customer interacts with the product content. The backend then processes any relevant documented response in its own product context. Catalogue upkeep and transactions remain outside message sending.
These are related but different messaging contexts. Ordinary interactive reply buttons and lists are the selectable non-template content discussed here. Template buttons, such as supported quick replies or calls to action, form part of the approved template-message context and have separate creation and management requirements.
Authentication buttons, including Copy Code, One Tap and Zero Tap, are associated with WhatsApp Authentication templates. They are not interchangeable with ordinary interactive reply buttons. Follow the relevant template and Authentication documentation for those use cases.
Do not stop at a successful outbound API response. Test the customer’s full journey:
Test the types you use and confirm current restrictions before deployment.
Avoid these implementation shortcuts:
Choose the supported interaction type, map each choice to application logic and test the complete return path.
Ready to implement it? Review the MoceanAPI WhatsApp API documentation for current interactive structures, fields and limits. To understand the wider programmable messaging service, explore MoceanAPI WhatsApp API.

No. Selecting a button produces a response that your application can interpret. Your backend must decide whether to update a booking, categorise a request or carry out another action.
MoceanAPI documents a unique id for an ordinary interactive reply button. The selected ID is returned in the interactive_button inbound content, allowing your application to match it with the intended action and relevant customer context.
Use a list when customers need more organised categories or choices than a brief set of immediately visible buttons. Choose according to clarity and current documented limits, not a fixed universal UX formula.
The relevant Meta catalogue must contain approved items and be connected to the sender's WABA, according to MoceanAPI's product-message guidance. Your application also needs the appropriate catalogue and product references. MoceanAPI does not create or manage your catalogue.
No. Ordinary interactive buttons and lists belong to non-template interaction messages. Template buttons and Authentication options such as Copy Code, One Tap and Zero Tap have different purposes and requirements.