# Режим inline в Telegram

## Что такое режим inline в Telegram?

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

Чтобы обратиться к боту, у которого включён онлайн-режим, просто введите @\*имя бота\* в **Секция сообщения** .

Самый яркий и популярный пример бота, работающего онлайн, — @gif, с помощью которого можно выбирать и отправлять GIF-изображения:

<div data-with-frame="true"><figure><img src="/files/0e041eb17ee818feb25ce494388c05211e64874c" alt="" width="563"><figcaption><p>Бот @gif будет работать в любом чате.</p></figcaption></figure></div>

Бот @gif будет работать в любом чате.

## Как включить режим inline?

Чтобы бот работал в офлайн-режиме, нужно включить эту опцию в настройках бота в [BotFather](https://t.me/BotFather).

Выберите нужного бота и перейдите в **Bot Settings**.

<div data-with-frame="true"><figure><img src="/files/82692e1f20ea49c55d8aaac84e4d41591231ba59" alt="" width="315"><figcaption></figcaption></figure></div>

Затем выберите **Режим inline**

<figure><img src="/files/3c86841f4ea955a8c0652ad652cb8285b63aeecb" alt="" width="375"><figcaption></figcaption></figure>

Здесь нужно включить офлайн-режим, если он не включён.

<figure><img src="/files/ef1bc9540a171d209a752a673e0cf131688328b4" alt="" width="375"><figcaption></figcaption></figure>

## Как изменить placeholder?

При желании вы можете изменить placeholder, который отображается перед вводом поискового запроса. По умолчанию это ***Поиск…***

<div data-with-frame="true"><figure><img src="/files/efad4c75f0dbce41a05a3c6f30aee5e12e1f568e" alt="" width="563"><figcaption></figcaption></figure></div>

Чтобы изменить его, нажмите **Изменить placeholder inline** :

<div data-with-frame="true"><figure><img src="/files/5f4f38e360edbe616d04f3fd597a5e09e2aec577" alt="" width="563"><figcaption></figcaption></figure></div>

Укажите точное содержимое placeholder.

<div data-with-frame="true"><figure><img src="/files/c16322e8774367f0fe4055f0a09854123e313f7e" alt="" width="563"><figcaption></figcaption></figure></div>

## Как настроить результаты вывода

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

Чтобы указать данные для вывода в режиме inline, нужно задать переменную inline\_bot. В режиме inline поиск значений в переменной inline\_bot происходит практически в реальном времени.

Данные в переменной можно задать тремя способами. Рассмотрим от самого простого до максимальных настроек.

### Массив с текстовыми данными

Например, поиск будет выполняться по массиву товаров.

<div data-with-frame="true"><figure><img src="/files/0d49dbaf883c8475840080ee4803d1b184187b8a" alt="" width="563"><figcaption></figcaption></figure></div>

Переменная inline\_bot задаётся в настройках проекта. Поиск совпадает с любым вариантом массива, который содержит введённую фразу.

<div data-with-frame="true"><figure><img src="/files/6e24b3c0adb3fd98ba868b33b543fb65cb378270" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/ce3800c6c22c5bb5a0249ce5a3df0573463b1c6c" alt="" width="563"><figcaption></figcaption></figure></div>

Когда вы вводите '@name\_\_of your\_\_bot' и начальные буквы команд, открывается меню со значениями, которые вы указали в переменной проекта.

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

Конфигурация блока выглядит так:

<div data-with-frame="true"><figure><img src="/files/6df61250608167f5aca78ca2ab484f1dd0644807" alt=""><figcaption></figcaption></figure></div>

Пример данных:

\["Молоко", "Хлеб", "Паста", "Шоколад", "Яйца", "Масло", "Булочка", "Чай", "Овощи", "Фрукты"]

### Вывод при отсутствии фильтрации

Вы можете задать пустой ключ и назначить ему массив значений в нижнем регистре или массив словарей. Бот обратится к словарю через пустой ключ и выведет кнопки со значениями из назначенного массива.

### Inline-кнопка с указанным значением поиска

{% hint style="warning" %}
Обратите внимание!

Inline-кнопки в Telegram — это не callback.

Если вам нужно получать callback, то прочитайте про [callback-кнопки в Telegram.](/doc/ru/chatbot/messendzhery/telegram/buttons.md#callback-button)

Кнопка работает только в Telegram.
{% endhint %}

Чтобы задать поисковую фразу, добавьте параметр inline\_query к inline-кнопке со значением, которое автоматически подставляется в запрос.

Рекомендуется использовать этот вариант для офлайн-режима, так как это позволит избежать ошибок и работать быстрее.

Например, добавьте три кнопки, которые соответствуют примеру из предыдущей главы.

\[{"line":0,"index\_in\_line":0,"text":"Показать меню","type":"inline","inline\_query":"menu"},{"line":0,"index\_in\_line":1,"text":"Статьи","type":"inline","inline\_query":"posts"},{"line":2,"index\_in\_line":0,"text":"Список товаров","type":"inline","inline\_query":"products"}]

<div data-with-frame="true"><figure><img src="/files/b239cb0a0a883c33d2e1811214e78da0054cb457" alt="" width="375"><figcaption></figcaption></figure></div>

Когда вы нажмёте на кнопку, например, **Статьи,** будет показан найденный список кнопок (при добавлении вы указали для этой кнопки "inline\_query":"posts"):

<div data-with-frame="true"><figure><img src="/files/d6582c0fb474291d23d38be8e52ce12a883105fe" alt="" width="375"><figcaption></figcaption></figure></div>

Варианты берутся из заданной переменной, как описано выше в **"Словарь со списком"** :

<figure><img src="/files/1d2235f7a57fbdcc5195423db8eb3d1f09a0b8ea" alt="" width="563"><figcaption></figcaption></figure>

### Примечания

* Переменную inline\_bot можно задавать не только в общих переменных, но и как простую переменную, однако в этом случае её значение должно быть заключено в одинарные кавычки.

Пример в поле калькулятора:

inline\_bot = '\["Молоко", "Хлеб", "Паста", "Шоколад", "Яйца", "Масло", "Слоёное тесто", "Чай", "Овощи", "Фрукты", "#{aa}"]'

Также можно передавать любое значение в качестве переменной для более гибкой настройки.

Например, простой вариант в массиве:

<div data-with-frame="true"><figure><img src="/files/4b3ddf3c7bb94592b725bbee5cb420df116fa178" alt="" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ru/chatbot/messendzhery/telegram/inline.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
