Справочник: мини-приложения в Telegram

В документации Telegram этот раздел называется «Telegram Mini Apps». Мини-приложение — это интерфейс на JavaScript, который запускается прямо внутри Telegram и может заменить сайт [4]. Факты на этой странице — из документации Telegram, проверено 30.10.2026.

Как открывается. Мини-приложение связано с ботом. Способов запуска семь [4]:

• главное мини-приложение — кнопкой в профиле бота;
• кнопкой клавиатуры бота;
• кнопкой под сообщением бота;
• кнопкой меню бота;
• через inline-режим — в любом чате;
• по прямой ссылке вида t.me/имя_бота?startapp=…: параметр после startapp приложение получит при запуске — например, номер стола или код акции;
• из меню вложений.

Как подключить. Мини-приложение — обычный сайт. В <head> подключают скрипт telegram-web-app.js; после этого приложению доступен объект window.Telegram.WebApp [4]. Кнопку меню и главное мини-приложение настраивают у бота @BotFather [4].

Что умеет (по документации, проверено 30.10.2026) [4]:

• телефон пользователя — только если пользователь сам согласится в окне мессенджера (requestContact);
• QR-код — сканировать в окне Telegram (showScanQrPopup);
• хранилище — облачное (CloudStorage), на устройстве (DeviceStorage) и защищённое на устройстве (SecureStorage);
• биометрия — BiometricManager;
• геопозиция — LocationManager, с разрешения пользователя;
• полноэкранный режим и ярлык на главном экране телефона.

Проверка данных пользователя. Данные запуска приходят в поле initData. Перед использованием их нужно проверить на своём сервере — в документации описана проверка подписи [4].

Монетизация (кратко). Физические товары и услуги — через платёжных провайдеров; цифровые — только во внутренней валюте мессенджера (Stars) [7]. Сам этот сайт ничего не продаёт.

Что учесть в России. Telegram — иностранный сервис. С 2025 года Роскомнадзор ограничивает его работу в России, в том числе звонки [11]. Перед запуском проверьте, как приложение работает у ваших пользователей. Банкам, финансовым компаниям, операторам связи, маркетплейсам, госорганам и некоторым другим организациям закон запрещает информировать граждан через иностранные мессенджеры [10]. Если приложение собирает персональные данные, его владелец — оператор персональных данных: нужны политика, согласие, если нет другого основания, уведомление Роскомнадзора и хранение данных граждан России в России [9].