Мини-приложение — элемент Telegram, который фактически является веб-страницей открывающейся внутри Telegram или Max использующий расширенные возможности Mini App Api для Telegram. Все мини-приложения интегрированы в ботов. Дизайн Мини-приложений адаптирован под стилистику iOS и Android.
Для добавления мини-приложения в Telegram боте вам сначала нужно создать и подключить бот к Puzzlebot.
Подробнее: Как создать нового бота в Telegram
Добавление мини-приложения для Max описано в отдельной инструкции:
Добавление мини-приложения для Telegram-бота
Настройка Мини-приложения в BotFather
Через @BotFather можно включить специальный режим для запуска Мини-приложения по кнопке из профиля бота или по Стартовой ссылке https://t.me/username_bot?startapp, а также можно создать Короткие ссылки по типу https://t.me/username_bot/miniapp, рассмотрим оба варианта.
Кнопка "Открыть приложение" и Стартовая ссылка
Кнопка для открытия приложения из профиля бота.
Для включения режима Мини-приложения необходимо:
- Перейти в @BotFather
- Ввести
/mybotsи выбрать нужного бота - Открыть Bot Settings и выбрать Configure Mini App
- Нажать Enable Mini App
- Последним шагом необходимо открыть: Личный кабинет — Конструктор — выбрать уже созданное и опубликованное Мини-приложение — Настройки — Скопировать Техническую ссылку и отправить её в @BotFather.
Более подробнее где взять техническую ссылку описано ниже. - Отлично, теперь Мини-приложение можно открыть по кнопке в профиле Telegram бота, а также по ссылке в виде
https://t.me/username_bot?startapp, где на местеusername_botнужно подставить юзернейм вашего бота.
Где взять техническую ссылку
1.Перейдите в Конструктор.
![В конструкторе нажмите кнопку [+]](/api/media/file/%20%D0%92%20%D0%BA%D0%BE%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D0%BE%D1%80%D0%B5%20%D0%BD%D0%B0%D0%B6%D0%BC%D0%B8%D1%82%D0%B5%20%D0%BA%D0%BD%D0%BE%D0%BF%D0%BA%D1%83%20%5B%2B%5D.jpeg)
2. Создайте приложение, напишите название, после чего опубликуйте изменения.
3. Вновь откройте приложение, на вкладке Настройки появится ссылки → скопируйте техническую ссылку и отправьте в @BotFather.
Отлично, теперь Мини-приложение можно открыть по кнопке в профиле Telegram бота, а также по ссылке в виде https://t.me/username_bot?startapp, где на месте username_bot нужно подставить юзернейм вашего бота.
Типы ссылок на Мини-приложение
В контексте личного кабинета существует всего 2 типа ссылок на Мини-приложения:
- Прямая ссылка — имеет вид
https://t.me/username_bot?startapp=10e220a237218f61Telegram илиhttps://max.ru/id123456_bot?startapp=10e220a237218f61для Max, на конце ссылки указан ID необходимого Мини-приложения.
Область применения: можно вставлять в текст, в кнопки и в любые иные места для вызова Мини-приложения.
Важно! Для её использования для Telegram бота необходимо в @BotFather включить режим Mini App, о котором написали выше.
- Техническая ссылка — имеет вид
https://cp.puzzlebot.top/web_page/test.html?id=10e220a237218f61, на конце ссылки указан ID необходимого Мини-приложения.
Область применения: предназначена исключительно для настройки режима Mini App в Telegram и для создания коротких ссылок в @BotFather, так же для включения мини-приложения в боте Max.
По ней нельзя переходить и её нельзя вставлять в виде ссылки в текст.
Важно! Наблюдаются проблемы в работе Прямых ссылок со стороны Telegram клиентов, описали метод исправления ошибки.
Также, помимо Прямой ссылки для перехода к Мини-приложению есть ещё Короткая ссылка в виде https://t.me/username_bot/miniapp и Стартовая ссылка для открытия главной страницы Мини-приложения https://t.me/username_bot?startapp , о которых рассказали выше.
Короткая ссылка на Мини-приложение
Пример короткой ссылки на Мини-приложение.
Для создания короткой ссылки на Мини-приложение нужно:
- Перейти в @BotFather
- Ввести
/newapp - Выбрать нужного бота и следовать дальнейшим шагам: Ввести название Мини-приложения — Описание — Отправить картинку (например из Yandex)— Прислать GIF или отправить
/empty - На шаге где запрашивается ссылка необходимо снова отправить Техническую ссылку: Личный кабинет — Конструктор — выбрать уже созданное и опубликованное Мини-приложение — Настройки — Скопировать Техническую ссылку и отправить её в @BotFather (пошагово со скриншотами смотрите выше)
- Последним шагом нужно задать окончание ссылки, например "price"
Создание контента и наполнения Мини-приложения
После того как вы успешно добавили Мини-приложение в Telegram-бот и настроили работу ссылок, можете приступить к созданию и наполнению контентной части и внешнего вида: