---
updatedAt: 2026-09-29T11:00:35.000Z
agentTools:
  projectIndex: https://docs.wati.io/llms.txt
---

# Chatbot Triggered (BSUID)

Webhook payload example and field reference for Chatbot Triggered (BSUID) (chatbotTriggered_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.

```json
{
  "eventType": "chatbotTriggered_bsuid",
  "id": "1a2b3b4d5e6f7g8h9i10j",
  "created": "2022-10-14T05:53:01.3833674Z",
  "whatsappMessageId": "abcdefghi_jklmnop",
  "conversationId": "a1b2c3d4e5f6g7h8i9j10",
  "ticketId": "m1n2o3p4q5r6s7t8u9v10",
  "text": "Hello there",
  "type": "text",
  "data": null,
  "timestamp": "1665726781",
  "owner": false,
  "avatarUrl": null,
  "waId": "911234567890",
  "messageContact": null,
  "senderName": "wati user",
  "listReply": null,
  "replyContextId": null,
  "chatbotId": "123456",
  "channelId": null,
  "channelPhoneNumber": "17435002445",
  "bsuid": "HK.xxxxxxxxxxxxx",
  "parentBsuid": "HK.ENT.xxxxxxxxxxxxx",
  "username": "@bob"
}
```

## Field Descriptions

| Field Name  | Type        | Description                                                                                                                    |
| :---------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------- |
| eventType   | string      | Event type: "chatbotTriggered\_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 [Chatbot Triggered](chatbot-triggered) webhook documentation.