Message Received (BSUID)

🚧
BSUID-First Contract: This is the BSUID-first version of the webhook. bsuid is always present and is the primary identifier. waId (phone number) is optional and may be omitted. Consumers must identify the user by bsuid, not phone.

{
	"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_bsuid",
	"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
eventType	string	Event type: "message_bsuid" — BSUID-first version of the message received event
bsuid	string	Required. Business Solution User ID — the primary stable cross-channel identifier. Always present in this webhook version.
parentBsuid	string	Required. Parent BSUID — the enterprise-level identifier.
username	string/null	Human-readable username handle for the contact.
waId	string/null	WhatsApp ID / phone number of the contact. Optional — may be omitted in BSUID-first mode.
channelPhoneNumber	string	Phone number of the WhatsApp Business account receiving the message

📘
For full field reference, see the Message Received webhook documentation. The payload structure is identical except for the eventType value and the BSUID field requirements.