Webhook payload example and field reference for New Contact Message (newContactMessageReceived).
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.
{
"eventType": "newContactMessageReceived",
"id": "634930ab82538bf0845a116a",
"created": "2022-10-14T09:49:31.2419621Z",
"waId": "911234567890",
"senderName": "New User",
"sourceId": null,
"sourceUrl": null,
"sourceType": 0,
"bsuid": "HK.xxxxxxxxxxxxx",
"parentBsuid": "HK.ENT.xxxxxxxxxxxxx",
"username": "@bob"
}Field Descriptions
| Field | Type | Description |
|---|---|---|
| eventType | String | Identifies the type of webhook event being triggered |
| id | String | Unique identifier for this specific message event |
| created | String | Timestamp when the message was received, in UTC format |
| waId | String | WhatsApp ID or phone number of the message sender |
| senderName | String | Display name of the person who sent the message |
| sourceId | String/Null | Internal identifier for the message source (null if not applicable) |
| sourceUrl | String/Null | URL reference to the source of the message (null if not applicable) |
| sourceType | Integer | Numeric code representing the type of message source (0 = default/unknown) |
| 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. Only present when available. |
| username | String/Null | Human-readable username handle for the contact. Only present when available. |