Skip to main content

Interactive messages

Interactive messages let you create conversational experiences with buttons, lists, and more — without relying on free-text replies.

All interactive messages use "type": "interactive". The interactive.type field defines the subtype.

Available subtypes

SubtypeDescription
cta_urlButton that opens a URL
buttonUp to 3 quick-reply buttons
listScrollable list of options
location_request_messageRequest user's location

Base structure

{
"waba_id": "your_waba_id",
"to": "+5511999999999",
"type": "interactive",
"interactive": {
"type": "<subtype>",
"body": { "text": "..." },
"action": { }
}
}