Skip to main content

Mini App — веб-страница внутри Telefon

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

Как открыть Mini App​

Если у бота есть Mini App — слева от поля ввода появляется кнопка «Открыть» (или другой текст, который выбрал автор бота):

📷 Скриншот: Open Mini App button

Тап → во весь экран открывается веб-страница. Сверху узкая шапка Telefon с кнопкой «✕» (закрыть) и темой оформления как у мессенджера.

Где ещё можно открыть Mini App​

Помимо кнопки «Меню», Mini App запускается:

  • Кнопкой под сообщением (inline-кнопка с типом WebApp)
  • Кнопкой клавиатуры в Reply Keyboard
  • Прямой ссылкой https://app.telefon.chat/@bot/start?startapp=...
  • Из inline-режима (если бот поддерживает)

📷 Скриншот: Mini App fullscreen

Что Mini App знает о вас​

При открытии Mini App автоматически передаёт:

  • Ваше имя и @username (никнейм)
  • ID пользователя (только число, не телефон)
  • Язык интерфейса
  • Идентификатор чата (если открыто из чата)

Бот НЕ получает ваш номер телефона, email, контакты или историю чатов. Это всё, что есть.

Если Mini App просит подтвердить контакт — по кнопке «Поделиться телефоном» можно дать его явно. Это защищённый запрос.

Безопасность​

Mini App = чужой сайт. Хотя он внутри Telefon — он работает по своим правилам:

  • ✅ Можно покупать через подключённые платёжные системы (Stripe и др.)
  • ✅ Авторизация через Telefon работает автоматически
  • ⚠️ Не вводите банковскую карту в подозрительных ботах. Серьёзные сервисы используют встроенный платёжный API.
  • ⚠️ Не подтверждайте «дайте все права» если не понимаете что просят.

Закрыть Mini App​

  • Свайп вниз (на телефоне)
  • Кнопка «✕» в шапке
  • Кнопка «Назад» / Esc на компьютере

Если Mini App не открывается​

  1. Обновите Telefon до последней версии.
  2. Проверьте интернет — Mini App это отдельный сайт.
  3. Очистите кэш Mini App: настройки бота → «Сбросить данные Mini App».
  4. Если проблема у конкретного бота — напишите его автору.

Чем Mini App отличается от обычного бота​

Обычный ботMini App
ИнтерфейсТекст + кнопкиПолноценный сайт
СкоростьБыстроЗависит от сайта
ГибкостьОграничено APIЛюбой UI
ПлатежиСложноПроще
Подходит дляЧатов, уведомленийМагазинов, игр

Многие боты комбинируют оба подхода: для простых вопросов — текст и кнопки, для каталога/корзины — Mini App.

См. также: Магазин в чате.