Message Types
Message with Options
Send a text message with interactive selection buttons
POST
Path parameters
string
required
Unique identifier of the bot sending the message.
Body parameters
string
required
Message type. Must be
"text".string
required
Message recipient. Accepts a phone number in E.164 format without the leading
+ (e.g. 593999999999) or a BSUID (e.g. US.13491208655302741918) for users who have enabled phone number privacy in WhatsApp. See Identifying the recipient.string
required
Main message text.
- WhatsApp
- Instagram and Messenger
On WhatsApp, options are shown as a list that opens from a button.Restrictions
string
Title displayed above the list of options.
object
Button that opens the list of options.
object[]
required
List of selectable options. Minimum 1, maximum 10.
- Options: Minimum 1, maximum 10 options per message
- Option Title: Maximum 24 characters
- Option Description: Maximum 72 characters
- Button Text (
buttonText.text): Defaults to “Opciones” if not specified
Response
boolean
true if the message was sent successfully.string
Identifier of the sent message.
Use Cases
- Creating navigation menus
- Providing multiple-choice options
- Guiding users through a flow
- Collecting structured responses