# Таблицы в Salebot

**Раздел «Таблицы» в Сейлбот**— инструмент для удобного хранения и управления данными внутри платформы. Теперь не нужно переключаться между разными сервисами : все таблицы доступны в одном проекте.

<figure><img src="/files/w5WcDtUgKsZcp3ACZE8E" alt=""><figcaption></figcaption></figure>

**Возможности:**

* Создание таблиц с любым количеством строк и столбцов.
* Хранение и редактирование данных без сторонних инструментов и сервисов.&#x20;
* Ввод значений, редактирование строк и столбцов или удаление через чат-бота с помощью функций

**Преимущества:**\
\&#xNAN;**✔ Упрощает работу с данными:** вводить информацию в таблицу можно прямо из бота. \
✔ **Гибкость и простота** – создавайте столько таблиц, сколько нужно, настраивайте их под свои бизнес-задачи.\
\&#xNAN;**✔ Возможность управлять таблицами без выхода из Salebot.**

Таблицы помогают бизнесу структурировать данные и ускорить процессы.

## Как создать таблицу

Для начала перейдите в раздел таблицы в необходимом проекте:

<figure><img src="/files/0E2CFQVYaLYiKzfGMIOz" alt=""><figcaption></figcaption></figure>

Далее вы увидите кнопку "Добавить таблицу", кликнув по которой откроется модальное окошко, в котором нужно ввести название таблицы:

<div><figure><img src="/files/wcN5P260C6jrNBsJw8OU" alt=""><figcaption></figcaption></figure> <figure><img src="/files/FGOK6VFqYhdJtN9SANEX" alt=""><figcaption></figcaption></figure></div>

Пропишите название для таблицы и кликните на кнопку "Готово". Тогда новая таблица будет создана в проекте и появится в разделе "Таблицы":

<figure><img src="/files/xsnv4aB8EYwMJkYAvUKT" alt=""><figcaption></figcaption></figure>

### Настройки таблицы

После того как вы создали таблицу, необходимо добавить строки и колонки. Для этого на плашке нужной таблицы найдите кнопку "Перейти" и кликните по ней:

<figure><img src="/files/2K0Z97YXXdaFNLtH3tnd" alt=""><figcaption></figcaption></figure>

Вы увидите следующие настройки:

<figure><img src="/files/MTVWj2qSm0KMDPlBJHwk" alt=""><figcaption></figcaption></figure>

1. Функция для добавления столбцов:

а) Для добавления буквенных столбцов:

<figure><img src="/files/zDxbNz3w2HJ5KNHH5KTC" alt="" width="375"><figcaption></figcaption></figure>

При клике на кнопку в таблицу добавятся столбцы с обозначением от A до Z.&#x20;

<figure><img src="/files/IW9KgfnTIM4PVamPrFaM" alt=""><figcaption></figcaption></figure>

б) для добавления столбцов с названиями:

<figure><img src="/files/l2i1ffzebzmtVNq4VCa4" alt="" width="563"><figcaption></figcaption></figure>

при клике на кнопку появится модальное окно, в котором нужно прописать название для добавляемого столбца:

<figure><img src="/files/pQA7kUyS5WCXI1chzamS" alt=""><figcaption></figcaption></figure>

После того как вы прописали название столбца, кликните по кнопке "Готово", тогда новый столбец добавится в таблицу:

<figure><img src="/files/P3LH0ujbkMGDrulDvyFH" alt="" width="563"><figcaption></figcaption></figure>

2. Кнопка для добавления строк в таблицу:

а) можно добавить фиксированное количество строк (100) в таблицу:

<figure><img src="/files/cucvw8vLEP4NvViBnNd0" alt=""><figcaption></figcaption></figure>

б) или заданное количество строк:&#x20;

<figure><img src="/files/GRYghHg02GokHxDrXNWn" alt=""><figcaption></figcaption></figure>

3. Экспорт таблицы

<figure><img src="/files/mpZA2AUuIykH49rzsII1" alt=""><figcaption></figcaption></figure>

Поможет экспортировать таблицу в формате csv со всеми данными и значениями, например, чтобы перенести таблицу в другой проект Сейлбот или в другой сервис для таблиц.

4. Импорт таблицы - для загрузки таблицы из иных сервисов.&#x20;

<figure><img src="/files/DwXCgjCJMB9dzPMfjP6E" alt=""><figcaption></figcaption></figure>

### Другие возможности

Существует выпадающее меню, с помощью которого вы быстро можете просматривать таблицы, не выходя в основной раздел.&#x20;

<figure><img src="/files/SB0td0NbKpXWMhXfIzRC" alt="" width="563"><figcaption></figcaption></figure>

Также можно создавать новые таблицы при открытии бокового меню.&#x20;

Чтобы удалить таблицу, перейдите в основной раздел:

<figure><img src="/files/RkXzwjRMmYdGHtps66wB" alt=""><figcaption></figcaption></figure>

И на плашке с ненужной таблицей найдите кнопку для удаления.&#x20;

{% hint style="warning" %}
Внимание!&#x20;

Восстановить удаленную таблицу нельзя.&#x20;
{% endhint %}

## Как вводить значения в таблицу

Вводить значения в таблицу можно вручную:

<figure><img src="/files/rw4zX4B7twkH1Xn8iFaL" alt="" width="563"><figcaption></figcaption></figure>

Также с помощью функций в чат-боте.&#x20;

### Где найти ID таблицы?

Чтобы работать с функциями для чат-бота, понадобится ID таблицы.

Для начала перейдите в нужную таблицу: для этого найдите в списке искомую таблицу и кликните по ней:

<figure><img src="/files/U8YfTe4BdDqaUhb0hs8m" alt=""><figcaption></figcaption></figure>

Далее кликните по адресной строке:

<figure><img src="/files/CKVPrzpx3eMtdjVgjwbY" alt=""><figcaption></figcaption></figure>

В адресной строке вы увидите адрес вида "<https://salebot.pro/projects/11111/table/><mark style="color:red;">**2**</mark>", где найдете ID нужной таблицы:

<figure><img src="/files/N8iUi6UrcbAZttzE4w36" alt=""><figcaption></figcaption></figure>

### Создать новую запись в таблице

new\_record(table\_id, data) - создать новую запись в таблице с указанными значениями.

\- table\_id - id таблицы

\- data - словарь с данными, которые нужно записать. пример: {"column\_name1": "value1", "column\_name2": "value2"}. Если колонка не существует, она создается

Ответ: ID новой записи

### Пример

<figure><img src="/files/XTTEVxaDfXsxcPhQl9SW" alt=""><figcaption></figcaption></figure>

### Редактировать существующую запись в таблице

edit\_record(table\_id, record\_id, data)

\- table\_id - id таблицы

\- record\_id - id редактируемой записи

\- data - словарь с данными, которые нужно изменить. пример: {"column\_name1": "value3", "column\_name2": "value4"}. Если колонка не существует, она НЕ создается

Ответ:

Возвращает полные данные по отредактированной записи в формате {"column\_name1": "value3", "column\_name2": "value4"}

### Пример

<figure><img src="/files/MjNOywDylzfHAlNwRh1C" alt=""><figcaption></figcaption></figure>

### Удалить запись из таблицы по id записи

delete\_record(table\_id, record\_id)

\- table\_id - id таблицы

\- record\_id - id записи на удаление. record\_id может быть как одним значением, так и массивом значений, например \[1, 2, 5]

Ответ:

{'message': 'Удалено записей: 1'}

### Найти первую запись по указанному значению в таблице

Найти первую запись по указанному значению в таблице

find\_record(table\_id, value, find\_in, return\_from)

\- table\_id - id таблицы

\- value - значение, по которому ищем совпадение

\- find\_in - необязательный параметр. Название столбца, по которому ведём поиск. если не указан, ищем запись по всем столбцам

\- return\_from - необязательный параметр. Название столбца из которого нужно вернуть значение.&#x20;

Ответ:

Если return\_from указан, вернется значение указанного столбца, если он есть в таблице. Если return\_from не указан или такого столбца нет, в ответе будут полные данные по найденной записи {"column\_name1": "value3", "column\_name2": "value4"}

### Пример

<figure><img src="/files/NyyPObHACuPGU10SgYN3" alt=""><figcaption></figcaption></figure>

### Получить значения из указанной записи

get\_record\_data(table\_id, record\_id, return\_column )&#x20;

\- table\_id - id таблицы

\- record\_id - id записи, из которой берем значения

\- return\_column - необязательный параметр. Название столбца из которого нужно вернуть значение.

Ответ: Если запись найдена, возвращает словарь типа {"column\_name1": "value1", "column\_name2": "value2"}. Если при этом передан параметр return\_column и такой столбец существует, в ответе будет значение только по этому столбцу.

### Получение всех значений при поиске по нескольким колонкам&#x20;

find\_records\_multiple\_cols\_list(table\_id, column\_data, return\_col, with\_index, delimiter, algorithm) — Если возникла необходимость искать по нескольким колонкам сразу и получить список значений из колонки в строках, в которых будут найдены все значения, то нужно использовать следующую функцию (аналог функции sheet\_search\_in\_multiple\_cols\_return\_list для гугл таблиц)

• table\_id — id таблицы

• column\_data — поисковый запрос, то что нужно найти

• return\_col — номер колонки, из которой нужно вернуть значения

• with\_index — индекс или номер в списке найденных значений (0 - нумерация (1,2,3,…); 1 - индекс строки; "" - список значений с новой строки без индексов и нумерации)

• delimiter — разделитель между индексом и значением

• algorithm — алгоритм поиска (F - полное совпадение, K - наличие ключевых слов, R - регулярное выражение, 1-100 - процент похожести (подробнее выше))

Пример:

table\_id = 7

data = {"возраст": "26", "город": "Москва"}

return\_col = "имя"

with\_index = 1

delimiter = " - "

algorithm = "F"

res = find\_records\_multiple\_cols\_list(table\_id, data, return\_col, with\_index, delimiter, algorithm)

res\_list = res\["list"]

<figure><img src="/files/YWdLXOj9dxnwPkI2OhcW" alt="" width="509"><figcaption></figcaption></figure>

<figure><img src="/files/AwhXVvAgDkozHXg4j5oA" alt=""><figcaption></figcaption></figure>

Если проблем при выполнении запроса не возникло, то в ответ приходит словарь содержащий статус и все ячейки со значениями&#x20;

{"status":true,"rows\_index":\[2,3],"quantity":2,"list":"2 - Илья\n3 - Раиса"}

• status — результат поиска

• rows\_index — массив с номерами найденных строк

• quantity — количество найденных строк

• list — строка со всеми значениями из выбранного столбца

Если возникла ошибка, то вернется статус false и описание ошибки {"status":false,"error":"Ошибка или описание"}

### Получение первого значения при поиске по нескольким колонкам

find\_first\_record\_multiple\_cols\_row(table\_id, column\_data, algorithm) — Если возникла необходимость искать по нескольким колонкам сразу и получить первую найденную строку, то нужно использовать следующую функцию (Аналог функции sheet\_search\_in\_multiple\_cols\_return\_row для гугл таблиц)

• table\_id — ид таблицы

• columns — поисковый запрос, то что нужно найти

• algorithm — алгоритм поиска (F - полное совпадение, K - наличие ключевых слов, R - регулярное выражение, 1-100 - процент похожести (подробнее выше))

Пример

table\_id = 7

data = {"возраст": "26", "город": "Москва"}

algorithm = "F"

res = find\_first\_record\_multiple\_cols\_row(table\_id, data, algorithm)

row\_data = res\["row\_data"]

row\_id = row\_data\["ID"]

row\_name = row\_data\["имя"]

row\_age = row\_data\["возраст"]

<figure><img src="/files/UBzB1Xctche1wEG0t23h" alt="" width="506"><figcaption></figcaption></figure>

<figure><img src="/files/aaFauXfqdbg8Hx41BBzX" alt=""><figcaption></figcaption></figure>

Если проблем при выполнении запроса не возникло, то в ответ приходит словарь содержащий статус и все ячейки со значениями&#x20;

{"status":true,"rows\_index":\[2,3],"quantity":2,"row\_data":{"ID":2,"имя":"Илья","возраст":"26","город":"Москва"},"row":2}

• status — результат поиска

• rows\_index — массив с номерами найденных строк

• row\_data — данные из найденной строки

• row — номер найденной строки

Если возникла ошибка, то вернется статус false и описание ошибки {"status":false,"error":"Ошибка или описание"}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.salebot.pro/tablicy/tablicy-v-salebot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
