Тип данных InlineQueryResultsButton

Объект, представляющий кнопку над результатами инлайн-запроса, которая может запускать веб-приложение или передавать стартовый параметр боту.

Описание

Этот объект представляет кнопку, которая будет показана над результатами инлайн-запроса. Вы обязаны использовать ровно одно из необязательных полей.

Поле Тип Описание
text String Текст метки на кнопке
web_app WebAppInfo Необязательное. Описание Веб-приложения, которое будет запущено при нажатии пользователем кнопки. Веб-приложение сможет вернуться в инлайн-режим, используя метод switchInlineQuery внутри Веб-приложения.
start_parameter String Необязательное. Параметр глубокой ссылки для сообщения /start, отправляемого боту при нажатии пользователем кнопки. Длина 1-64 символа, разрешены только A-Z, a-z, 0-9, _ и -.

Пример: Инлайн-бот, отправляющий видео с YouTube, может попросить пользователя подключить бота к своему аккаунту YouTube для адаптации результатов поиска. Для этого он отображает кнопку «Подключите свой аккаунт YouTube» над результатами или даже перед их показом. Пользователь нажимает кнопку, переходит в личный чат с ботом и при этом передаёт стартовый параметр, который указывает боту вернуть OAuth-ссылку. После этого бот может предложить кнопку InlineKeyboardMarkup, чтобы пользователь мог легко вернуться в чат, где хотел использовать инлайн-возможности бота.

Примеры

json

{
  "text": "Open Web App",
  "web_app": {
    "url": "https://example.com/mini-app"
  }
}

История изменений

  • API 6.7. Добавлен объект InlineQueryResultsButton

Дополнительно

  • WebAppInfo - Объект, содержащий информацию о Веб-приложении для его открытия с дополнительными данными.
  • InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.
Комментарии