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

Inline-режим

Inline-боты позволяют пользователю призвать бота в любом чате, написав @username запрос — бот возвращает список результатов, и тап на результат отправляет его как сообщение.

Когда использовать

  • Поиск GIF, стикеров, картинок (@gif кошки)
  • Поиск товаров (@shop пицца)
  • Калькулятор (@calc 2+2)
  • Конвертер валют (@usd 100)
  • Поиск по базе знаний

Как это работает

  1. Юзер пишет @my_bot foo в любом чате.
  2. Telefon шлёт боту обновление inline_query.
  3. Бот вызывает answerInlineQuery с массивом результатов.
  4. Telefon показывает результаты юзеру списком.
  5. Юзер тапает результат → шлётся сообщение.
  6. Бот получает обновление chosen_inline_result (если включено).

Включение inline-режима

В настройках бота через @botmaker«Изменить» → toggle «Inline-режим». Без этого Telefon не будет принимать inline-запросы.

Структура inline_query

{
"update_id": 123,
"inline_query": {
"id": "q-uuid",
"from": {"id": 999, "first_name": "Иван"},
"query": "кошки",
"offset": ""
}
}

offset пустой при первом вызове. Если бот отдал не все результаты, можно указать next_offset — при скролле юзер получит следующую страницу.

Минимальный пример

См. answerInlineQuery и пример Inline-бота.