booking.changed webhook
The booking.changed webhook: the AI waiter moved or cancelled a table booking in your app's chat.
The waiter moved or cancelled a booking in your app's chat. The same fields as booking.made, with the booking as it now stands; status is cancelled for a cancellation. Only changes the waiter writes in an app conversation: changes staff make in the dashboard send nothing yet.
The data object
| Field | Type | Description |
|---|---|---|
conversationId | string | 1 to 200 characters. |
externalUserId | string or null | 1 to 200 characters. |
bookingId | string | 1 to 200 characters. |
status | string | One of requested, confirmed, cancelled, unknown. An open list: read a value you don't know as unknown. |
branch | string | An address: lower-case letters, digits and dashes. |
date | string | Matches ^\d{4}-\d{2}-\d{2}$. |
time | string | Matches ^(?:[01]\d|2[0-3]):[0-5]\d$. |
partySize | integer | 1 to 500. |
Examples
Moved to another time.
{
"type": "booking.changed",
"timestamp": "2026-11-03T15:00:00.000Z",
"livemode": true,
"data": {
"conversationId": "conv_01",
"externalUserId": "user-88213",
"bookingId": "res_01",
"branch": "achrafieh",
"date": "2026-11-07",
"time": "21:00",
"partySize": 4,
"status": "confirmed"
}
}Cancelled.
{
"type": "booking.changed",
"timestamp": "2026-11-03T15:05:00.000Z",
"livemode": true,
"data": {
"conversationId": "conv_01",
"externalUserId": "user-88213",
"bookingId": "res_01",
"branch": "achrafieh",
"date": "2026-11-07",
"time": "20:30",
"partySize": 4,
"status": "cancelled"
}
}A test event
What Send a test event in the dashboard sends: livemode: false, and every id starting test_.
{
"type": "booking.changed",
"timestamp": "2026-11-16T12:00:00.000Z",
"livemode": false,
"data": {
"conversationId": "test_conversation",
"externalUserId": "test_user",
"bookingId": "test_booking",
"status": "cancelled",
"branch": "test-branch",
"date": "2026-11-16",
"time": "20:00",
"partySize": 2
}
}