Конечный автомат как основа пошагового диалога
Когда бот запрашивает у пользователя данные по очереди — например, имя, адрес доставки и подтверждение заказа, — простая обработка входящих сообщений без явного состояния быстро превращается в запутанный клубок проверок. Конечный автомат (FSM) решает эту проблему: пользователь в каждый момент времени находится в строго определенном состоянии, а каждое входящее событие либо переводит диалог на следующий шаг, либо отклоняется валидатором.
Ключ к устойчивости FSM — явное разделение самого состояния (метка шага) и накопленных данных сессии (введенные ранее поля формы). Это позволяет изолировать бизнес-логику каждого шага и предотвращает утечку промежуточных данных между независимыми сценариями.
Выбор хранилища состояний: память, Redis или реляционная база
Место хранения состояния определяет устойчивость бота к нагрузке и сбоям. Выбор зависит от требований к долговечности данных и масштабированию:
- Оперативная память (In-memory) — подходит только для локальной разработки и простейших утилит. При перезапуске процесса или падении контейнера все диалоги мгновенно сбрасываются в начало, а запуск нескольких реплик бота за балансировщиком становится невозможным.
- Redis или Key-Value хранилища — стандарт для большинства диалоговых систем. Обеспечивают минимальную задержку чтения и записи, встроенную поддержку времени жизни ключей (TTL) для таймаутов и позволяют масштабировать приложение на несколько рабочих процессов.
- Реляционная база данных (PostgreSQL) — оправдана, когда шаг диалога тесно связан с бизнес-сущностями и требует строгих транзакций, например при оформлении банковской заявки или бронировании слота.
Перезапуск сервиса и возобновление диалога
Серверные процессы неизбежно перезапускаются при доставке обновлений кода, миграции контейнеров или авариях инфраструктуры. Если состояние сохранено во внешнем хранилище (Redis или SQL), пользователь не замечает деплоя: его следующий ответ обрабатывается уже новой версией кода с того же шага.
Чтобы переход был бесшовным, структура состояния должна поддерживать обратную совместимость. Если новая версия бота ожидает другие поля в данных сессии, код обработчика должен предусматривать значения по умолчанию для диалогов, начатых на старой версии, вместо выбрасывания исключений. Как обновления доходят до бота после перезапуска, зависит от транспорта: см. вебхук или long polling.
Таймауты сессий и сброс зависших сценариев
Пользователи часто бросают диалог на середине: отвлекаются, закрывают мессенджер или решают заполнить форму позже. Если не ограничивать время жизни состояния, сессия останется активной бесконечно, и через неделю на случайное сообщение пользователь получит ошибку валидации от старой формы.
Для решения этой проблемы задают таймаут неактивности через TTL в Redis или метку времени последнего действия в БД. При истечении времени состояние очищается либо переходит в начальный статус, а пользователю при следующем контакте выводится главное меню или вежливое предложение начать заполнение заново.
Ограничение размера callback_data в инлайн-кнопках
Инлайн-кнопки в Telegram передают идентификатор действия через поле callback_data, размер которого в Telegram Bot API жестко ограничен 64 байтами. Попытка упаковать туда длинный JSON или составной идентификатор приводит к ошибке со стороны API и нерабочей кнопке.
Чтобы уложиться в лимит, используют компактные схемы: короткие префиксы действий и хранение полезной нагрузки на стороне сервера. Например, вместо передачи полного состава корзины в кнопке передают короткий идентификатор временной записи в Redis или первичный ключ заказа из базы данных.
Защита от повторных нажатий и гонок сообщений
В мобильном интерфейсе пользователи нередко нажимают на инлайн-кнопку несколько раз подряд или отправляют дублирующиеся команды из-за нестабильного мобильного интернета. Без защиты это приводит к двойным списаниям средств, повторному созданию заказов или поломке состояния диалога.
Надежная защита строится на двух уровнях: немедленном вызове answerCallbackQuery для гашения анимации ожидания в клиенте и атомарной блокировке состояния на стороне сервера. Блокировка (например, через Redis SETNX с коротким TTL) гарантирует, что пока первый запрос выполняет переход FSM, второй запрос игнорируется или получает уведомление о выполняющейся операции.