smb_message_echoes webhook reference | Developer Documentation
smb_message_echoes webhook reference
Updated: Oct 22, 2025
This reference describes trigger events and payload contents for the WhatsApp Business Account smb_message_echoes webhook.
The smb_message_echoes webhook notifies you of messages sent via the WhatsApp Business app or a companion (“linked”) device by a business customer who has been onboarded to Cloud API via a solution provider.
Triggers
Parameters
| Placeholder | Description | Example value |
|---|---|---|
<BUSINESS_DISPLAY_PHONE_NUMBER>String |
Business display phone number. |
15550783881 |
<BUSINESS_PHONE_NUMBER_ID>String |
Business phone number ID. |
106540352242922 |
<MESSAGE_CONTENTS>Object |
An object describing the message’s contents.
This value will vary based on the message
type, as well as the contents of the message.For example, if a business sends an
image message without a caption, the object would not include the caption property.See Sending messages for examples of payloads for each message type. |
|
<MESSAGE_TYPE>String |
Message type. Note that this placeholder appears twice in the syntax above, as it serves as a placeholder for the type property’s value and its matching property name. |
text |
<WEBHOOK_TRIGGER_TIMESTAMP>Integer |
Unix timestamp indicating when the webhook was triggered. |
1739321024 |
<WHATSAPP_BUSINESS_ACCOUNT_ID>String |
The business customer’s WhatsApp Business Account ID. |
102290129340398 |
<WHATSAPP_MESSAGE_ID>String |
WhatsApp message ID. |
wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA= |
<WHATSAPP_USER_PHONE_NUMBER>String |
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. |
+16505551234 |