# staff.requested webhook

> The staff.requested webhook: the AI waiter called restaurant staff, for a routine request such as water or the check, or an escalation.

Source: https://tamr.link/docs/webhooks/staff-requested

The waiter called staff: a routine request (`source: "request"`, with `kind`, such as `water` or `check`) or an escalation (`source: "escalation"`, with a `reason` such as `allergen_severe`, and `urgency`). Sent once per call: a call held as a repeat of one staff already have is not sent again. Never the waiter's or the diner's words. A test key's chat pages no one, but its calls are still sent as test events.

## The `data` object

| Field | Type | Description |
| --- | --- | --- |
| `conversationId` | string | 1 to 200 characters. |
| `externalUserId` | string or null | 1 to 200 characters. |
| `branch` | string or null | An address: lower-case letters, digits and dashes. |
| `table` | string or null | 1 to 40 characters. |
| `source` | string | One of `request`, `escalation`, `unknown`. An open list: read a value you don't know as `unknown`. |
| `kind` | string | May be absent. One of `order_now`, `water`, `check`, `extra_napkins`, `refill`, `other`. An open list: read a value you don't know as `other`. |
| `reason` | string | May be absent. One of `diner_requested_staff`, `allergen_severe`, `off_menu_question`, `order_placement`, `complaint`, `reservation`, `payment`, `unknown_other`. An open list: read a value you don't know as `unknown_other`. |
| `urgency` | string | May be absent. One of `normal`, `high`, `unknown`. An open list: read a value you don't know as `unknown`. |

## Examples

staff.requested:

```json
{
  "type": "staff.requested",
  "timestamp": "2026-11-02T19:30:00.000Z",
  "livemode": true,
  "data": {
    "conversationId": "conv_0001",
    "externalUserId": "user-88213",
    "branch": "achrafieh",
    "table": "12",
    "source": "escalation",
    "reason": "allergen_severe",
    "urgency": "high"
  }
}
```

staff.requested:

```json
{
  "type": "staff.requested",
  "timestamp": "2026-11-02T19:31:00.000Z",
  "livemode": false,
  "data": {
    "conversationId": "conv_0002",
    "externalUserId": null,
    "branch": null,
    "table": null,
    "source": "request",
    "kind": "water"
  }
}
```

## A test event

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

staff.requested, test:

```json
{
  "type": "staff.requested",
  "timestamp": "2026-11-16T12:00:00.000Z",
  "livemode": false,
  "data": {
    "conversationId": "test_conversation",
    "externalUserId": "test_user",
    "branch": null,
    "table": null,
    "source": "request",
    "kind": "water"
  }
}
```
