Перейти к содержимому
← Все статьи
8 мин чтения

Телеграм-бот для записи клиентов: слоты, напоминания и защита от двойной записи

Бот для записи клиентов в Telegram строится вокруг четырёх вещей: расписание и длительность услуг, выбор свободного слота, подтверждение с напоминаниями и защита от двойной записи на уровне базы данных. Остальное — удобство. Ниже разобрано, как это устроено, где обычно ломается и что решить до начала разработки: часовые пояса, отмену, перенос и связь с календарём.

Что должен уметь бот для записи

Минимальный бот записи решает одну задачу: клиент выбирает услугу, дату и время, а владелец получает подтверждённую запись без звонков и переписки. Всё, что вокруг, делает его удобным или ломает на реальной нагрузке.

Прежде чем писать код, зафиксируйте сценарии: кто записывается (новый клиент или постоянный), есть ли несколько специалистов или кабинетов, нужна ли предоплата, можно ли записаться на несколько услуг подряд. От этого зависит схема данных, а переделывать её после запуска дороже всего.

  • Выбор услуги и, если нужно, специалиста.
  • Показ только действительно свободных слотов.
  • Подтверждение записи и уведомление владельца или администратора.
  • Напоминание клиенту перед визитом.
  • Отмена и перенос самим клиентом в пределах правил.
  • Список записей для владельца: на день, на неделю, по специалисту.

Как считать свободные слоты

Слот — не строка в таблице «время», а результат расчёта: рабочие часы специалиста минус уже занятые интервалы, минус перерывы, с учётом длительности выбранной услуги и, если нужно, паузы между клиентами. Хранить заранее все слоты на год вперёд неудобно: любое изменение расписания приходится пересчитывать.

Практичнее хранить правила (рабочие часы по дням недели, исключения, отпуска) и занятые записи как интервалы «начало — конец», а свободные окна считать при запросе. Услуга на 90 минут не должна помещаться в окно на 60: поэтому длительность участвует в расчёте, а не только время начала.

  • Правила расписания: рабочие часы, перерывы, выходные, отпуска и разовые исключения.
  • Длительность услуги и пауза до следующего клиента.
  • Занятые интервалы как «начало — конец», а не только время начала.
  • Шаг сетки слотов, например каждые 15 или 30 минут, настраиваемый.
  • Минимальное время до записи: нельзя записаться на «через пять минут».

Часовые пояса: что делать, если клиенты в разных городах

Telegram не сообщает боту часовой пояс пользователя: в данных, которые приходят боту, его нет. Поэтому бот либо считает, что все клиенты живут по времени бизнеса, либо спрашивает пояс явно. Для услуг «на месте» первый вариант обычно верный: запись идёт по местному времени заведения, и бот везде пишет, по какому времени назначена встреча.

Если услуги онлайн и клиенты из разных городов, спрашивайте пояс при первой записи и сохраняйте его. Хранить время записи нужно в UTC вместе с названием пояса бизнеса (например, `Europe/Moscow`), а не со смещением: смещение меняется при переходе на летнее время там, где он есть. Показывайте клиенту время в его поясе и добавляйте пояс в текст подтверждения.

Защита от двойной записи

Двойная запись возникает, когда два клиента одновременно выбирают один слот: оба видят его свободным, оба нажимают кнопку. Проверка «свободно ли» в коде перед вставкой не защищает: между проверкой и записью проходит время, и вторая запись пройдёт.

Надёжная защита стоит в базе данных. В PostgreSQL для этого есть ограничение исключения (exclusion constraint) на интервалы времени: база сама отклонит вторую запись, пересекающуюся с первой для того же специалиста. Бот получает ошибку и показывает клиенту «этот слот только что заняли, выберите другое время». Тогда гонка двух нажатий не приводит к двум клиентам в одно время.

  • Ограничение на уровне базы: пересекающиеся интервалы одного специалиста недопустимы.
  • Идемпотентность: повторное нажатие кнопки или повторная доставка обновления не создаёт вторую запись. Подробнее в статье про идемпотентность и повторы.
  • Короткое удержание слота на время подтверждения или оплаты с автоматическим освобождением по таймеру.
  • Понятное сообщение клиенту, если слот занят, и сразу предложение ближайших свободных.

Отмена и перенос записи

Правила отмены лучше решить до разработки, потому что они влияют и на интерфейс, и на данные. Можно ли отменить за час до визита? Можно ли переносить бесконечно? Что с предоплатой при отмене? Бот должен знать эти правила и показывать клиенту понятный ответ, а не молча отказывать.

Технически перенос — это отмена старой записи и создание новой в одной транзакции: если новый слот занят, старая запись остаётся. Храните историю: статус записи (подтверждена, отменена клиентом, отменена администратором, не пришёл), а не удаляйте строки. Эти данные пригодятся и для статистики, и для споров.

Напоминания: как их отправлять надёжно

Бот может написать клиенту только после того, как тот сам начал диалог с ботом. Поэтому запись должна происходить внутри бота, а не по номеру телефона. Если клиент заблокировал бота, сообщение не дойдёт: это нужно обрабатывать, а не считать напоминание отправленным.

Напоминания лучше хранить как задачи с временем выполнения в базе и обрабатывать фоновым исполнителем: он забирает задачи, чьё время пришло, отправляет сообщение и отмечает результат. Так напоминания переживают перезапуск бота и не теряются. Как строить такие очереди на Go, описано в статье про фоновые задачи и очереди. При переносе или отмене записи напоминание нужно отменять или пересоздавать.

  • Напоминания как задачи в базе с временем выполнения и статусом.
  • Отмена или пересоздание напоминания при переносе записи.
  • Обработка ошибки «пользователь заблокировал бота» с пометкой в записи.
  • Лимиты Telegram на частоту отправки: при массовых рассылках сообщения нужно отправлять с паузами.
  • Кнопка в напоминании: «подтверждаю» или «отменить».

Связь с календарём и другими системами

Если мастер ведёт расписание в Google Календаре или другой системе, возникает вопрос, что считать главным источником. Односторонняя синхронизация (бот записывает в календарь) проста и надёжна. Двусторонняя (изменения в календаре влияют на слоты бота) полезна, но требует разрешения конфликтов и аккуратной работы с повторяющимися событиями.

Если записи нужны ещё и в CRM, заявки лучше передавать в неё из той же транзакции или через очередь. О том, как это устроено, читайте в статье про бота и CRM для заявок. Общая механика диалога описана в статье про состояние диалога в Telegram-боте.

Что решить до разработки

Запись кажется простой задачей, но в ней много решений, которые трудно менять позже: один специалист или несколько, нужна ли предоплата, какие правила отмены, один пояс или много, откуда брать расписание. Составьте их список и примите решения до первого экрана: это сэкономит больше всего времени.

Если нужен не только бот, но и интерфейс с календарём, посмотрите на мини-приложения Telegram: выбор даты в кнопках удобен для коротких списков, а для плотного расписания календарь в мини-приложении нагляднее. Что влияет на стоимость такого бота, описано в статье про стоимость разработки Telegram-бота.

Вопросы

Частые вопросы

Не нашли ответ — спросите на созвоне или в Telegram.

Как сделать телеграм-бота для записи клиентов?

Нужны модель расписания (рабочие часы, услуги, длительность), расчёт свободных слотов, подтверждение записи, напоминания и защита от двойной записи на уровне базы данных. Для простого случая хватает бота с кнопками; для сложного расписания удобнее добавить мини-приложение с календарём.

Как защититься от двойной записи на одно время?

Проверки в коде недостаточно: два клиента могут нажать кнопку одновременно. Надёжный способ — ограничение в базе данных (в PostgreSQL это exclusion constraint на интервалы), которое не даёт сохранить пересекающиеся записи одного специалиста. Бот в этом случае предлагает выбрать другое время.

Как бот узнаёт часовой пояс клиента?

Сам по себе не узнаёт: Telegram передаёт боту данные пользователя без часового пояса. Для услуг на месте записывают по времени заведения и пишут это в подтверждении. Для онлайн-услуг пояс спрашивают при первой записи и сохраняют.

Могут ли напоминания не дойти?

Да. Бот может написать только тому, кто начал с ним диалог, и если клиент заблокировал бота, сообщение не доставится. Бот должен обрабатывать эту ошибку и отмечать её. Поэтому запись внутри Telegram надёжнее, чем по одному номеру телефона.

Можно ли связать бота записи с Google Календарём?

Можно. Простой вариант — односторонняя запись: бот создаёт события в календаре. Двусторонняя синхронизация, при которой календарь влияет на свободные слоты, сложнее: нужно разрешать конфликты и обрабатывать повторяющиеся события.

Связанная услуга

Разработка Telegram-ботов для бизнеса

Бот — это вход в вашу систему там, где клиенты и сотрудники уже общаются. Разрабатываем ботов как полноценные приложения: с базой данных, правами доступа и интеграциями, а не как набор кнопок.

Об услуге
Другие статьи
6 мин чтения

Разработка телеграм бота на заказ: архитектура, интеграции и скрытые затраты

Разработка телеграм бота на заказ: от чего зависит стоимость проекта, выбор между конструктором и кодом, платежи, интеграции, серверы и поддержка.

Читать статью: Разработка телеграм бота на заказ: архитектура, интеграции и скрытые затраты →
6 мин чтения

Оплата в телеграм боте: архитектура, платежные шлюзы и надежная обработка

Оплата в телеграм боте: выбор между Stars и ЮKassa, обработка pre_checkout_query, успешные платежи, идемпотентность и возвраты.

Читать статью: Оплата в телеграм боте: архитектура, платежные шлюзы и надежная обработка →
Контакт

Обсудим вашу задачу?

Тридцать минут созвона — и у вас есть понимание архитектуры, сроков и формата работы. Без обязательств.

Или напишите в Telegram →Читайте наш канал в Telegram →

Укажите Telegram или email, чтобы мы могли ответить.

Отвечаем в течение 15 минут.