Ошибки модерации Telegram Mini Apps: технический чек-лист
Наша компания выполняет разработку Mini App в Телеграм на российских сервисах — VK Cloud, Selectel, ЮKassa, СБП, Яндекс.Метрика, — и знает, как подготовить проект к модерации без доработок.
1. Неофициальные API
Telegram проверяет источник SDK и домен загрузки. Любые сторонние или форкнутые версии telegram-web-app.js — причина отказа.
Используйте именно эту ссылку. Проверяйте initData на сервере и не храните токены в localStorage.
2. Авторизация
Не реализуйте собственные формы логина. Авторизация должна выполняться через встроенный initData. Проверку подписи выполняйте на сервере:
hash = hashlib.sha256(f"{data}{secret_key}".encode()).hexdigest()
Telegram сверяет эту подпись при ревью. Ошибка авторизации — мгновенный отказ.
3. UX и SDK-гайды
Telegram ревьюеры проверяют наличие MainButton и BackButton. Если пользователь не может выйти из Mini App корректно, ревью не проходит. Настройка кнопки:
Telegram.WebApp.BackButton.show();
Telegram.WebApp.BackButton.onClick(() => Telegram.WebApp.close());
Также важно, чтобы Mini App адаптировался под themeParams.
4. Платежи
Используйте только официальные шлюзы. Для России подходят ЮKassa и СБП.
Telegram.WebApp.openInvoice({ slug: «order_payment» });
Добавляйте подтверждение и логи в Яндекс.Метрике. Telegram проверяет прозрачность транзакций.
5. Производительность
TTI должен быть ≤ 1.5 с. Проверяйте через Lighthouse или встроенную метрику Telegram. Храните ассеты на VK Cloud CDN или Selectel Object Storage. Избегайте синхронных запросов и тяжёлых анимаций.
6. Privacy Policy
Ссылка обязательна:
Telegram.WebApp.openLink("https://yourapp.ru/privacy");
Без неё ревью не начнётся.
Итог
Telegram модерация — это технический и UX-чек-лист. Если Mini App стабилен, безопасен и визуально консистентен, он пройдёт ревью за один цикл. Наша компания выполняет разработку и тестирование мини-приложений в Телеграм, создавая быстрые, безопасные и соответствующие требованиям Telegram Mini Apps на российских платформах — VK Cloud, Selectel, ЮKassa, СБП, Яндекс.Метрика.