New Contact Message

📘
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.