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

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

Записувати в таблицю, змінювати й видаляти рядки бот не вміє. Якщо сценарій має зберігати дані — заявки, відповіді, замовлення — використовуйте [списки](https://support.watbot.org/uk/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.org/_media/uk/10-tables/_images/bot-sheet.webp?v=1791781231)

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

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

Завантажити картинку в саму таблицю не можна: у клітинках зберігається лише текст.

## Відбір і сортування

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

> [!WARNING]
> Усі значення в таблиці — текст, і порівнюються вони як текст, посимвольно. Точний збіг (`=`) працює надійно. Порівняння «більше» й «менше» та сортування чисел різної довжини дають несподіваний результат: «1000» опиниться раніше, ніж «250». Якщо потрібно порівнювати й сортувати числа або дати, зберігайте дані в [списку](https://support.watbot.org/uk/lists) з полями потрібного типу.

Щоб показувати людині лише її рядки, заведіть стовпець із номером контакту й додайте в блоці фільтр «Поточний контакт» за цим стовпцем.

## Скільки рядків побачить людина

Блок надсилає від 1 до 10 рядків за один раз і далі не гортає. Якщо під умови підходить більше рядків, людина побачить лише перші. Звужуйте вибірку фільтрами або розбийте дані по аркушах — наприклад, за категоріями.

## Якщо щось не працює

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