# Таблица в чат-боте

Бот умеет читать таблицу: находит подходящие строки и отправляет их человеку сообщениями. Для этого в сценарии есть блок «Чтение строк из Таблицы». Настройки блока описаны на странице [Чтение строк из Таблицы](https://support.watbot.ru/chatbots/blocks/lists/wat-sheet-reader), здесь — как подготовить саму таблицу.

Записывать в таблицу, менять и удалять строки бот не умеет. Если сценарий должен сохранять данные — заявки, ответы, заказы — используйте [списки](https://support.watbot.ru/lists).

## Какие таблицы видит бот

В блоке выбираются «Таблица» и «Лист». Бот читает только таблицы владельца бота — из любого его проекта, а не только из того, где лежит бот.

## Как подготовить таблицу

1. **Одна строка — одна запись.** Товар, услуга, адрес, занятие в расписании — каждая в своей строке.
2. **Первая строка — заголовки.** Блок по умолчанию читает лист со второй строки (настройка «Начинать поиск в листе со строки»), поэтому в первой удобно подписать столбцы: «Название», «Цена», «Фото».
3. **Запомните буквы столбцов.** В блоке значения подставляются по букве столбца: `{{ A }}`, `{{ B }}`. Названия из первой строки блок не использует.
4. **Не оставляйте строки без данных в нужных столбцах.** Строку, в которой пусты все столбцы из шаблона сообщения, бот пропускает.

Пример листа для цветочного магазина «Ромашка»:

| | A | B | C | D |
|---|---|---|---|---|
| 1 | Название | Цена | Категория | Фото |
| 2 | Букет «Весна» | 2500 | букеты | `https://example.com/vesna.jpg` |
| 3 | Роза красная | 180 | цветы | `https://example.com/rose.jpg` |

Шаблон сообщения в блоке для такого листа: `{{ A }} — {{ B }} ₽`.

![Лист для бота: заголовки в первой строке, ссылки на фото в столбце D](https://support.watbot.ru/_media/ru/10-tables/_images/bot-sheet.webp?v=1791781231)

## Фото и файлы

Чтобы бот прислал картинку или файл, запишите в ячейку прямую ссылку на него — адрес, который начинается с `http://` или `https://`. В блоке для такой ячейки добавляется часть «Фото» или «Файл» с буквой столбца.

Загрузить картинку в саму таблицу нельзя: в ячейках хранится только текст.

## Отбор и сортировка

«Фильтры» блока сравнивают значение в столбце с текстом, ответом человека, переменной контакта или номером контакта («Текущий контакт»). «Сортировка» задаёт столбец и порядок.

> [!WARNING]
> Все значения в таблице — текст, и сравниваются они как текст, посимвольно. Точное совпадение (`=`) работает надёжно. Сравнения «больше» и «меньше» и сортировка чисел разной длины дают неожиданный результат: «1000» окажется раньше, чем «250». Если нужно сравнивать и сортировать числа или даты, храните данные в [списке](https://support.watbot.ru/lists) с полями нужного типа.

Чтобы показывать человеку только его строки, заведите столбец с номером контакта и добавьте в блоке фильтр «Текущий контакт» по этому столбцу.

## Сколько строк увидит человек

Блок отправляет от 1 до 10 строк за один раз и не листает дальше. Если под условия подходит больше строк, человек увидит только первые. Сужайте выборку фильтрами или разбейте данные по листам — например, по категориям.

## Если что-то не работает

- **Бот отвечает «Записи не найдены».** Под фильтры не подошла ни одна строка, в подходящих строках пусты все столбцы из шаблона, либо таблица удалена. Проверьте также, что данные начинаются не выше строки из настройки «Начинать поиск в листе со строки».
- **Бот отвечает «Таблица не задана» или «Лист не задан».** В блоке не выбрана таблица или лист.
- **Бот отвечает «Шаблоны не найдены».** В блоке пуст «Шаблон цепочки сообщений».
- **Вместо фото ничего не приходит.** В ячейке должна быть ссылка, начинающаяся с `http://` или `https://`, без лишнего текста.