# Встроенный бот Телеграм

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

![Панель настроек блока «Встроенный бот Телеграм»](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/06-developer/_images/inline-telegram.webp?v=1791781230)

В этот блок не ведут связи из других блоков: он срабатывает на запрос из Telegram.

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

## Настройки

- **«Список»** — список, по которому идёт поиск.
- **«Поле для поиска»** — поле списка, в котором бот ищет набранный человеком текст. Если поле не выбрано, бот показывает записи без поиска.
- **«Тег»** — категория, по которой запускается именно этот блок. Человек пишет её после имени бота с решёткой: `@имя_бота #тег текст`. В теге — только латинские буквы и цифры. Запрос без тега обрабатывает блок, у которого поле «Тег» пустое.
- **«Дополнительные фильтры»** — условия, которые сужают выборку: поле списка, знак сравнения и значение. Условия соединяются через «И» или «ИЛИ». Строку добавляет кнопка «Добавить поле».
- **«Сортировка»** — по какому полю и в каком порядке показывать записи: «По возрастанию» или «По убыванию». Без сортировки сначала идут новые записи.
- **«Поля для результатов поиска»** — что человек увидит в каждом результате:
  - «Картинка» — поле списка с изображением;
  - «Заголовок» — текстовое или числовое поле. Записи с пустым заголовком в результаты не попадают;
  - «Описание» — строка под заголовком.
- **«Дополнительно»** → «Записать ответ в пользовательскую переменную» — в переменную попадёт заголовок выбранной записи.

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

1. Человек набирает `@имя_бота` и текст. Бот показывает до 50 записей, при прокрутке подгружает следующие.
2. Человек выбирает запись. В чат от его имени уходит сообщение с командой блока и заголовком записи.
3. Если это чат с вашим ботом, бот сохраняет заголовок в переменную и идёт по связи «Продолжить».

Если ничего не нашлось, человек увидит один пункт — «Поиск не дал результатов».

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

## Выходы

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

## Ограничения

- Блок работает только в Telegram.
- Значение фильтра — до 64 символов, фильтров — до 100, полей сортировки — до 10.