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

Бот умеет читать таблицу: находит подходящие строки и отправляет их человеку сообщениями. Для этого в сценарии есть блок «Чтение строк из Таблицы». Настройки блока описаны на странице Чтение строк из Таблицы, здесь — как подготовить саму таблицу.

Записывать в таблицу, менять и удалять строки бот не умеет. Если сценарий должен сохранять данные — заявки, ответы, заказы — используйте списки.

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

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

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

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

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

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

Фото и файлы#

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

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

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

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

Внимание

Все значения в таблице — текст, и сравниваются они как текст, посимвольно. Точное совпадение (=) работает надёжно. Сравнения «больше» и «меньше» и сортировка чисел разной длины дают неожиданный результат: «1000» окажется раньше, чем «250». Если нужно сравнивать и сортировать числа или даты, храните данные в списке с полями нужного типа.

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

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

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

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

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