Что должен уметь бот для записи
Минимальный бот записи решает одну задачу: клиент выбирает услугу, дату и время, а владелец получает подтверждённую запись без звонков и переписки. Всё, что вокруг, делает его удобным или ломает на реальной нагрузке.
Прежде чем писать код, зафиксируйте сценарии: кто записывается (новый клиент или постоянный), есть ли несколько специалистов или кабинетов, нужна ли предоплата, можно ли записаться на несколько услуг подряд. От этого зависит схема данных, а переделывать её после запуска дороже всего.
- Выбор услуги и, если нужно, специалиста.
- Показ только действительно свободных слотов.
- Подтверждение записи и уведомление владельца или администратора.
- Напоминание клиенту перед визитом.
- Отмена и перенос самим клиентом в пределах правил.
- Список записей для владельца: на день, на неделю, по специалисту.
Как считать свободные слоты
Слот — не строка в таблице «время», а результат расчёта: рабочие часы специалиста минус уже занятые интервалы, минус перерывы, с учётом длительности выбранной услуги и, если нужно, паузы между клиентами. Хранить заранее все слоты на год вперёд неудобно: любое изменение расписания приходится пересчитывать.
Практичнее хранить правила (рабочие часы по дням недели, исключения, отпуска) и занятые записи как интервалы «начало — конец», а свободные окна считать при запросе. Услуга на 90 минут не должна помещаться в окно на 60: поэтому длительность участвует в расчёте, а не только время начала.
- Правила расписания: рабочие часы, перерывы, выходные, отпуска и разовые исключения.
- Длительность услуги и пауза до следующего клиента.
- Занятые интервалы как «начало — конец», а не только время начала.
- Шаг сетки слотов, например каждые 15 или 30 минут, настраиваемый.
- Минимальное время до записи: нельзя записаться на «через пять минут».
Часовые пояса: что делать, если клиенты в разных городах
Telegram не сообщает боту часовой пояс пользователя: в данных, которые приходят боту, его нет. Поэтому бот либо считает, что все клиенты живут по времени бизнеса, либо спрашивает пояс явно. Для услуг «на месте» первый вариант обычно верный: запись идёт по местному времени заведения, и бот везде пишет, по какому времени назначена встреча.
Если услуги онлайн и клиенты из разных городов, спрашивайте пояс при первой записи и сохраняйте его. Хранить время записи нужно в UTC вместе с названием пояса бизнеса (например, `Europe/Moscow`), а не со смещением: смещение меняется при переходе на летнее время там, где он есть. Показывайте клиенту время в его поясе и добавляйте пояс в текст подтверждения.
Защита от двойной записи
Двойная запись возникает, когда два клиента одновременно выбирают один слот: оба видят его свободным, оба нажимают кнопку. Проверка «свободно ли» в коде перед вставкой не защищает: между проверкой и записью проходит время, и вторая запись пройдёт.
Надёжная защита стоит в базе данных. В PostgreSQL для этого есть ограничение исключения (exclusion constraint) на интервалы времени: база сама отклонит вторую запись, пересекающуюся с первой для того же специалиста. Бот получает ошибку и показывает клиенту «этот слот только что заняли, выберите другое время». Тогда гонка двух нажатий не приводит к двум клиентам в одно время.
- Ограничение на уровне базы: пересекающиеся интервалы одного специалиста недопустимы.
- Идемпотентность: повторное нажатие кнопки или повторная доставка обновления не создаёт вторую запись. Подробнее в статье про идемпотентность и повторы.
- Короткое удержание слота на время подтверждения или оплаты с автоматическим освобождением по таймеру.
- Понятное сообщение клиенту, если слот занят, и сразу предложение ближайших свободных.
Отмена и перенос записи
Правила отмены лучше решить до разработки, потому что они влияют и на интерфейс, и на данные. Можно ли отменить за час до визита? Можно ли переносить бесконечно? Что с предоплатой при отмене? Бот должен знать эти правила и показывать клиенту понятный ответ, а не молча отказывать.
Технически перенос — это отмена старой записи и создание новой в одной транзакции: если новый слот занят, старая запись остаётся. Храните историю: статус записи (подтверждена, отменена клиентом, отменена администратором, не пришёл), а не удаляйте строки. Эти данные пригодятся и для статистики, и для споров.
Напоминания: как их отправлять надёжно
Бот может написать клиенту только после того, как тот сам начал диалог с ботом. Поэтому запись должна происходить внутри бота, а не по номеру телефона. Если клиент заблокировал бота, сообщение не дойдёт: это нужно обрабатывать, а не считать напоминание отправленным.
Напоминания лучше хранить как задачи с временем выполнения в базе и обрабатывать фоновым исполнителем: он забирает задачи, чьё время пришло, отправляет сообщение и отмечает результат. Так напоминания переживают перезапуск бота и не теряются. Как строить такие очереди на Go, описано в статье про фоновые задачи и очереди. При переносе или отмене записи напоминание нужно отменять или пересоздавать.
- Напоминания как задачи в базе с временем выполнения и статусом.
- Отмена или пересоздание напоминания при переносе записи.
- Обработка ошибки «пользователь заблокировал бота» с пометкой в записи.
- Лимиты Telegram на частоту отправки: при массовых рассылках сообщения нужно отправлять с паузами.
- Кнопка в напоминании: «подтверждаю» или «отменить».
Связь с календарём и другими системами
Если мастер ведёт расписание в Google Календаре или другой системе, возникает вопрос, что считать главным источником. Односторонняя синхронизация (бот записывает в календарь) проста и надёжна. Двусторонняя (изменения в календаре влияют на слоты бота) полезна, но требует разрешения конфликтов и аккуратной работы с повторяющимися событиями.
Если записи нужны ещё и в CRM, заявки лучше передавать в неё из той же транзакции или через очередь. О том, как это устроено, читайте в статье про бота и CRM для заявок. Общая механика диалога описана в статье про состояние диалога в Telegram-боте.
Что решить до разработки
Запись кажется простой задачей, но в ней много решений, которые трудно менять позже: один специалист или несколько, нужна ли предоплата, какие правила отмены, один пояс или много, откуда брать расписание. Составьте их список и примите решения до первого экрана: это сэкономит больше всего времени.
Если нужен не только бот, но и интерфейс с календарём, посмотрите на мини-приложения Telegram: выбор даты в кнопках удобен для коротких списков, а для плотного расписания календарь в мини-приложении нагляднее. Что влияет на стоимость такого бота, описано в статье про стоимость разработки Telegram-бота.