New Contact Message (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.

{
  "eventType": "newContactMessageReceived_bsuid",
  "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 Name	Type	Description
eventType	string	Event type: "newContactMessageReceived_bsuid" — BSUID-first version
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.

📘
For full field reference, see the New Contact Message webhook documentation.

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.

Field Descriptions

For full field reference, see the New Contact Message webhook documentation.

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.