Перейти к основному содержимому

Мини-приложение

В конструктор можно добавить собственный HTML/JavaScript-код мини-приложения для Telegram. Это даёт полный контроль над интерфейсом и логикой внутри Telegram.

Mini App 1

Mini App 2

Код можно генерировать нейросетью

Код мини-приложения можно сгенерировать с помощью Grok, DeepSeek, ChatGPT и других нейросетей — главное, правильно описать требования к интерфейсу и протоколу обмена данными с ботом.

Отправка данных из приложения в бот​

Данные из приложения отправляются на URL:

POST или GET → https://api.quescha.com/miniapp/callback
Обязательный объект quescha

Вместе с вашими данными нужно отправить служебный объект quescha — он создаётся при запуске мини-приложения и доступен как window.quescha. Без него конструктор не сможет связать запрос с конкретным ботом и подписчиком.

Структура объекта quescha​

{
  "webappid": 4,
  "channelid": 5,
  "clientid": 254104321
}
ПолеОписание
webappidID Web-приложения в конструкторе.
channelidID бота в конструкторе.
clientidClientID подписчика (он же User ID в Telegram) — для персонализации.

Загрузка данных из бота в приложение​

Если нужно подгружать данные из бота в приложение — на старте или в процессе работы — настройте обратный поток через вебхук.

Алгоритм​

  1. Создайте сценарий действий с действием Обмен данными → Ожидание данных.
  2. Из приложения обратитесь к URL вебхука, который выдаёт это действие.
  3. В дальнейших действиях сценария сформируйте данные для загрузки в приложение и поместите их в системную переменную _response — чаще всего как JSON.

Mini App 3

Удобный паттерн

Персонализация​

Для персонализации первоначальной загрузки нужно знать ClientID подписчика, запустившего приложение. Используйте тот же поток:

  1. Из приложения отправьте объект quescha (или window.quescha) в «Ожидание данных».
  2. В сценарии возьмите clientid из полученного объекта и сформируйте персональный _response.

Размещение в @BotFather​

Своё мини-приложение можно сделать основным способом взаимодействия с подписчиками:

  1. Откройте @BotFather.
  2. Перейдите в Bot Settings → Configure Mini App.
  3. Подключите ваше мини-приложение к боту.

Видеоинструкции​