booking.made webhook

The booking.made webhook: the AI waiter booked a table in your app's chat, with the branch, date, time and party size.

The waiter booked a table in your app's chat. Sent once per write: the webhook-id is fixed by the booking and the moment it was written, so a retried call that writes nothing new sends nothing. status is requested when the restaurant confirms by hand.

Only bookings the waiter writes in an app conversation. A booking made on the QR menu or the booking page, and changes staff make in the dashboard, send nothing yet. A test key's chat books nothing, so it sends none either: use Send a test event to see the shape. Never the guest's name, phone, email or note.

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

booking.made
{
  "type": "booking.made",
  "timestamp": "2026-11-03T14:10: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": "confirmed"
  }
}

A location that confirms by hand: a request, and a guest diner (no host user).

booking.made
{
  "type": "booking.made",
  "timestamp": "2026-11-03T14:12:00.000Z",
  "livemode": false,
  "data": {
    "conversationId": "conv_01",
    "externalUserId": null,
    "bookingId": "res_02",
    "branch": "achrafieh",
    "date": "2026-11-07",
    "time": "20:30",
    "partySize": 4,
    "status": "requested"
  }
}

A status this version doesn't know reads as unknown.

booking.made
{
  "type": "booking.made",
  "timestamp": "2026-11-03T14:13:00.000Z",
  "livemode": true,
  "data": {
    "conversationId": "conv_01",
    "externalUserId": "user-88213",
    "bookingId": "res_03",
    "branch": "achrafieh",
    "date": "2026-11-07",
    "time": "20:30",
    "partySize": 4,
    "status": "seated"
  }
}

A test event

What Send a test event in the dashboard sends: livemode: false, and every id starting test_.

booking.made, test
{
  "type": "booking.made",
  "timestamp": "2026-11-16T12:00:00.000Z",
  "livemode": false,
  "data": {
    "conversationId": "test_conversation",
    "externalUserId": "test_user",
    "bookingId": "test_booking",
    "status": "confirmed",
    "branch": "test-branch",
    "date": "2026-11-16",
    "time": "20:00",
    "partySize": 2
  }
}