Квиз можно установить в Telegram как Mini App — мини-приложение внутри бота. Пользователь открывает бота, нажимает на кнопку — и квиз запускается прямо в интерфейсе Telegram, без переходов на сторонние сайты. Это удобно, когда основная аудитория живёт в мессенджере: она не теряет контекст и быстрее проходит квиз.
Что такое Mini App
Mini App — это мини-приложение, которое открывается внутри Telegram. Оно выглядит как обычный бот, но при нажатии на кнопку разворачивается в полноценный интерфейс: страницы, формы, квизы. Для пользователя это привычно, а для бизнеса — ещё одна точка входа без установки отдельного приложения.
Шаг 1: создание бота через @BotFather
Найдите в поиске Telegram @BotFather, после чего создайте нового бота или выберите из уже существующих. В выбранном боте перейдите в раздел «Bot Settings» и далее в «Configure Mini App».
Шаг 2: настройка Mini App
Далее нажмите на кнопку «Enable Mini App» и отправьте ссылку на ваше приложение из настройки интеграции в Matomba.
Шаг 3: режим FullScreen
Перейдите в раздел «Change Mode» и переключите настройку на «FullScreen», чтобы квиз занимал всю область устройства пользователя. Это делает прохождение удобнее: не нужно прокручивать маленькое окно, всё видно сразу.
Шаг 4: иконка загрузки — Splash Screen
Вы также можете загрузить свою иконку, которая будет показана при загрузке приложения, нажав на «Configure Splash Screen». Это добавляет узнаваемости: пользователь видит ваш логотип, пока квиз загружается.
Шаг 5: кнопка меню — MenuButton
Вернитесь к настройкам и добавьте «MenuButton», указав ту же ссылку на приложение и текст кнопки, чтобы в боте появилось соответствующее действие.Для отображения изменений необходимо перезагружать приложение Telegram.
Упрощённая форма связи
При включённой опции «Автоотправка контакта» стандартная форма связи будет уменьшена до одной кнопки. Нажав на неё, клиент автоматически поделится с вами ссылкой на свой профиль в Telegram. Другие способы сбора контактов на первом шаге будут отключены!
Как проверить, что квиз работает в Telegram
- Откройте бота в Telegram и проверьте, что кнопка MenuButton появляется.
- Нажмите на кнопку и убедитесь, что Mini App открывается.
- Проверьте, что квиз занимает весь экран в режиме FullScreen.
- Убедитесь, что Splash Screen показывает вашу иконку при загрузке.
- Проверьте работу формы связи: если включена «Автоотправка контакта», должна быть одна кнопка.
- Перезагрузите Telegram, если изменения не отображаются.
Частые ошибки при установке в Telegram
- Забывают добавить MenuButton — в боте нет кнопки запуска.
- Указывают ссылку с ошибкой — Mini App не открывается.
- Не переключают режим на FullScreen — квиз открывается в маленьком окне.
- Не загружают иконку Splash Screen — при загрузке показывается стандартная.
- Не перезагружают Telegram — изменения не отображаются.
- Включают «Автоотправку контакта» и удивляются, что другие поля исчезли.
Коротко: что делать при установке в Telegram
- Создайте бота через @BotFather или выберите существующего.
- Откройте «Bot Settings» → «Configure Mini App» и включите Mini App.
- Укажите ссылку на приложение из настройки интеграции Matomba.
- Переключите режим на «FullScreen» и загрузите иконку Splash Screen.
- Добавьте MenuButton с той же ссылкой и текстом кнопки.
- Перезагрузите Telegram и проверьте работу квиза.
