Как открывают мини-приложение

Что это

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

Как сделать

1. Кнопка меню: команда /setmenubutton в @BotFather задаёт её текст и адрес, а… Кнопка меню: команда /setmenubutton в @BotFather задаёт её текст и адрес, а метод `setChatMenuButton` меняет её для отдельного человека.
2. Главное мини-приложение (Bot Settings → Configure Mini App): кнопка запуска в… Главное мини-приложение (Bot Settings → Configure Mini App): кнопка запуска в профиле бота и место во вкладке приложений в поиске у тех, кто его уже запускал.
3. Ссылки: `t.me/<бот>?startapp=<метка>` открывает главное мини-приложение,… Ссылки: `t.me/<бот>?startapp=<метка>` открывает главное мини-приложение, `t.me/<бот>/<приложение>?startapp=<метка>` — одно из именованных приложений бота, оба прямо в том чате, где нажали ссылку. Добавь `&mode=compact`, чтобы открыть на половину экрана, или `&mode=fullscreen` для полноэкранного режима.
4. Кнопки: инлайн-кнопка или кнопка клавиатуры типа `web_app`.
5. Заявки на вступление: с июня 2026 года бот, который разбирает заявки в чат… Заявки на вступление: с июня 2026 года бот, который разбирает заявки в чат (guard bot), может показать желающим вступить мини-приложение.
6. Меню вложений: `t.me/<бот>?startattach`, только для крупных рекламодателей… Меню вложений: `t.me/<бот>?startattach`, только для крупных рекламодателей Telegram Ad Platform; на тестовом сервере его может попробовать любой бот.

Осторожно

• Инлайн-кнопки и кнопки клавиатуры с мини-приложением работают только в личном чате с ботом.
• Приложение, открытое кнопкой клавиатуры, ничего не знает о человеке, а `sendData` закрывает его, отправив боту до 4096 байт.
• Именованное приложение, открытое по ссылке, не читает и не пишет сообщения в чате; его идентификатора чата `chat_instance` хватает для общих игр и досок в группе.

С Gem

Своего бота, кнопки меню и меню вложений Gem не даёт. Вместо этого у каждого проекта есть ссылка `t.me/gembot?startapp=<имя>`: она открывает проект внутри мини-приложения Gem, и нажимать «Старт» не нужно.

Источники

• https://core.telegram.org/bots/webapps#implementing-mini-apps
• https://core.telegram.org/api/links#main-mini-app-links

Открыть в Telegram ↗