Каталог в Telegram Mini App: что нужно кроме карточек товаров

Проверьте, нужен ли каталогу отдельный интерфейс

Представим небольшую компанию, которая продаёт расходные материалы постоянным клиентам. В переписке неудобно искать нужный размер, сравнивать упаковки и повторять прошлую закупку. Здесь Mini App может дать понятный экран выбора. Но если покупателю всегда нужны две фиксированные позиции, обычных кнопок бота иногда достаточно. Решение стоит выбирать по действию клиента, а не по популярности формата.

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

Приведите товарные данные в порядок

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

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

Сделайте поиск понятным вашему покупателю

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

Продумайте результат без совпадений: предложить убрать фильтр, изменить запрос или написать специалисту. Если клиент открывает карточку и возвращается назад, желательно сохранить позицию списка и выбранные условия. В Mini App это особенно заметно на телефоне: повторная прокрутка длинного каталога раздражает сильнее, чем отсутствие декоративной анимации. Удобный возврат — полноценное требование, которое стоит включить в приёмку.

Разделите интерфейс и подтверждённый заказ

Документация Telegram прямо требует проверять переданные Mini App данные на сервере; объект с названием initDataUnsafe нельзя принимать как доказательство личности. Для владельца смысл простой: имя на экране ещё не разрешает доступ к чужим заказам. Разработчик должен подтвердить источник данных и проверить права перед действиями с личной информацией.

Цены, скидки и итог тоже рассчитываются на доверенной стороне, а не принимаются из браузера как готовая сумма. Перед сохранением заказа система сверяет позиции и доступность по выбранным правилам. Если цена изменилась, покупатель видит обновление и подтверждает его. Тайно подменять итог или создавать заказ с устаревшим составом нельзя считать нормальной обработкой исключения.

Определите, как продолжить незавершённый выбор

Человек может закрыть приложение, отвлечься на сообщение и вернуться позже. Решите, что произойдёт с корзиной и на какой срок она сохраняется. Сохранённый выбор не обязан резервировать складской остаток. Эти вещи лучше разделять: корзина помогает продолжить покупку, резерв ограничивает доступность товара для других клиентов и требует собственных правил.

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

Проверьте каталог внутри Telegram

Страница в обычном браузере и Mini App внутри мессенджера — разные условия использования. Пройдите основной сценарий на согласованных клиентах Telegram, включая мобильные устройства. Проверьте тему, доступное место под клавиатуру, закрытие окна, возврат назад и удобство нижней кнопки. Платформа предоставляет средства работы с интерфейсом, но правильное поведение конкретного приложения нужно наблюдать лично.

Если предусмотрена оплата, отдельно согласуйте тип товаров и допустимый платёжный сценарий по актуальным правилам Telegram и провайдера. Не переносите автоматически схему обычного сайта в мессенджер. На этапе каталога без оплаты достаточно честно показать статус «Заказ получен» и следующий шаг менеджера. Это самостоятельный полезный результат, когда бизнес подтверждает условия вручную.

Запускайте измеряемую первую версию

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

При передаче нужны доступы к боту, серверу, товарным данным и инструкции для обновления. Согласуйте, кто замечает сбой обмена и как восстанавливается каталог. В OBSION такой проект удобно начинать с образца товарной базы и одного типичного заказа. По ним можно отделить нужный интерфейс от функций, которые пока не дают покупателю или команде ощутимой пользы.

Что проверить в своей задаче

1. Определены основной заказ и путь его обработки сотрудником.
2. Проверены артикулы, варианты, цены и источник остатков.
3. Сервер подтверждает данные Telegram, права и итог заказа.
4. Корзина, возврат и повтор заказа работают по понятным правилам.
5. Проверка проведена внутри согласованных клиентов Telegram.