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

FieldTypeDescription
conversationIdstring1 to 200 characters.
externalUserIdstring or null1 to 200 characters.
bookingIdstring1 to 200 characters.
statusstringOne of requested, confirmed, cancelled, unknown. An open list: read a value you don't know as unknown.
branchstringAn address: lower-case letters, digits and dashes.
datestringMatches ^\d{4}-\d{2}-\d{2}$.
timestringMatches ^(?:[01]\d|2[0-3]):[0-5]\d$.
partySizeinteger1 to 500.

Examples

Moved to another time.

booking.changed
{
  "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.

booking.changed
{
  "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_.

booking.changed, 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
  }
}