# Interactive messages webhook reference | Developer Documentation

<div id="bkmrk-interactive-messages">## Interactive messages webhook reference

<div><span>Updated: Oct 22, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account **messages** webhook for replies to interactive messages.</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div><span>A WhatsApp user taps a row in an [interactive list message](/books/meta-whatsapp/page/interactive-list-messages-developer-documentation).</span><span>A WhatsApp user taps a button in an [interactive reply button message](/documentation/business-messaging/whatsapp/messages/interactive-reply-buttons-messages).</span><div id="bkmrk-parameters"><div id="bkmrk-parameters-1"><div>### Parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example value </span></th></tr></thead><tbody><tr><td><div><div>`<BUSINESS_DISPLAY_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>Business display phone number.</div></div></td><td><div><div>`15550783881`</div></div></td></tr><tr><td><div><div>`<BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>Business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<BUTTON_ID>`</div><div>*String*</div></div></td><td><div><div>Button ID.</div></div></td><td><div><div>`cancel-button`</div></div></td></tr><tr><td><div><div>`<BUTTON_LABEL_TEXT>`</div><div>*String*</div></div></td><td><div><div>Button label text.</div></div></td><td><div><div>`Cancel`</div></div></td></tr><tr><td><div><div>`<CONTEXTUAL_WHATSAPP_MESSAGE_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp message ID of the message containing the button the WhatsApp user tapped.</div></div></td><td><div><div>`wamid.HBgLMTQxMjU1NTA4MjkVAgASGBQzQUNCNjk5RDUwNUZGMUZEM0VBRAA=`</div></div></td></tr><tr><td><div><div>`<IDENTITY_KEY_HASH>`</div><div>*String*</div></div></td><td><div><div>Identity key hash. Only included if you have enabled the [identity change check](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation) feature.</div></div></td><td><div><div>`DF2lS5v2W6x=`</div></div></td></tr><tr><td><div><div>`<ROW_DESCRIPTION>`</div><div>*String*</div></div></td><td><div><div>Row description.</div></div></td><td><div><div>`Next Day to 2 Days`</div></div></td></tr><tr><td><div><div>`<ROW_ID>`</div><div>*String*</div></div></td><td><div><div>Row ID.</div></div></td><td><div><div>`priority_express`</div></div></td></tr><tr><td><div><div>`<ROW_TITLE>`</div><div>*String*</div></div></td><td><div><div>Row title.</div></div></td><td><div><div>`Priority Mail Express`</div></div></td></tr><tr><td><div><div>`<WEBHOOK_TRIGGER_TIMESTAMP>`</div><div>*String*</div></div></td><td><div><div>Unix timestamp indicating when the webhook was triggered.</div></div></td><td><div><div>`1739321024`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_ACCOUNT_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp Business Account ID.</div></div></td><td><div><div>`102290129340398`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_MESSAGE_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp message ID.</div></div></td><td><div><div>`wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user ID. Note that a WhatsApp user's ID and phone number may not always match.</div></div></td><td><div><div>`16505551234`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user phone number. This is the same value returned by the API as the `input` value when sending a message to a WhatsApp user. Note that a WhatsApp user's phone number and ID may not always match.</div></div></td><td><div><div>`16505551234`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PROFILE_NAME>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user's name as it appears in their profile in the WhatsApp client.</div></div></td><td><div><div>`Sheena Nelson`</div></div></td></tr></tbody></table>

</div></div>