Inline-меню

Что такое inline-меню

Inline-меню — это поиск с карточками, который открывается прямо в Telegram, когда пользователь вводит @имя_вашего_бота в любом чате. Появляется всплывающий список результатов, по которым можно прокручивать и выбирать.

Это удобно для каталогов товаров, библиотек контента, справочников — любых структурированных списков, по которым пользователь хочет искать.

Функция работает только если в настройках бота через @BotFather включён режим inline (/setinline).

Источники данных

Inline-меню поддерживает три источника данных:

Ручной режим

Карточки задаются вручную в редакторе. Для каждой карточки указывается:

Заголовок — крупный текст карточки
Описание — подробности под заголовком
Изображение — миниатюра (URL или файл)
Текст при выборе — что бот отправит в чат при нажатии

Используйте ручной режим для небольших статичных списков: FAQ, список услуг, типы подписок.

Динамический режим из каталога товаров

Карточки берутся из каталога товаров вашего бота. Поиск ведётся по названию товаров в реальном времени. Каждая карточка показывает название, описание и изображение товара.

Используйте этот режим для магазинов и витрин.

Динамический режим из библиотеки файлов

Карточки берутся из библиотеки файлов бота. Можно фильтровать по типу файла (фото, видео, аудио, документ).

Используйте для медиатек, коллекций изображений, аудиобиблиотек.

Пагинация

При большом количестве результатов inline-меню автоматически разбивает их на страницы — пользователь прокручивает список и подгружает следующую порцию.

Интерактивный выбор (via-bot)

Когда пользователь нажимает на карточку inline-меню в стороннем чате, данные выбранного элемента можно автоматически сохранить в переменные и запустить нужный сценарий.

Как настроить

В настройках inline-меню включите «Запустить команду после выбора».
Выберите целевую ноду — куда перейдёт бот после выбора.
Укажите переменную — куда записать данные выбранного элемента (ID, название и т.д.).

Что происходит при выборе

Пользователь выбирает карточку → бот в личном чате с пользователем запускает указанную ноду → в переменную записывается payload выбранного элемента.

После этого вы можете использовать данные элемента в любых блоках нады: вывести описание, показать цену, создать инвойс и т.д.

Советы

Для поиска по каталогу товаров выбирайте динамический режим из товаров — он всегда актуален и не требует ручного обновления.
Функция via-bot отлично подходит для выбора товара перед оплатой: пользователь ищет нужный товар → выбирает → бот автоматически оформляет счёт.
Карточки с изображениями привлекают больше внимания — старайтесь заполнять поле фото.