Skip to main content

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-бота.