Работа с очередью
Предварительная запись
Модуль позволяет внешним системам — сайту, 1С, колл-центру — записывать клиентов на конкретные дату и время. Записанный клиент появляется в общей очереди с бейджем «Запись ЧЧ:ММ», но не мешает обслуживать тех, кто пришёл без записи.
Как это работает
- Клиент без записи (walk-in) берёт талон в терминале и ждёт в живой очереди.
- Клиент с записью заранее выбирает дату и время; в очереди он виден с пометкой времени.
- Окно защиты — последние несколько минут перед записью. В этот момент запись поднимается в начало, и обогнать её нельзя.
- Окно вызова — с какого момента сотрудник может нажать «Вызвать». По умолчанию ровно в назначенное время.
- Неявка — если клиент не появился за отведённое время, запись отменяется автоматически.
Пример: запись на 15:00, окно защиты 5 минут. До 14:55 специалист обслуживает живую очередь. В 14:55 запись становится первой. В 15:00 её можно вызвать, а в 15:15 — если клиент не пришёл — она отменяется.
Включить запись
- Откройте Настройки → Предварительная запись.
- Включите мастер-переключатель. Пока он выключен, все методы API отвечают
503 booking_disabled. - Проверьте рабочие часы и календарь. Слоты строятся по часам организации и, если включено, по производственному календарю РФ.
- Настройте горизонт, шаг и запас. На сколько дней вперёд можно записаться, шаг сетки и минимальное время до слота.
- Задайте окно защиты, окно вызова и время неявки. Окно вызова не может быть больше окна защиты.
- Выпустите API-ключ в разделе Система → API-ключи для боевой интеграции.
- Проверьте на песочнице, затем переключите интеграцию на live-ключ.
Параметры
| Настройка | Ключ | По умолчанию | Смысл |
|---|---|---|---|
| Предварительная запись | booking_enabled | 0 | Главный выключатель модуля. |
| Горизонт | booking_max_days_ahead | 30 | На сколько дней вперёд можно записаться (1–365). |
| Шаг сетки | booking_slot_step_minutes | 15 | Интервал между слотами от начала рабочего дня (5–120). |
| Минимальный запас | booking_min_lead_minutes | 15 | Сколько минут должно остаться до слота от «сейчас». |
| Окно защиты | booking_lock_before_minutes | 5 | За сколько минут до записи её нельзя обогнать. |
| Окно вызова | booking_call_before_minutes | 0 | С какого момента запись можно вызвать (0 — в назначенное время). |
| Неявка | booking_no_show_grace_minutes | 15 | Через сколько после времени записи она отменяется (1–240). |
| Ёмкость слота | booking_capacity_per_slot | 0 | 0 — автоматически по активным рабочим местам очереди. |
| Рабочие часы и календарь | booking_use_work_hours | 1 | Учитывать рабочие часы и праздники/выходные. |
| Требовать контакт | booking_require_contact | 1 | Телефон или e-mail обязателен при записи через внешний API. На рабочем месте сотрудника контакт не обязателен. |
| Тестовый режим | booking_test_enabled | 1 | Разрешает публичный тестовый ключ песочницы. |
Песочница и боевые ключи
- Тестовый ключ публикуется в документации API и создаёт только брони с
is_test=true. - Тестовые брони не попадают в живую очередь, на табло, в отчёты, дашборд и push-уведомления; удаляются через сутки.
- Live-ключ выпускается в API-ключах и показывается один раз. Храните его в секретах интеграции, не в браузере и не в Git.
- У ключа есть права (scopes) и ограничения по очередям и услугам. Пустой список ограничений означает «ничего не разрешено»,
null— «все». - Перевыпуск ключа сразу отключает старый секрет.
Запись с рабочего места
Сотрудник может записывать клиентов прямо из рабочего места — без админ-панели и без внешней системы.
- Откройте раздел «Запись» в меню рабочего места
/employee2или нажмите кнопку с календарём в шапке/employee. Раздел виден, только если роли выдано право просмотра предварительной записи. - Экран разделён на три части. Слева — панель «Новая запись», в центре — календарь и свободное время, справа — записи выбранного дня. На обычном ноутбуке всё помещается на одном экране, прокручивать страницу не нужно.
- Выберите очередь и услугу в первом шаге панели «Новая запись». Список услуг показывает только то, что относится к выбранной очереди.
- Ориентируйтесь по цвету дней: зелёный — есть свободные места, жёлтый — мест мало, красный — всё занято, серый — выходной. У дня подписано количество свободных мест, а расшифровка цветов находится под календарём.
- Нажмите на день в календаре — под календарём появится список «Свободное время» с часами этого дня, а справа — уже созданные записи с временем, клиентом и статусом.
- Проверьте дату и время. Второй шаг панели связан с календарём: в нём выбран тот же день, а смена даты переключает календарь. В списке времени только будущие слоты; свободное время подставляется автоматически, при необходимости выберите другое.
- Создайте запись. Третий шаг кратко показывает, что будет создано, и сколько мест осталось. Кнопка «Создать запись» всегда находится внизу панели — найдите её взглядом один раз, и она не будет переезжать. Остальные данные клиента пока не заполняются.
- Быстрый способ: нажмите на свободное время в блоке «Свободное время» — оно само подставится в панель записи, а выбранный слот подсветится.
- Подсказка после выбора. Когда вы нажимаете день в календаре или время в списке слотов, нужное поле в панели записи на мгновение подсвечивается, а кнопка «Создать запись» становится активной — значит, запись можно создавать.
- Изменение и удаление — кнопки с карандашом и корзиной у записи в правой колонке «Записи на день». Они появляются только при соответствующих правах роли.
Внешний вид раздела подчиняется настройкам рабочего места: тема, прозрачность блоков и фон рабочей области. На прозрачном фоне страница записи выглядит так же, как заметки и доски задач.
Если у роли нет права создавать записи, панель слева показывает только выбор очереди и услуги, а календарь и записи остаются доступными для просмотра.
Настройка «Требовать телефон или e-mail» относится к внешнему API. С рабочего места сотрудника запись можно создать и изменить без контакта клиента — эти поля остаются необязательными.
Управление записями
- Справочники → Талоны — записи видны со статусом «Запись»; администратор может отменить бронь.
- Отмена и перенос через API сразу обновляют экраны по WebSocket.
- В отчётах записи не входят в «создано/обслужено»; число записей за период показывается отдельной метрикой.
- История записей сохраняется для разбора обращений; удаляются только тестовые старше суток.
- Персональные данные клиента (имя, телефон, e-mail) не выводятся на публичные табло.
Документация для интегратора
Полное описание API — в отдельном разделе. Смысл методов, параметров и кодов ошибок не менялся: