# Inline-режим у Telegram

## Що таке inline-режим у Telegram?

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

Щоб звернутися до бота, у якого ввімкнено онлайн-режим, просто введіть @\*ім'я бота\* у **Повідомлення** .

Найяскравіший і найпопулярніший приклад бота, що працює онлайн, — @gif, за допомогою якого можна вибирати та надсилати gif-зображення:

<div data-with-frame="true"><figure><img src="/files/6e96b8a5ec6cf743af813b2624c4a2098ba59d7b" alt="" width="563"><figcaption><p>Бот @gif працюватиме в будь-якому чаті.</p></figcaption></figure></div>

Бот @gif працюватиме в будь-якому чаті.

## Як увімкнути inline-режим?

Щоб бот працював в офлайн-режимі, потрібно ввімкнути цю опцію в налаштуваннях бота в [BotFather](https://t.me/BotFather).

Виберіть потрібного бота та перейдіть до **Налаштування бота**.

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

Потім оберіть **Inline Mode**

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

Тут потрібно ввімкнути офлайн-режим, якщо він не ввімкнений.

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

## Як змінити placeholder?

За потреби ви можете змінити placeholder, який відображається перед введенням пошукового запиту. За замовчуванням це ***Пошук…***

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

Щоб змінити його, натисніть **Edit Inline Placeholder** кнопку:

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

Вкажіть точний вміст placeholder.

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

## Як налаштувати результати виводу

Після натискання на опцію зі списку в inline-режимі буде надіслано повідомлення, яке вказане в заголовку вибраної опції, і ви можете налаштувати реакцію у funnel на це значення.

Щоб вказати дані для виводу в inline-режимі, потрібно встановити змінну inline\_bot. В inline-режимі пошук значень у змінній inline\_bot відбувається майже в реальному часі.

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

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

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

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

Змінна inline\_bot вказується в налаштуваннях проєкту. Пошук зіставляє будь-який варіант масиву, який містить введену фразу.

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

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

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

Після натискання на потрібний елемент користувачеве повідомлення буде надіслано боту, для якого можна налаштувати реакцію в боті.

Налаштування блока виглядає так:

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

Зразок даних:

\["Milk", "Bread", "Pasta", "Chocolate", "Eggs", "Butter", "Bun", "Tea", "Vegetables", "Fruit"]

### Вивід за відсутності фільтрації

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

### Inline-кнопка із заданим значенням пошуку

{% hint style="warning" %}
Зверніть увагу!

Inline-кнопки в Telegram — це не callback'и.

Якщо вам потрібно отримувати callback'и, тоді прочитайте про [callback-кнопки в Telegram.](/doc/uk/chatbot/mesendzheri/telegram/buttons.md#callback-button)

Кнопка працює лише в Telegram.
{% endhint %}

Щоб задати пошукову фразу, додайте параметр inline\_query до inline-кнопки зі значенням, яке автоматично вставляється в запит.

Рекомендується використовувати цей варіант для офлайн-режиму, оскільки це дозволить уникнути помилок і працюватиме швидше.

Наприклад, додайте три кнопки, які відповідають прикладу з попереднього розділу.

\[{"line":0,"index\_in\_line":0,"text":"Show the menu","type":"inline","inline\_query":"menu"},{"line":0,"index\_in\_line":1,"text":"Статті","type":"inline","inline\_query":"posts"},{"line":2,"index\_in\_line":0,"text":"List of products","type":"inline","inline\_query":"products"}]

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

Коли ви натиснете на кнопку, наприклад, на **Статтю,** буде показано знайдений список кнопок (під час додавання ви вказали для цієї кнопки "inline\_query":"posts"):

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

Опції беруться з заданої змінної, як описано вище в **"Словник зі списком"** :

<figure><img src="/files/25729f24bc7cd5d2a59f7db89c0c6d90bd115f2a" alt="" width="563"><figcaption></figcaption></figure>

### Примітки

* Змінну inline\_bot можна задавати не лише в загальних змінних, а й як просту змінну, але в цьому випадку її значення має бути взяте в одинарні лапки.

Приклад у полі калькулятора:

inline\_bot = '\["Milk", "Bread", "Pasta", "Chocolate", "Eggs", "Butter", "Puff Pastry", "Tea", "Vegetables", "Fruits", "#{aa}"]'

Ви також можете передавати будь-яке значення як змінну для більш гнучкого налаштування.

Наприклад, простий варіант у масиві:

<div data-with-frame="true"><figure><img src="/files/6a1ffffea3443c2d1bc213d91df99752ce92e0b2" 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/uk/chatbot/mesendzheri/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.