Button structure
- Use type: "interactive" with interactive.type: "button".
- Include body text and action.buttons with reply IDs/titles.
- Handle reply IDs in your webhook to drive next steps.
WhatsApp Business API interactive buttons
Create and send interactive button messages with WhatsApp Business API.
Interactive buttons in WhatsApp Business API let users tap quick replies or CTA buttons, improving engagement and routing.
Key takeaways
- Interactive type can be button, list, or product message (where supported).
- Button payloads include reply IDs you handle in webhooks.
- Keep button labels concise and actions clear.
Related guides worth reading next
Strengthen this topic cluster by also reading WhatsApp Business API documentation, WhatsApp Business API integration.
Design tips
- Limit to clear, distinct choices (e.g., Confirm vs Reschedule).
- Keep titles short to avoid truncation.
- Pair with a concise body explaining the action.
Example payload
- { "messaging_product": "whatsapp", "to": "<PHONE>", "type": "interactive", "interactive": { "type": "button", "body": { "text": "Confirm appointment?" }, "action": { "buttons": [ { "type": "reply", "reply": { "id": "confirm", "title": "Yes" } }, { "type": "reply", "reply": { "id": "reschedule", "title": "Reschedule" } } ] } } }
FAQs
Can I combine buttons with templates?
Yes. Templates can include buttons; ensure they match the template’s category and intent.
Do buttons change pricing?
No. Pricing depends on the conversation category, not the message components.
How do I track clicks?
Use reply IDs from webhook payloads to route logic and analytics.
Explore more WhatsApp Business API resources
Technical Integration
WhatsApp Business API documentation
Key docs, SDKs, and sections to read first.
Technical Integration
WhatsApp Business API integration
Integration steps, auth, endpoints, and testing tips.
Technical Integration
WhatsApp Business API webhook
Set up webhooks, handle events, and verify signatures.
Technical Integration
WhatsApp Business API JSON example
Example requests for text, media, and interactive messages.
Try BotMax AI
Launch WhatsApp automation with compliant messaging
Verified templates, inbox for teams, broadcasts, reminders, and billing workflows.