Webhook & Media Engineering 200 OK

How to Parse WhatsApp Quick Reply & List Button Payloads in Webhooks

When a user taps an interactive button or selects an item from a list message, Meta dispatches an interactive payload object via your webhook listener.

Probable Causes

  • Handling button click responses to route inquiries automatically in CRM
  • Triggering automated chatbot actions based on button payload IDs

Step-by-Step Resolution

Recommended Fix Protocol:

Check messages[0][type] === interactive. Inspect interactive[button_reply][id] or interactive[list_reply][id] to identify the specific button tapped.

Technical Example / Code Payload:

$buttonId = $message['interactive']['button_reply']['id'] ?? ''; if ($buttonId === 'BTN_BOOK_VISIT') { $crm->assignAdvisor($fromPhone); }
Quick Answers

Frequently Asked Questions

What is the character limit for button IDs?+

Button payload IDs can contain up to 256 characters.

Can buttons have icons?+

Yes, emojis are fully supported in button titles.

Need Technical Help?

Resolve WhatsApp API Issues Fast with NY Digital

Our certified Meta API engineering team helps Indian enterprises diagnose webhook bugs, unblock banned numbers, and scale messaging limits safely.

Speak with Our Engineering Team
Chat on WhatsApp