Message Received

📘
Beta: For whitelisted accounts, this webhook will not be triggered for messages from contacts that have been blocked via the "Mark Spam & Block" feature or the blocking API. Blocked contacts are suppressed from firing webhook events and automations. To enable this feature for your account, please contact the WATI team.

{
	"id": "69282478274a880fe782b2d9",
	"created": "2025-11-27T10:14:16.6268572Z",
	"whatsappMessageId": "wamid.HBgNODYxODcxOTE0OTIxNBUCABIYFDNCRkJFNDFCMTI1MDAwQTRCMDMwAA==",
	"conversationId": "68c8d56157578adb12ada249",
	"ticketId": "69280a6d6244a6d9b9b486e9",
	"text": "hello",
	"type": "text",
	"data": null,
	"sourceId": null,
	"sourceUrl": null,
	"timestamp": "1764238453",
	"owner": false,
	"eventType": "message",
	"statusString": "SENT",
	"avatarUrl": null,
	"assignedId": "682b27727d7094c8b13ed038",
	"operatorName": "Hien Trinh",
	"operatorEmail": "[email protected]",
	"waId": "8618719149214",
	"messageContact": null,
	"senderName": "coubbb",
	"listReply": null,
	"interactiveButtonReply": null,
	"buttonReply": null,
	"replyContextId": "",
	"sourceType": 7,
	"frequentlyForwarded": false,
	"forwarded": false,
	"channelId": null,
	"channelPhoneNumber": "17435002445",
	"bsuid": "HK.xxxxxxxxxxxxx",
	"parentBsuid": "HK.ENT.xxxxxxxxxxxxx",
	"username": "@bob"
}

Field Descriptions

Field Name	Type	Description
id	string	Unique identifier for the message record
created	string	ISO 8601 timestamp when the message was created in the system
whatsappMessageId	string	WhatsApp's unique message identifier (WAMID)
conversationId	string	Unique identifier for the conversation thread
ticketId	string	Unique identifier for the support ticket associated with this message
text	string	The actual text content of the message
type	string	Type of message content, support value: "image", "text", "document", "location", "voice", "audio", "button", "interactive", "reaction", "video", "sticker", "contacts", "order", "catalog", "media_placeholder"
data	object/null	Additional data payload for non-text message types
sourceId	string/null	Identifier for the message source (if applicable)
sourceUrl	string/null	URL reference for the message source (if applicable)
timestamp	string	Unix timestamp when the message was sent
owner	boolean	Indicates if the message was sent by the account owner
eventType	string	Type of event this record represents
statusString	string	Current status of the message
avatarUrl	string/null	URL to the sender's profile picture
assignedId	string	Unique identifier of the operator assigned to handle this conversation
operatorName	string	Full name of the assigned operator
operatorEmail	string	Email address of the assigned operator
waId	string	WhatsApp ID of the message sender
messageContact	object/null	Contact information shared in the message (for contact message types)
senderName	string	Display name of the message sender
listReply	object/null	Data for list selection replies (WhatsApp interactive messages)
interactiveButtonReply	object/null	Data for interactive button replies
buttonReply	object/null	Data for quick reply button responses
replyContextId	string	Reference ID for the message being replied to (empty if not a reply)
sourceType	number	Numeric code indicating the message source type
frequentlyForwarded	boolean	WhatsApp flag indicating if message has been forwarded multiple times
forwarded	boolean	Indicates if this message was forwarded
channelId	string/null	Identifier for the communication channel (if using multi-channel setup)
channelPhoneNumber	string	Phone number of the WhatsApp Business account receiving the message
bsuid	string/null	Business Solution User ID — a stable cross-channel identifier for the contact. Only present when available.
parentBsuid	string/null	Parent BSUID — the enterprise-level identifier that groups related BSUIDs. Only present when available.
username	string/null	Human-readable username handle for the contact. Only present when available.