Руководства

Лист ожидания

Управляйте листом ожидания для полностью занятых услуг — ставьте клиентов в очередь и предлагайте слоты, когда они освобождаются.

Обзор

Когда все слоты по услуге заняты, клиенты могут встать в лист ожидания. Если запись отменяется, слот предлагается следующему в очереди. Очередью, предложениями и сроками их действия Bronjoy управляет автоматически.

Как это работает

Client joins waitlist
       ↓
   [Waiting]  ←  position in queue
       ↓
  Slot opens (cancellation)
       ↓
   [Offered]  ←  time-limited offer
    ↙     ↘
[Booked]  [Expired/Declined]
             ↓
       Next person offered

Статусы

Статус	Значение
`Waiting`	В очереди, ожидает слот
`Offered`	Слот предложен — у клиента есть ограниченное время на подтверждение
`Booked`	Предложение принято, запись создана
`Expired`	Клиент не ответил до истечения срока предложения
`Cancelled`	Запись в листе ожидания отменена клиентом или сотрудником

Работа сотрудника

Просмотр листа ожидания

GET /api/org/waitlist
Authorization: Bearer your-token

Фильтрация по услуге, статусу или желаемой дате:

GET /api/org/waitlist?service_id=1&status=Waiting&preferred_date_from=2026-04-01

Поиск по имени, email или телефону клиента:

GET /api/org/waitlist?search=maria

Добавить клиента в лист ожидания

POST /api/org/waitlist
Authorization: Bearer your-token
Content-Type: application/json

{
  "client_id": 42,
  "service_id": 1,
  "staff_id": 3,
  "preferred_date": "2026-04-01",
  "preferred_time_slot": "morning",
  "notes": "Only available before noon"
}

Варианты preferred_time_slot: morning, afternoon, evening

Предложить слот вручную

Когда вы знаете, что слот освобождается:

POST /api/org/waitlist/{waitlistEntry}/offer
Authorization: Bearer your-token
Content-Type: application/json

{
  "start_time": "2026-04-01T10:00:00Z"
}

Запись переходит в статус Offered. Клиент получает уведомление и ограниченное время на подтверждение (по умолчанию: 2 часа).

Отменить запись в листе ожидания

POST /api/org/waitlist/{waitlistEntry}/cancel
Authorization: Bearer your-token

Посмотреть сводку

Получить количество записей по каждому статусу:

GET /api/org/waitlist/summary

Работа клиента

Клиенты взаимодействуют с листом ожидания через процесс записи:

Встать в лист ожидания

С публичной страницы записи (работает и для гостей, и для авторизованных клиентов — так же, как обычная запись):

POST /api/client/booking/{slug}/waitlist
Content-Type: application/json

{
  "service_id": 1,
  "preferred_date": "2026-04-01",
  "preferred_time_slot": "afternoon",
  "name": "Maria Garcia",
  "phone": "+998901234567"
}

Посмотреть свои записи в листе ожидания

GET /api/client/waitlist
Authorization: Bearer client-token

Принять предложение

Когда слот предложен:

POST /api/client/waitlist/{waitlistEntry}/accept
Authorization: Bearer client-token

Создаётся запись на предложенное время. Запись в листе ожидания переходит в статус Booked.

Отклонить предложение

POST /api/client/waitlist/{waitlistEntry}/decline
Authorization: Bearer client-token

Слот предлагается следующему в очереди.

Выйти из очереди

POST /api/client/waitlist/{waitlistEntry}/cancel
Authorization: Bearer client-token

Узнать длину очереди (публичный доступ)

Аутентификация не нужна — можно показывать на странице записи:

GET /api/booking/{slug}/waitlist/count?service_id=1&date=2026-04-01

Автоматическое продвижение очереди

Если функция включена, Bronjoy автоматически предлагает освободившийся слот следующему в очереди при отмене записи.

Включается в настройках организации:

Настройка	Описание	По умолчанию
`waitlist_auto_promote`	Автоматически предлагать слоты при отмене	`false`
`waitlist_promotion_window_hours`	Через сколько часов истекает предложение	`2`

Когда автопродвижение включено:

Запись отменяется
Bronjoy находит следующую запись в статусе Waiting для этой услуги и даты
Слот предлагается автоматически
Если срок предложения истёк, слот предлагается следующему