Архитектура магазина в Telegram: от кнопок в чате до базы данных
Полноценный телеграм бот интернет магазин состоит из трех независимых уровней: интерфейса в чате, сервиса бизнес-логики и внешних интеграций. Пользователь видит только сообщения и кнопки, но за ними работает бэкенд на Go, реляционная база данных PostgreSQL и очередь фоновых задач. Попытка хранить состояние корзины прямо в оперативной памяти бота приводит к потере заказов при перезапуске процесса или развертывании новой версии.
Пользовательский ввод поступает через Webhook Telegram. Обработчик принимает входящее обновление, валидирует подпись, определяет сессию покупателя по постоянному идентификатору telegram_user_id и возвращает актуальный экран каталога или корзины. Чтобы диалог не зависал под нагрузкой, любые долгие операции выносятся в фон: запрос к платежному шлюзу, резервирование на складе или уведомление менеджера выполняются асинхронно через брокер сообщений или очередь в базе.
В архитектуре интернет-магазина центральным источником правды всегда остается база данных магазина, а не интерфейс Telegram. Сессии покупателей, товарные позиции, актуальные цены, история изменений статусов и очереди списаний должны находиться под контролем транзакций. Подробнее о структурировании диалогов читайте в статье про состояние диалога бота, а базовую разработку под ключ мы ведем в рамках услуги разработки телеграм-ботов.
Каталог и корзина на inline-кнопках: UX, пагинация и ограничения
Каталог интернет-магазина в чате строится на inline-кнопках (InlineKeyboardMarkup). Сообщение содержит карточку товара с фотографией, описанием, ценой и кнопками добавления в корзину. Однако Telegram накладывает жесткие рамки на интерфейс: в одном сообщении нельзя разместить бесконечное полотно товаров, а callback-данные на кнопках ограничены шестьюдесятью четырьмя байтами.
Чтобы бот для магазина в телеграм оставался удобным, товары группируют в дерево категорий с глубиной не более двух-трех уровней. Для навигации используется компактная пагинация с кнопками перелистывания страниц. В callback-кнопку передается только сжатый идентификатор действия и сущности (например, add:142:1), а вся информация о товаре извлекается бэкендом из базы данных. Поиск по каталогу можно реализовать через текстовый ввод артикула или названия, а также через Telegram Inline Query.
Корзина в чат-боте требует продуманного редактирования без спама сообщениями. Вместо генерации десятков новых сообщений бот редактирует текущее сообщение (editMessageText или editMessageMedia), обновляя состав заказа и общую стоимость. Это сохраняет чистую историю переписки и избавляет покупателя от хаоса.
- Компактная структура категорий: не более пяти-семи разделов на одном экране, чтобы кнопки не уходили за пределы мобильного дисплея.
- Лимиты Telegram API: длина полезной нагрузки в callback-кнопке ограничена 64 байтами, поэтому в нее кладут только короткий префикс действия и числовой ID.
- Редактирование сообщений на месте: изменение количества товара кнопками плюс и минус обновляет текст текущей карточки или экрана корзины без отправки новых сообщений.
- Хранение корзины в базе данных: состав корзины привязан к пользователю в PostgreSQL или Redis со сроком жизни, что позволяет покупателю вернуться к покупкам позже.
Складские остатки и гонки заказов: резервирование без оверселла
Главная техническая сложность интернет-магазина — предотвращение продажи одного и того же товара двум покупателям одновременно (overselling). Если на складе осталась одна единица товара, а два пользователя параллельно нажали кнопку оплаты, наивный бэкенд может подтвердить оба платежа. Исправление этой ошибки вручную через возврат денег клиенту ухудшает репутацию магазина.
На бэкенде под управлением Go и PostgreSQL гонки данных решаются через строгие транзакции с блокировкой строк (SELECT ... FOR UPDATE) или атомарные запросы на уровне базы данных. В момент перехода к оформлению заказа для пользователя создается запись бронирования на ограниченный срок — например, на пятнадцать минут. Товар вычитается из доступного остатка склада атомарным запросом UPDATE products SET available_stock = available_stock - 1 WHERE id = $1 AND available_stock >= 1 RETURNING id. Если запрос вернул ноль строк, бот сразу сообщает покупателю, что позиция только что закончилась.
Фоновый воркер регулярно сканирует просроченные брони. Если пользователь не оплатил заказ за отведенное время, сервис отменяет резерв и возвращает единицы в доступный остаток. Это исключает искусственную блокировку склада брошенными корзинами. Для очередей и таймеров резервирования применяются транзакционные воркеры, как описано в руководстве про фоновые задачи и очереди на Go.
- Атомарное списание: проверка наличия и резервирование остатка выполняются одним SQL-запросом в рамках транзакции уровня базы данных.
- Временный резерв с тайм-аутом: на оплату заказа выделяется фиксированное окно на пятнадцать минут, после чего бронь снимается автоматически.
- Разделение общего и доступного остатка: в базе ведутся две колонки физического и зарезервированного остатка, что дает точную картину для склада.
- Идемпотентность создания заказа: предотвращение дублирования резерва при повторном нажатии покупателем кнопки оформления заказа.
Оформление заказа и прием онлайн-оплаты
Процесс чекаута в боте должен быть максимально коротким. Каждое лишнее поле ввода отсекает часть конверсии. Бот последовательно запрашивает способ получения (самовывоз или доставка курьером), адрес доставки и контактный телефон. Для номера телефона используется специальная кнопка с запросом контакта (SendContact), которая передает подтвержденный номер из профиля Telegram в один клик.
Прием оплаты организуется двумя путями: через нативный Telegram Payments API или через генерацию внешней платежной ссылки на шлюз банка. Нативный механизм открывает платежную форму прямо внутри Telegram, что дает минимальное число переходов и высокую конверсию. Telegram сам валидирует платеж и шлет бэкенду запрос предварительной проверки pre_checkout_query. Бэкенд обязан ответить вызовом answerPreCheckoutQuery в течение десяти секунд, предварительно перепроверив актуальность цен и наличие резерва.
После подтверждения транзакции бот получает уведомление successful_payment. На бэкенде запускается генерация фискального чека через онлайн-кассу и смена статуса заказа на оплаченный. Подробный разбор интеграции эквайринга, обработки вебхуков и фискализации смотрите в отдельной статье про приём платежей в Telegram, а требования к безопасности повторных вызовов описаны в материале про идемпотентность и повторы API.
Связь с 1С и CRM: синхронизация каталога, цен и заказов
Интернет-магазин в Telegram не должен быть изолированным островом. Если учет товаров ведется в 1С:Управление торговлей, МойСклад или CRM-системе (Битрикс24, amoCRM), бот обязан работать с ними в едином информационном поле. Заказы из мессенджера должны мгновенно попадать к операторам склада, а изменения цен и остатков в учетной системе — отражаться в каталоге бота.
Прямые синхронные вызовы из обработчика Telegram к 1С недопустимы. Если сервер 1С проводит тяжелое закрытие месяца или временно перегружен, синхронный вебхук бота упадет по таймауту, и покупатель увидит ошибку в чате. Интеграция строится асинхронно через промежуточную очередь задач. Бэкенд бота немедленно фиксирует заказ у себя в базе, а фоновый сервис доставляет документ в учетную систему с механизмом повторов при сбоях.
Обновление товарного каталога обычно настраивается через регламентный импорт по расписанию или через получение вебхуков об изменении карточек номенклатуры. Подробные схемы взаимодействия, форматы CommerceML, REST API и протоколы обмена мы разобрали в статьях про интеграцию телеграм-бота с 1С и про методы интеграции CRM и ERP.
Админка и обработка заказов: чат менеджеров или веб-панель?
Кто-то должен обрабатывать поступившие заказы: подтверждать доставку, печатать накладные, менять статусы и связываться с покупателями. На этапе небольших объемов продаж полноценная веб-панель часто оказывается избыточной. Всю диспетчеризацию можно вынести в закрытую группу Telegram для сотрудников.
При создании нового заказа бот отправляет карточку в служебный чат операторов. В сообщении выводятся состав корзины, адрес, телефон и кнопки смены статусов («В сборке», «Передан курьеру», «Выполнен», «Отменен»). Нажатие кнопки сотрудником обновляет сообщение в служебной группе, фиксирует автора действия и отправляет мгновенное уведомление покупателю в личный чат с ботом.
Однако по мере масштабирования чат сотрудников превращается в источник путаницы: в нем сложно строить аналитику, фильтровать заказы по городам, массово выгружать накладные или управлять правами доступа. Когда объем растет, бизнес переходит на веб-интерфейс или передает управление заказами напрямую в CRM, оставляя боту только роль канала уведомлений.
- Обработка заказов в Telegram-чате подходит: на старте магазина, при небольшом потоке заказов и команде из одного-трех операторов.
- Мгновенные статусы покупателю: любое действие менеджера по заказу сразу транслируется покупателю в чат-бот без задержек.
- Ограничения чата: отсутствие сквозной аналитики, невозможность построить финансовые отчеты и риск потерять заказ в потоке сообщений.
- Веб-панель или CRM необходимы: при наличии нескольких складов, сложной логистики, десятков менеджеров и необходимости печати накладных.
Бот с кнопками, Telegram Mini App или сайт: что выбрать
Попытка встроить огромный супермаркет на тысячи позиций в обычный чат с кнопками обречена на провал. Пользователю тяжело листать десятки экранов сообщений в поисках нужного товара. Для каждого типа онлайн-бизнеса подходит свой баланс инструментов.
Обычный бот на текстовых сообщениях и inline-кнопках идеален для лаконичного каталога, продажи цифрового контента, подписок, доставки пиццы или воды и быстрого оформления повторных покупок. Если же у вас магазин одежды с десятком фильтров, корзиной на много позиций и фотогалереями, естественным решением становится Telegram Mini App. Это полноценный веб-интерфейс, который открывается прямо внутри Telegram без перехода в браузер. Подробнее об этой технологии читайте в статье про Telegram Mini Apps.
При этом классический сайт интернет-магазина остается незаменимым для поискового SEO-трафика и пользователей за компьютером. В зрелом бизнесе Telegram-бот или Mini App не заменяют веб-сайт, а служат высококонверсионным каналом повторных продаж для удержания постоянной аудитории.
- Обычный чат-бот с inline-кнопками: до тридцати позиций, монопродукты, услуги, доставка типовых наборов, цифровые товары, заказ в два клика.
- Telegram Mini App: визуальный каталог, одежда, косметика, электроника, сложные фильтры, удобная корзина на десятки товаров.
- Классический веб-сайт: органический поисковый трафик из поисковиков, оптовые продажи, многостраничные каталоги со сложной структурой.
- Связка сайта и бота: привлечение первичного трафика через сайт или рекламу, а удержание и повторные заказы — через бота в телефоне клиента.