К основному содержанию
T TON Adoption
EN
← Словарь
NODE/03 · Term

Inline mode

Режим Telegram-бота, при котором пользователь вызывает бота прямо в любом чате через @username запрос. Бот возвращает результаты — статьи, картинки, GIF — и пользователь вставляет выбранный ответ в чат.

Синонимы: инлайн-режим, inline-боты, инлайн боты

Inline mode — особый режим работы Telegram-бота, при котором его не нужно явно открывать. В любом чате пользователь набирает @username запрос (например, @gif funny cats) — бот в реальном времени возвращает варианты, и пользователь выбирает один, который сразу появляется в чате.

Зачем это сделано

Inline mode позволяет ботам быть «полезной утилитой» в любом разговоре, а не только в личном чате:

  • Поиск стикеров и GIF. @gif, @stickers — встроены в Telegram.
  • Поиск ответов. @bing, @youtube — поиск без выхода из чата.
  • Игровые боты. @gamebot запускает игру, ход которой видим всем.
  • Утилиты. @vote_bot, @poll_bot создают опросы инлайн.

Для пользователя это плавнее, чем переключаться в личку с ботом.

Связь с TON

В TON-экосистеме inline-боты применяются ограниченно, но интересно:

  • Тип-share TON-кошелька. Бот, который инлайн возвращает текущий баланс пользователя или адрес для приёма платежа.
  • Минт NFT по запросу. В чате @nftbot mint, бот возвращает NFT-карточку для shared-flow.
  • Интеграции с DEX. В некоторых проектах inline-команда возвращает текущий курс или ссылку на swap.

Большинство TON-приложений всё-таки опираются на mini-apps (WebView-интерфейс), а не на inline-режим, потому что mini-app даёт полноценный UI, а inline — только текстово-карточный ответ.

Технически

Реализуется через inline_query в Bot API:

  1. Пользователь в любом чате пишет @yourbot something.
  2. Telegram отправляет вашему боту inline_query с текстом запроса.
  3. Бот возвращает массив InlineQueryResult (article, photo, gif, etc.).
  4. Пользователь видит результаты в виде popup, выбирает один.
  5. Выбранный результат вставляется в чат.

В отличие от обычных команд, inline-бот не «отвечает» в чат от своего имени — итоговое сообщение публикуется от имени пользователя (с пометкой via @yourbot снизу).

Ограничения

  • 5 секунд на ответ. Если бот не успел — Telegram отбрасывает запрос.
  • Privacy mode. В групповых чатах inline работает только если включён в настройках бота.
  • Спам-защита. Слишком частые запросы или плохие результаты — путь к жалобам и бану.

Когда выбирать

Inline-режим хорош для коротких справочных запросов и маленьких утилит. Для финансовых операций и сложных интерфейсов — mini-apps.

См. также