Создать мини-приложение в Telegram без программиста можно в три шага: собрать страницу в конструкторе, один раз создать приложение бота в @BotFather командой /newapp и включить страницу в кабинете. Вы получите ссылку вида t.me/ваш_бот/имя?startapp=адрес. Человек нажимает её, страница открывается прямо в Telegram, без браузера, и он сразу становится контактом вашего бота. Ниже — каждый шаг подробно, что видит человек, что делает бот и как открыть внутри Telegram свой сайт вместо страницы.
Что такое мини-приложение Telegram
Мини-приложение (Telegram Mini App) — это веб-страница, которая открывается окном внутри Telegram, поверх чата с ботом. Устанавливать ничего не нужно. Главное отличие от обычной ссылки на сайт в том, что Telegram сам сообщает боту, кто открыл страницу.
- Обычная ссылка на сайт уводит человека в браузер. Кто это был и дошёл ли он потом до бота, вы не знаете.
- Мини-приложение оставляет человека в Telegram. Бот видит его сразу: может поставить метку, запустить сценарий и написать ему позже, если человек разрешит сообщения.
Поэтому мини-приложение удобно там, где ссылку нажимают из Telegram: в посте канала, в рекламе у блогера, в рассылке бота. Человек смотрит страницу и не теряется по дороге в браузер.
Что можно открыть как мини-приложение без кода
В ЭТОЧАТБОТЕ мини-приложением открывается любая страница из конструктора страниц. Писать код и искать хостинг не нужно: страница собирается из готовых блоков, а адрес с https у неё уже есть.
- Мини-лендинг — картинка, заголовок, пара строк и кнопки. Подходит для рекламы, подарка за подписку, записи. Работает на тарифах «Плюс» и «Премиум».
- Мультиссылка — страница со всеми контактами, ссылками и блоками, как ссылка в шапке профиля. Тариф «Премиум».
- Форма, квиз, опрос или тест — вопросы по одному на экран, итог и кнопка в бота. Тариф «Премиум».
- Свой сайт — вместо страницы откроется ваш сайт, об этом отдельный раздел ниже. Тариф «Премиум».
Чего так не сделать: игру, приложение со своим кодом и своей базой, оплату прямо на странице. Для продаж с корзиной и оплатой есть отдельная витрина — о ней статья «Каталог товаров в Telegram: витрина в мини-приложении».
Что понадобится, чтобы создать мини-приложение
- Бот в Telegram, подключённый к ЭТОЧАТБОТУ. Если бота ещё нет, его создают в @BotFather за пару минут — по шагам в статье «BotFather: как создать бота в Telegram».
- Доступ к аккаунту Telegram, который создавал бота. Приложение в @BotFather может создать только владелец бота. Если бота делал подрядчик, этот шаг сделает он — или сначала передаст бота вам.
- Тариф «Плюс» или «Премиум» у аккаунта бота. На бесплатном «Старте» раздела нет.
- Картинка 640 × 360 — любая, её покажут при первом открытии.
Шаг 1. Соберите страницу и закрепите адрес
В меню аккаунта, в группе «Страницы», выберите вид — мини-лендинг, мультиссылку или форму — и создайте страницу с чистого листа или из шаблона. Редактор показывает страницу на экране телефона, поэтому сразу видно, как её увидят в Telegram. Если мини-лендинг вы делаете впервые, пригодится статья «Мини-лендинг: что это и как сделать для чат-бота».
Когда страница готова, опубликуйте её и закрепите адрес. Адрес выбирается один раз и потом не меняется. Именно по нему строится ссылка на мини-приложение, так что ссылка в постах и рекламе не сломается.
Шаг 2. Создайте приложение бота в @BotFather
Это делается один раз на бота. Дальше у каждой вашей страницы будет своя ссылка, а в @BotFather возвращаться не придётся. Откройте в меню аккаунта бота пункт «Мини-приложение»: там те же пять шагов и адрес вашего бота, готовый для копирования.
- Откройте @BotFather, отправьте команду
/newappи выберите своего бота. - Название, описание и картинку 640 × 360 задайте любые — их увидят при первом открытии. Вопрос про GIF пропустите командой
/empty. - Когда BotFather спросит адрес, вставьте адрес из кабинета. Он выглядит как
https://tg.eto.site/?b=…, у каждого бота свой. - Придумайте короткое имя приложения, например
page. Ссылка будетt.me/ваш_бот/page. - Вставьте ссылку, которую пришлёт BotFather, в поле в кабинете и нажмите «Подключить».
Короткое имя выберите сразу удачное. Если позже подключить другое мини-приложение, ссылки на страницы изменятся, а те, что уже стоят в постах и рекламе, перестанут работать. Ссылку от чужого бота кабинет не примет и подскажет, что она от другого бота.
Шаг 3. Включите страницу и скопируйте ссылку
Ниже в том же разделе «Мини-приложение» — список ваших страниц с переключателями. Включите нужную, и под ней появится ссылка вида https://t.me/ваш_бот/page?startapp=адрес-страницы с кнопкой «Копировать». Переключатель работает сразу, публиковать страницу заново не нужно.
В списке есть страницы из всех ваших аккаунтов, поэтому через бота можно открыть и страницу, сделанную для другого аккаунта. Если вид страницы не входит в тариф — например, квиз на «Плюсе», — переключатель будет неактивен, а рядом появится подсказка. Ссылка без хвоста, просто t.me/ваш_бот/page, откроет последнюю опубликованную страницу, включённую для этого бота.
Что происходит, когда человек открывает ссылку
Страница открывается окном внутри Telegram. Дальше бот работает так:
- Человек становится контактом бота. Telegram передаёт, кто открыл страницу, поэтому вводить телефон или нажимать «Старт» не нужно. В переписке появляется строка «Открыл в Telegram страницу «…»», а в карточке контакта виден источник.
- Метка. Если указать метку, её получит каждый, кто открыл страницу. По ней удобно отбирать людей для рассылок.
- Сценарий. Можно запустить сценарий с начала или с нужного шага: прислать подарок, предложить запись, задать первый вопрос. Он срабатывает один раз для каждого человека, повторное открытие новых сообщений не принесёт.
- Разрешение на сообщения. Написать первым бот может, только если человек уже писал ему или разрешил сообщения. Поэтому, если человек ещё не писал боту, при открытии Telegram покажет окно с вопросом, можно ли боту ему писать. Согласился — сценарий запускается. Отказался — человек остаётся контактом, но сценарий не стартует. Больше одного раза в неделю этот вопрос не задаётся.
Всё это настраивается у самой страницы: «Настройки страницы» → «Мини-приложение» → «Когда человек открыл». Там выбирается сценарий и шаг, с которого он начнётся, метка и переключатель «Спрашивать разрешение на сообщения». Он включён по умолчанию: без разрешения бот не сможет написать первым. Если страница уже опубликована, нажмите «Обновить», чтобы изменения заработали.
Кнопки на странице тоже работают: ссылки на Telegram откроются в нём же, остальные — в браузере.
Свой сайт внутри Telegram
Если сайт у вас уже есть — на Тильде, на другом конструкторе или написанный разработчиком, — на тарифе «Премиум» его можно открыть внутри Telegram вместо страницы. Так получается сайт в Telegram-боте без доработок самого сайта: человек видит ваш сайт, а бот получает то же, что и со страницей, — новый контакт, метку и сценарий.
Как подключить
- Подключите бота в @BotFather, как в шаге 2, если ещё не сделали этого.
- Возьмите любую опубликованную страницу с закреплённым адресом. Она станет основой ссылки, сам человек её не увидит.
- В её настройках откройте «Мини-приложение», включите «Открывать как мини-приложение» и в блоке «Что показать» выберите «Мой сайт».
- Вставьте полный адрес сайта, начиная с
https://, и нажмите «Обновить».
Ссылка остаётся прежней — t.me/ваш_бот/page?startapp=адрес-страницы. По ней человек попадает на ваш сайт, но уже внутри Telegram.
Какой сайт подойдёт
- Адрес начинается с
https://и содержит имя сайта, а не IP-адрес из цифр. - Страницы ЭТОЧАТБОТА таким способом не подключаются, да и не нужно: они открываются сами.
- В веб-версии Telegram в браузере часть сайтов запрещает показ в чужом окне. Откройте ссылку там и проверьте свой сайт.
Чего сайт не узнает. Данные о человеке из Telegram и метки ваш сайт не получает: контакт, метка и источник остаются в боте и в кабинете.
Свой сайт открывается, только если тариф «Премиум» стоит у аккаунта, в котором живёт страница. На «Плюсе» человек увидит саму страницу.
Куда поставить ссылку на мини-приложение
- Под постом в канале. Удобнее всего кнопкой со ссылкой — как её сделать, рассказано в статье «Как сделать кнопку в Телеграмме со ссылкой под постом».
- В рекламе у блогеров и в каналах. Человек открывает страницу, не выходя из Telegram, и сразу оказывается в контактах бота.
- В рассылке и сценариях бота. Ссылку можно поставить в сообщение или на кнопку, например с меню, квизом или записью.
- В описании бота и закреплённом сообщении канала. Там её найдут те, кто только пришёл.
Если страница нужна и вне Telegram — в шапке профиля, на сайте, на визитке с QR-кодом, — давайте её обычный адрес: ссылка на мини-приложение рассчитана на тех, у кого есть Telegram.
Как посмотреть результат
Просмотры и нажатия из Telegram попадают в статистику страницы вместе с остальными. Источник у них — telegram. А кто именно открыл страницу, видно в контактах бота: с меткой и строкой в переписке.
Подробнее о том, как вести людей из рекламы в бота и считать, кто дошёл, — в статье «Реклама Telegram-бота через мини-лендинг». Все возможности мини-приложения собраны на странице «Мини-приложение в Telegram».
Частые вопросы
Нужен ли программист, чтобы создать мини-приложение в Telegram?
Нет. Страницу вы собираете в конструкторе из готовых блоков, а приложение бота создаёте в @BotFather по пяти шагам из кабинета. Код и хостинг не нужны.
Сколько стоит мини-приложение?
Отдельной платы нет, мини-приложение входит в тариф. С мини-лендингом оно работает на «Плюсе» и «Премиуме», с мультиссылкой, формами, квизами и своим сайтом — на «Премиуме». На бесплатном «Старте» его нет. Цены — на странице тарифов, а «Премиум» можно 3 дня попробовать бесплатно.
Можно ли открыть мини-приложение кнопкой меню рядом с полем ввода?
Для страниц кнопку меню мы не ставим: страница открывается по ссылке, которую вы размещаете в постах, кнопках, рекламе и рассылках. Своя кнопка меню есть у магазина — она открывает витрину.
Сценарий запустится каждый раз, когда человек откроет страницу?
Нет, один раз для каждого человека. И только если боту можно писать: человек уже писал боту или разрешил сообщения в окне Telegram.
Работает ли это в МАКС и ВКонтакте?
Пока только в Telegram. В МАКС внутри приложения открывается магазин, а страницы — по обычной ссылке в браузере.
Можно ли принимать оплату в таком мини-приложении?
На страницах оплаты нет. Чтобы продавать товары с корзиной и оплатой внутри Telegram, есть магазин в Telegram — это отдельная витрина со своей настройкой.