Как загрузить Mini App в Telegram Store: пошаговая инструкция по публикации и прохождению модерации

Ты создал Mini App для Telegram - и теперь хочешь, чтобы ею пользовались тысячи людей. Но как её вообще загрузить в Telegram Store? Это не просто нажать кнопку «Опубликовать». Тут есть правила, проверки, требования и даже скрытые ловушки, которые могут отклонить твою аппку без объяснений. В этой инструкции - всё, что нужно знать, чтобы пройти модерацию и выйти в Store без задержек.

Что такое Mini App в Telegram

Mini App - это лёгкое веб-приложение, которое работает прямо внутри Telegram. Нет необходимости скачивать отдельное приложение. Пользователь открывает бота, нажимает кнопку - и сразу видит интерфейс: игру, калькулятор, магазин, чат-бота с UI, сервис бронирования. Все Mini App работают на HTML, CSS и JavaScript. Они подключаются к Telegram через Bot API и используют Telegram’s Web App SDK.

Telegram Store - это каталог, где можно найти все публичные Mini App. Там уже есть приложения для заказа еды, управления финансами, обучения языкам, а также игры. Чтобы попасть туда, нужно не просто запустить бота - нужно пройти официальную публикацию.

Подготовка Mini App к публикации

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

• Домен должен быть HTTPS. Без шифрования - не пройдёт. Даже если твой сайт работает на localhost, для публикации нужен реальный SSL-сертификат.
• Приложение должно работать на мобильных устройствах. Тестируй на iPhone и Android. Если кнопки не нажимаются, текст мельчает или скролл лагает - модераторы отклонят.
• Используй Telegram Web App SDK. Без него твоя Mini App не сможет взаимодействовать с Telegram: не получит данные пользователя, не откроет клавиатуру, не отправит сообщение. Подключи библиотеку через <script src="https://telegram.org/js/telegram-web-app.js"></script>.
• Не используй сторонние рекламные сети. Google AdSense, Meta Ads, AnyTrack - всё это запрещено. Даже если ты хочешь монетизировать, Telegram не разрешает показывать рекламу внутри Mini App.
• Не копируй существующие приложения. Если твоя Mini App - копия популярной игры или сервиса, её отклонят как плагиат.

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

Создание бота для Mini App

Каждая Mini App привязана к боту. Без бота - нет доступа в Store.

1. Создай бота через BotFather. Получи токен.
2. Установи команду /start, которая будет открывать твою Mini App. Используй кнопку web_app в клавиатуре.
3. Настрой вебхук или используй long polling, чтобы бот мог получать данные от пользователя.
4. В ответе на команду /start отправь сообщение с кнопкой, которая открывает твой URL. Пример:

{
  "text": "Открой приложение!",
  "reply_markup": {
    "inline_keyboard": [[
      {
        "text": "Открыть Mini App",
        "web_app": {
          "url": "https://tvoi-app.example.com"
        }
      }
    ]]
  }
}

Убедись, что URL в web_app.url совпадает с доменом, который ты зарегистрируешь в Telegram. Если URL отличается даже на один символ - приложение не запустится.

Регистрация Mini App в Telegram Store

Теперь самое важное - отправка на публикацию.

1. Зайди в BotFather.
2. Напиши команду /mybots и выбери своего бота.
3. Нажми Manage Mini App.
4. Введи URL твоего приложения - тот же, что и в кнопке.
5. Загрузи иконку размером 128×128 пикселей в формате PNG. Она должна быть чёткой, без фона, без текста.
6. Напиши название (до 30 символов) и описание (до 120 символов). Не используй слова вроде «лучший», «самый быстрый» - модераторы их игнорируют.
7. Укажи язык интерфейса приложения. Telegram поддерживает 20+ языков.
8. Нажми Submit for Review.

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

Что происходит во время модерации

Модерация занимает от 2 до 7 дней. Ты не получишь уведомления в Telegram - только по email. В этот период Telegram проверяет:

• Работает ли приложение на реальных устройствах (iOS и Android).
• Нет ли в коде вредоносных скриптов, фишинга, криптомайнеров.
• Соответствует ли описание реальному функционалу.
• Есть ли нарушения правил Telegram: спам, пропаганда, нарушение авторских прав.
• Использует ли приложение Telegram Web App SDK корректно.

Если что-то не так - ты получишь письмо с причиной. Частые причины отказа:

• Сайт не открывается на мобильных устройствах.
• URL в кнопке и в настройках Mini App отличаются.
• Иконка не соответствует формату (например, JPG вместо PNG, или размер 100×100).
• Приложение требует доступ к контактам, камере или геолокации без явной необходимости.
• В описании есть слова «бесплатно», «без регистрации», «вирусный» - это триггеры для ручной проверки.

Если приложение отклонили - не спеши пересылать. Исправь ошибку, проверь всё заново на телефоне, и только потом отправляй повторно.

После публикации: что делать

Ты прошёл модерацию - поздравляем. Теперь твоя Mini App появится в Telegram Store. Но это только начало.

• Создай пост в Telegram-канале с прямой ссылкой на бота. Используй кнопку https://t.me/твой_бот?start=app.
• Попроси пользователей оценить приложение в Store. Уровень рейтинга влияет на видимость.
• Следи за отзывами. Если люди пишут «не открывается на iPhone» - проверь совместимость с iOS.
• Обновляй приложение. Telegram позволяет обновлять Mini App без повторной модерации, если ты не меняешь URL, иконку или функционал. Но если добавляешь новые права - нужно отправить на проверку снова.

Ты можешь отслеживать статистику: сколько пользователей открыли приложение, сколько раз нажимали кнопки, сколько времени провели внутри. Это данные приходят в Bot API через web_app_data.

Частые ошибки и как их избежать

Многие разработчики теряют неделю на повторные отправки из-за простых ошибок.

• Ошибка 1: Используют HTTP вместо HTTPS. Решение: купи дешёвый SSL-сертификат на Cloudflare - он бесплатный и настраивается за 5 минут.
• Ошибка 2: Загружают иконку с прозрачным фоном, но в PNG с альфа-каналом. Решение: убери фон, сделай белый или чёрный - Telegram не поддерживает прозрачные иконки.
• Ошибка 3: Пишут в описании «самое популярное приложение». Решение: пиши только факты: «Считает калории по фото еды».
• Ошибка 4: Тестируют только на ПК. Решение: всегда тестируй на реальном iPhone и Android. Многие JS-библиотеки ведут себя по-разному на мобильных браузерах.

Совет: перед отправкой сделай скриншоты интерфейса на iOS и Android - приложи их к письму, если модераторы попросят. Это сократит время проверки.

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

Есть простые правила, которые повышают вероятность одобрения на 70%.

• Сделай приложение, которое решает одну конкретную задачу. Не пытайся сделать «всё и сразу».
• Используй стандартные элементы интерфейса Telegram: кнопки, панели, всплывающие окна. Не создавай свои стили - они могут не работать.
• Добавь загрузочный экран. Если приложение грузится дольше 2 секунд - пользователь уйдёт. Покажи анимацию с логотипом Telegram.
• Убедись, что приложение работает без интернета хотя бы в базовом режиме. Например, калькулятор может сохранять историю в localStorage.
• Проверь, что все ссылки внутри приложения ведут на твой домен. Никаких внешних редиректов.

Если ты сделал всё правильно - твоя Mini App не просто пройдёт модерацию. Она может стать одним из первых популярных приложений в Store. Уже сейчас в Telegram Store больше 5000 Mini App. Но только 15% из них получают больше 1000 уникальных пользователей в месяц. Ты можешь быть в этой пятерке.