Дашборд/Инструкции/Как подключить Mini App к боту

Подключение Mini App к боту

Пошаговая инструкция как настроить общий @pluson_bot или вашего собственного бота для открытия Mini App.

Зачем это нужно: подписчик появляется сам, до регистрации

Человек переходит по ссылке на ваше событие, открывает Mini App — и сразу становится подписчиком вашего бота, ничего для этого не делая специально. При этом он видит удобный интерфейс события: программу, спикеров, подарки, чат — а не форму, которую надо заполнить, чтобы хоть что-то посмотреть.

Так вы получаете максимальный охват: в вашей базе остаются даже те, кто просто интересовался и не зарегистрировался. На обычном лендинге такой человек уходит навсегда — здесь вы можете написать ему позже, напомнить о событии и позвать снова.

🚀

Вы в PRODUCTION-окружении

Все ссылки ниже автоматически подставлены под текущий домен: https://pluson.ru

●

Ваш персональный URL Mini App

Это ваш адрес — у каждого клиента iViSiON: ПЛЮСОН он свой (отличается номером после /c/). Используется на шагах 3 и 4 ниже.

https://pluson.ru/c/{ВАШ_НОМЕР}/tg/

⚠️ Слэш в конце обязателен — без него Telegram не загрузит ассеты. Ваш номер подставится сюда автоматически, когда вы войдёте в кабинет.

Сначала: добавьте токен бота в Каналы

Без этого приветствия и рассылки будут идти от общего @pluson_bot, а не от вашего. Если хотите чтобы участники получали сообщения от вашего бота — добавьте его токен в раздел Каналы:

Получите токен у @BotFather (команда /newbot для нового бота или /mybots → API Token для существующего)
Откройте раздел «Каналы» в кабинете
Добавьте новый канал → платформа Telegram → вставьте токен → сохраните

💡 На каждой платформе (Telegram / VK / MAX) можно подключить только один активный канал на клиента. Если у вас уже есть бот и хотите его сменить — деактивируйте старый и добавьте новый.

Открыть @BotFather и выбрать вашего бота

В Telegram найдите и откройте @BotFather
Команда /mybots
Выберите вашего бота (например @pluson_bot)

Configure Mini App в Bot Settings

Привязываем iViSiON: ПЛЮСОН как главный Mini App бота. Ссылки получаются короткие (t.me/ваш_бот?startapp=…), без коротких имён, работают везде одинаково.

Открыть настройки Mini App:

В @BotFather: /mybots → выбрать вашего бота
Нажать «Bot Settings»
Нажать «Configure Mini App»
Если Mini App ещё не включён — нажать «Enable Mini App»

Вставьте URL приложения:

«Edit Mini App URL» → вставить ссылку:
https://pluson.ru/c/{ВАШ_НОМЕР}/tg/
Придёт «Success! URL updated». Это всё что нужно — title/description/photo у Main Mini App не настраиваются (их нет в этом меню).

Шаг 3 настроил Main Mini App — это нужно для коротких ссылокt.me/ваш_бот?startapp=…(например реф-ссылки участников). Также понадобится short-name plusonчерез /newapp — это для другого формата ссылок, см. шаг 4 ниже.

`/newapp` — short-name `pluson`

Регистрируем short-name pluson у бота — это нужно для ссылок видаt.me/ваш_бот/pluson?startapp=…(используются в «Подключение стороннего лендинга» в карточке события: возврат юзера с лендинга GetCourse/Tilda обратно в Mini App). Без этого шагатакие ссылки откроют пустой чат бота, а не Mini App.

В @BotFather отправьте команду /newapp
Выберите вашего бота из списка
Title — название Mini App (пример: iViSiON: ПЛЮСОН)
Description — короткое описание (1–2 строки)
Photo (640×360) — иконка или /empty чтобы пропустить
GIF demo — /empty (пропустить)
Web App URL — вставьте ту же ссылку Mini App:
https://pluson.ru/c/{ВАШ_НОМЕР}/tg/
Short name — введите ровно pluson (одна «с», всё строчными)

💡 BotFather подтвердит «Done! Web app …» и выдаст готовую ссылкуhttps://telegram.me/ваш_бот/pluson. После этого ссылки возврата в дашборде (карточка события → «Подключение стороннего лендинга») заработают — юзер с success-страницы лендинга вернётся напрямую в Mini App, а не в чат бота.

🧹 Если в /myapps у вас уже есть другой Mini App с short-name — удалите его, чтобы не было конфликта («Delete App» → подтвердить именем приложения).

Кнопка меню бота: приложение ИЛИ команды — выберите одно

У бота есть одна кнопка меню слева от поля ввода. Она может работать в двух режимах — выберите тот, что вам нужен. Два режима одновременно не работают: если включена кнопка-приложение, списка команд не будет, и наоборот.

Вариант A · Кнопка «Открыть приложение» (Mini App)

Внизу чата — большая кнопка, по нажатию сразу открывается Mini App. Подходит, если участник заходит только в приложение.

В @BotFather: /mybots → выбрать бота → «Bot Settings»
Нажать «Menu Button» → «Configure menu button»
Текст кнопки: Открыть приложение (или своё)
URL: вставьте ссылку Mini App →
https://pluson.ru/c/{ВАШ_НОМЕР}/tg/

Вариант B · Меню команд (/app, /menu…, /support)

Кнопка меню раскрывает список команд. Подходит, если хотите дать участнику несколько быстрых действий: открыть приложение, перейти к конкретному событию, написать в поддержку.

Шаг 1 — выключить кнопку-приложение

В @BotFather: /mybots → ваш бот → «Bot Settings» → «Menu Button»
Выбрать «Use default menu button (Commands)» — это вернёт обычную кнопку, которая показывает список команд (а не открывает Mini App).

Шаг 2 — задать сами команды

В @BotFather отправьте команду /setcommands
Выберите вашего бота
Пришлите список команд — каждая строкой в формате команда - описание. Пример (как настроено в боте @ivision_conf_bot):

app - Открыть приложение
menu24 - Меню: Чемпионат спикеров Ж.И.В.У.
support - Служба поддержки

Что это за команды:

/app — открывает Mini App (главный экран приложения).
/menu{ID события} — открывает меню конкретного события (кнопки: формат участия, кабинет·подарки, чат, эфир, поддержка). {ID события} — это номер события из адреса его карточки в дашборде: …/tournaments/24 → команда /menu24.
/support — единое сообщение со способами связи (служба поддержки).

Свои примеры под ваши события (поменяйте номер после menu на ID вашего события):

app - Открыть приложение
menu24 - Меню: Чемпионат спикеров
menu41 - Меню: Весенняя конференция
support - Служба поддержки

💡 ID события смотрите в адресной строке его карточки в дашборде — число после/events/, /conferences/или /tournaments/. Например …/tournaments/24 → /menu24.

Прописать домен бота

Это нужно для безопасной работы Mini App и Telegram Login:

Команда /setdomain → выбрать вашего бота
Прислать домен (без https:// и без / в конце):

pluson.ru

●

Где взять готовую ссылку для шеринга

Никаких ссылок руками собирать не нужно — iViSiON: ПЛЮСОН делает их сам. Откройте карточку события и скопируйте готовую:

Для конференции: Дашборд → Конференции → выбрать конференцию → ссылка для участников
Для других событий: Дашборд → Мероприятия → выбрать событие → ссылка в шапке

Каждый участник в Mini App получает свою партнёрскую ссылку — она генерируется автоматически и доступна во вкладке «🎯 Игра». Делиться ей участники могут одной кнопкой «Поделиться».

🔗 Smart Bridge. В каждом лендинге события (/l/SLUG) уже подключён скрипт автоматического перехода в Telegram. Если открыть лендинг с ?app=tg — Telegram запустится сам и Mini App откроется на нужном событии. На компьютере откроется обычный лендинг, на телефоне с Telegram — сразу Mini App. Эту фишку можно использовать в постах в соцсетях.

Если что-то не работает

«No supported page found» в Telegram → URL Mini App не указан или забыт / в конце
Белый экран при открытии → не загружается JS/CSS. Проверьте что https://pluson.ru/c/{ВАШ_НОМЕР}/tg/assets/ отвечает 200 в браузере
«Bot needs to be added» → в @BotFather бот не зарегистрирован как Mini App-бот, шаг 2 пропущен
Старая версия отображается → внутри Mini App нажмите «⋯» в правом верхнем углу → «Обновить страницу». Это перезапрашивает свежие файлы и обходит кеш. Простой свайп вниз и переоткрытие чаще не помогает — Telegram держит Mini App-кеш отдельно от обычного «Очистить кеш». Если у проблемного аккаунта не помогло — попробуйте этот же бот в другом аккаунте Telegram (там кеша нет, и сразу видно — проблема в кеше или в коде).

Не получилось?

Напишите в поддержку — написать в тех.поддержку

Всё это настраивается мышкой

Без программиста и технического задания. 7 дней бесплатно, карта не нужна.

Попробовать бесплатно