# Вбудований бот Телеграм

Блок вмикає для бота вбудований режим Telegram. Людина в будь-якому чаті набирає `@назва_бота` і текст — і просто над полем введення бачить результати пошуку за вашим списком: товари, адреси, послуги.

![Панель налаштувань блоку «Вбудований бот Телеграм»](https://support.watbot.org/_media/uk/01-chatbots/03-blocks/06-developer/_images/inline-telegram.webp?v=1791781231)

У цей блок не ведуть зв'язки з інших блоків: він спрацьовує на запит із Telegram.

> [!IMPORTANT]
> Вбудований режим потрібно ввімкнути в самого бота: у [@BotFather](https://t.me/BotFather) надішліть команду `/setinline` і виберіть бота.

## Налаштування

- **«Список»** — список, за яким іде пошук.
- **«Поле для пошуку»** — поле списку, у якому бот шукає набраний людиною текст. Якщо поле не вибрано, бот показує записи без пошуку.
- **«Тег»** — категорія, за якою запускається саме цей блок. Людина пише її після імені бота з решіткою: `@назва_бота #тег текст`. У тегу — лише латинські літери та цифри. Запит без тегу обробляє блок, у якого поле «Тег» порожнє.
- **«Додаткові фільтри»** — умови, які звужують вибірку: поле списку, знак порівняння і значення. Умови з'єднуються через «І» або «АБО». Рядок додає кнопка «Додати поле».
- **«Сортування»** — за яким полем і в якому порядку показувати записи: «За зростанням» або «За зменшенням». Без сортування спочатку йдуть нові записи.
- **«Поля для результатів пошуку»** — що людина побачить у кожному результаті:
  - «Зображення» — поле списку із зображенням;
  - «Заголовок» — текстове або числове поле. Записи з порожнім заголовком у результати не потрапляють;
  - «Опис» — рядок під заголовком.
- **«Додатково»** → «Записати відповідь в користувацюку змінну» — у змінну потрапить заголовок вибраного запису.

## Як це працює

1. Людина набирає `@назва_бота` і текст. Бот показує до 50 записів, під час прокручування підвантажує наступні.
2. Людина вибирає запис. У чат від її імені йде повідомлення з командою блоку та заголовком запису.
3. Якщо це чат із вашим ботом, бот зберігає заголовок у змінну та йде за зв'язком «Продовжити».

Якщо нічого не знайшлося, людина побачить один пункт — «Пошук не дав результатів».

> [!TIP]
> Щоб людині не набирати ім'я бота вручну, додайте в меню блоку з кнопками пункт із типом «Відкрити вбудований бот Телеграм». У полі «Текст для пошуку» можна одразу задати початок запиту, наприклад `#тег`.

## Виходи

- «Продовжити» — людина вибрала запис із результатів у чаті з ботом.

## Обмеження

- Блок працює лише в Telegram.
- Значення фільтра — до 64 символів, фільтрів — до 100, полів сортування — до 10.