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

WebApp Telegram

Тип приложения Каталог или Календарь​

Чтобы подключить приложение каталога или календаря в Телеграме вам потребуется добавить приложение на странице Списки/WebApp и настроить его.
После возвращения из приложения обратно в бот, ответом текущего блока становится для каталога webapp:catalog, для календаря - webapp:calendar. Это важно, потому что вы можете настроить условие проверки ответа, чтобы вести пользователя далее на нужный блок обработки с действиями. Если для приложения через кнопку под сообщением это не столь критично, то в случае кнопки меню или кнопки клавиатуры пользователь может находиться на любом блоке в сценарии и перейти из него в приложение. В таком случае на каждом блоке вы должны поставить условие проверки ответа на наличие webapp:catalog или webapp:calendar и при выполнении условия вести его на блок обработки данных приложения.
Далее вы можете обработать полученные данные в сценарии действий. От каталога передаются данные по заказу и вы, например, сможете выдать ссылку на оплату, используя сумму заказа из приложения и действие "Платежи" для генерации платежной ссылки.

Действия для обработки данных из приложений каталога и календаря:

  • Каталог: обработка заказа
  • Календарь: данные из приложения
  • Календарь: сделать запись
  • Календарь: получить все записи клиента
  • Календарь: получить запись клиента
  • Календарь: удалить запись клиента
  • Календарь: удалить все записи клиента

WebApp каталога

Тип приложения "Mini app"​

к сведению

Взаимодействие с мини-приложением происходит по-другому, специальных действий для этого нет

Вы можете использовать собственное mini app приложение в ботах конструктора Квесча. Разместите HTML/Javascript код в настройках мини приложения, а ссылку приложения укажите в кнопке типа "ссылка" или в настройках бота в @BotFather.
ВАЖНО: Для продолжения сценария бота необходимо отправлять данные обратно в бот на URL-адрес https://api.quescha.com/miniapp/callback POST или GET методом. Кроме данных из вашего приложения ОБЯЗАТЕЛЬНО необходимо отправлять объект quescha.

После отправки данных ваш бот получит в качестве ответа строку webapp:miniapp. Если вы не используете кнопки под сообщениями, то позаботьтесь об обработке этого ответа в каждом блоке, например, путем добавления условия '[Answer]' = 'webapp:miniapp'.
Все данные приложения станут переменными в сценарии бота по переданным ключам и вы можете их обработать по вашему усмотрению. Подробная информация по мини-приложениям Telegram на официальном сайте
Также приложение может обмениваться данными с конструктором с помощью вебхука. В этом случае продолжать сценарий бота вы сможете через сценарий действий с помощью отправки в бот сообщений. Чтобы настроить вебхук, добавьте сценарий действий и действие "Обмен данными"->"Ожидание данных". Далее сформируйте необходимый формат данных, например, JSON с помощью действия "JS-код" и поместите их в переменную _response, которая будет возвращена ответом на обращение приложения по вебхуку.
ВАЖНО: Вся работа мини приложения зависит от вас. Создать приложение вы также можете с помощью нейросетей самостоятельно, правильно сформулировав требования к приложению и его работе по отправке и получению данных.