Как размещать Mini App в каталоге Telegram

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

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

Что такое каталог Mini Apps в Telegram

В Telegram есть раздел Apps, где пользователи могут находить мини-приложения. В каталоге отображаются не все существующие Mini Apps.

Важно различать три понятия:

• Mini App — приложение, которое работает внутри Telegram;
• Main Mini App — основное мини-приложение, настроенное для конкретного бота;
• каталог Mini Apps — раздел Telegram, в котором могут показываться соответствующие требованиям приложения.

Если для бота настроено Main Mini App, в его профиле появляется кнопка запуска приложения. Также Telegram может показывать такой бот во вкладке Apps в поиске пользователям, которые уже запускали приложение.

Можно ли вручную отправить Mini App в каталог

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

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

Что нужно для попадания Mini App в каталог Telegram

Для каталога Top Mini Apps Telegram указывает несколько основных условий.

Условие	Что требуется
Main Mini App	Основное приложение должно быть настроено через BotFather
Аудитория	Более 1 000 ежедневных пользователей
Выручка	Более 1 000 Stars в день по среднему значению за неделю
Монетизация	Для возможности featured-размещения приложение должно принимать платежи в Telegram Stars

Каталог ранжирует Mini Apps с учетом их ежедневной выручки, выраженной в Stars.

Настройка Main Mini App

Первое обязательное условие — настройка Main Mini App через BotFather.

Main Mini App связывает основное приложение с Telegram-ботом. После настройки в профиле бота появляется заметная кнопка запуска, через которую пользователь может открыть сервис.

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

Более 1 000 ежедневных пользователей

Для попадания в соответствующий каталог Mini App должно иметь более 1 000 пользователей в день.

Речь идет именно о daily users. Этот показатель нельзя заменять количеством подписчиков бота, месячной аудиторией или общим числом запусков за все время.

Достижение необходимой аудитории само по себе также не гарантирует отдельного featured-размещения.

Более 1 000 Stars выручки в день

Еще одно условие — средняя дневная выручка приложения должна превышать 1 000 Telegram Stars.

При расчете используется среднее значение за неделю. Поэтому единичный день с высокой выручкой не означает, что требование автоматически выполнено.

Важно также не путать два показателя: более 1 000 ежедневных пользователей и более 1 000 Stars дневной выручки — это отдельные условия.

Как настроить Main Mini App через BotFather

Основное Mini App настраивается через официального бота BotFather.

Откройте настройки своего бота

Запустите BotFather и перейдите к управлению ботом, к которому должно быть привязано приложение.

Выберите нужного бота и откройте настройки Mini App.

Названия отдельных пунктов интерфейса Telegram со временем могут изменяться, поэтому ориентироваться лучше на раздел настройки основного приложения.

Настройте основное приложение

При настройке Main Mini App необходимо связать бота с адресом работающего веб-приложения.

После сохранения параметров следует проверить, что Mini App:

• открывается без ошибок;
• корректно работает внутри Telegram;
• нормально отображается на мобильных устройствах;
• позволяет пройти основные пользовательские сценарии.

Проверьте кнопку запуска

После успешной настройки Main Mini App в профиле бота должна появиться кнопка запуска приложения.

Она позволяет пользователю открыть Mini App непосредственно из профиля, без дополнительных команд и сообщений.

Как оформить Mini App перед продвижением

Одной технической настройки недостаточно. Telegram отдельно рекомендует качественно оформить представление приложения.

Добавьте скриншоты и видео

В профиль Main Mini App можно добавить изображения и видеоматериалы, показывающие возможности сервиса.

Лучше демонстрировать:

• основной интерфейс;
• ключевые функции;
• реальные сценарии использования;
• наиболее понятные и полезные экраны.

Изображения должны помогать пользователю быстро понять назначение приложения, а не просто выполнять роль рекламных баннеров.

Подготовьте локализованные превью

Telegram поддерживает разные языковые версии демонстрационных материалов.

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

Проверьте качество интерфейса

Перед продвижением убедитесь, что приложение удобно использовать непосредственно внутри Telegram.

Особое внимание стоит уделить:

• скорости загрузки;
• понятной навигации;
• адаптации под мобильные экраны;
• отсутствию критических ошибок;
• стабильной работе основных функций.

Telegram также рекомендует разработчикам соблюдать официальные рекомендации по дизайну Mini Apps.

Как пользователи могут находить Mini App без каталога

Каталог — не единственный способ распространения мини-приложения. Пользователи могут открывать Mini App и до его появления в Top Mini Apps.

Через профиль бота

Если Main Mini App настроено, приложение можно открыть через кнопку в профиле Telegram-бота.

Это один из самых простых способов дать существующей аудитории доступ к сервису.

Через прямую ссылку

Main Mini App поддерживает запуск через специальную ссылку формата:

t.me/botusername?startapp

В нее также можно передавать дополнительный параметр startapp, например для запуска определенного сценария приложения.

Через поиск Telegram

Боты с настроенным Main Mini App могут отображаться во вкладке Apps поиска у пользователей, которые ранее запускали приложение.

Это не следует путать с попаданием в общий каталог популярных или featured Mini Apps.

Почему Mini App не появляется в каталоге

Если приложение уже работает, но не отображается в каталоге, возможны несколько причин:

• Main Mini App не настроено;
• приложение не набрало более 1 000 ежедневных пользователей;
• средняя дневная выручка ниже 1 000 Stars;
• приложение не соответствует условиям конкретного раздела каталога;
• разработчик ожидает автоматической публикации сразу после подключения Mini App к боту.

Не стоит ориентироваться на неподтвержденные сведения о сроках модерации или скрытых правилах Telegram. Платформа не раскрывает полный набор алгоритмов отбора featured-приложений.

Гарантирует ли выполнение требований попадание в каталог

Необходимо разделять выполнение минимальных условий каталога и featured-размещение.

Telegram указывает, что успешные Mini Apps могут быть представлены в Mini App Store. Для повышения шансов платформа рекомендует:

• включить Main Mini App;
• добавить качественные демонстрационные материалы;
• принимать платежи в Telegram Stars;
• соблюдать рекомендации по дизайну.

Поэтому утверждать, что выполнение определенного набора действий гарантирует продвижение приложения со стороны Telegram, нельзя.

Как повысить видимость Mini App

Разработчику стоит сосредоточиться прежде всего на качестве продукта и активности пользователей.

Для этого рекомендуется:

1. Настроить Main Mini App.
2. Полностью оформить профиль бота.
3. Добавить понятные скриншоты и видео.
4. Проверить стабильность работы приложения.
5. Привлекать реальных активных пользователей.
6. Улучшать сценарии повторного использования.
7. При подходящей бизнес-модели принимать платежи в Stars.
8. Следовать рекомендациям Telegram по интерфейсам Mini Apps.

Не стоит пытаться искусственно имитировать аудиторию или выручку. Telegram не публикует данных о том, что такие действия могут помочь ранжированию.

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

Нужно ли подавать заявку на добавление Mini App в каталог Telegram

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

Сколько пользователей нужно для попадания в каталог

Для рассматриваемого каталога Telegram указывает более 1 000 ежедневных пользователей.

Какая выручка в Stars требуется

Средняя дневная выручка должна превышать 1 000 Telegram Stars с учетом среднего показателя за неделю.

Обязательно ли настраивать Main Mini App

Да. Настройка Main Mini App через BotFather входит в требования для включения приложения в соответствующий каталог.

Появится ли приложение сразу после настройки BotFather

Нет оснований рассчитывать на мгновенное автоматическое появление в общем каталоге. Настройка Main Mini App — только один из необходимых этапов.

Можно ли использовать Mini App без попадания в каталог

Да. Mini Apps можно запускать через профиль бота, кнопки, меню, прямые ссылки и другие предусмотренные Telegram способы.

Можно ли гарантированно попасть в Mini App Store

Нет. Telegram не обещает featured-размещение каждому приложению даже при правильной технической настройке.

Краткий чек-лист перед размещением

Перед продвижением Mini App проверьте:

• приложение связано с Telegram-ботом;
• Main Mini App настроено через BotFather;
• кнопка запуска работает;
• добавлены качественные скриншоты и видео;
• интерфейс корректно работает на мобильных устройствах;
• приложение имеет достаточную активную аудиторию;
• выполнены актуальные требования по выручке в Stars.

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