# Google Таблицы: блок «Вставка строки»

Source: https://docs.botman.pro/a/234-google-tablitsy-blok-vstavka-stroki

Когда блок срабатывает, он берёт значения из переменных (например, Имя, Email, Телефон) и добавляет их в таблицу. Это удобно, если вы хотите сохранить заявки, ответы, события или другую информацию прямо из бота.

Когда пригодится:

- Сбор заявок и регистраций → Каждый пользователь = новая строка в таблице.
- Сохранение ответов из форм или квизов → Вся информация сохраняется структурированно и доступна для экспорта.
- Учёт заказов и оплат → Можно зафиксировать, кто, когда и что заказал.
- Фиксация действий пользователя → Добавляйте в таблицу метки, статусы, результаты.
- Передача данных в другие сервисы → Google Таблицы можно использовать как мост к CRM, рассылкам или 1С.

---

**Где найти блок «Вставка строки» и как его добавить**

Чтобы использовать блок «Вставка строки» в сценарии, сначала его нужно добавить на канву конструктора.

Для этого:\
Перейдите в нужный сценарий **→** шаг «Действие» → «Добавить действие» **→** «Интеграции Google Таблицы» **→** «Вставка строки»

После этого блок появится на канве, и его можно будет настроить.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/4d01e4625689db4861b4f507f76af6eb8d46f9a3fade1263411bffb59df058dd.png)

---

## **Блок работает только при активной интеграции**

Для работы блока необходимо, чтобы Google-аккаунт был подключён в разделе «Интеграции».

Если интеграция не настроена:

- блок может не отображаться в списке доступных;
- вы не сможете выбрать таблицу или подгрузить листы;
- сохранение данных не сработает.

👉 Подробнее: см. [инструкцию по подключению интеграции](https://docs.botman.pro/a/228-integratsiya-s-google-tablitsami)

---

**Что подготовить в Google Таблице перед настройкой блока**

Для корректной работы блока «Вставить строку» важно заранее правильно оформить таблицу. Ниже — ключевые требования и рекомендации.

**1. Заголовки в первой строке**

- Первая строка таблицы должна содержать названия столбцов, например: Имя, Телефон, Email, Дата, Статус и т. д.
- Эти заголовки будут использоваться при настройке блока — именно по ним вы будете сопоставлять, какое значение записывать в какую колонку.
- Если заголовки отсутствуют (первая строка пуста), блок не сможет отобразить список полей и не сработает.

Рекомендация: используйте короткие и понятные названия без спецсимволов и лишних пробелов.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/74fbf892c76a605d29f170ee0f2758ae1dac6f88943832ad0b2172f0f48d61aa.png)

**2. Только столбцы от A до Z**

- Блок работает только с первыми 26 колонками (от A до Z). Это техническое ограничение платформы.
- Если в таблице есть дополнительные столбцы (AA, AB и т. д.), они не будут отображаться и не будут использоваться в сценарии.

📌 Обратите внимание: такие столбцы могут появиться автоматически, если вы:

- импортировали таблицу из Excel или CSV,
- случайно вставили содержимое далеко за пределами таблицы,
- копировали данные из другой таблицы или листа.

Совет: удалите ненужные столбцы правее колонки Z, чтобы избежать путаницы.

**3. Доступ к таблице из подключённого аккаунта**

Для корректной работы таблица должна быть доступна подключённому Google-аккаунту с правами «Редактор».

Возможны два варианта:

- таблица принадлежит аккаунту, подключённому в интеграции;
- таблица расшарена на этот аккаунт напрямую или по ссылке — обязательно с правами «Редактор».

🔒 Если у подключённого аккаунта есть только права:

- Читатель — блок не работает, данные не загружаются;
- Комментатор — также не работает;
- Редактор — всё работает корректно.

📌 При недостаточных правах блок не покажет ошибку, но данные не будут подгружаться или записываться — это может выглядеть как «тихий сбой».

Важно: если вы тестируете сценарий и не видите новую строку — первым делом проверьте права доступа к таблице.

**4. Пустая таблица — допустимо**

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

📌 Для отладки удобно временно добавить одну-две строки с тестовыми значениями. Это поможет убедиться, что вставка работает, переменные подставляются, а структура таблицы читается корректно.

---

**Пошаговая настройка блока «Вставка строки»**

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

**Шаг 1: Вставьте ссылку на Google Таблицу**\
В поле «Ссылка на таблицу» вставьте URL из адресной строки Google Таблиц.\
Пример:`https://docs.google.com/spreadsheets/d/1aBcD...`

После этого автоматически подгрузится список рабочих листов — они появятся в выпадающем списке ниже.

Обратите внимание:

- Таблица должна быть доступна из подключённого аккаунта, иначе листы не подгрузятся.
- В таблице должна быть хотя бы одна строка с заголовками (первая строка).
- Если вы не видите список листов — проверьте права доступа и правильность ссылки.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/e3771ac0779138443768272a6e232cf673591c46d87210403023d9292ce5db84.png)

**Шаг 2: Выберите рабочий лист**

После того как вы вставили ссылку на Google Таблицу, BotMan автоматически подгрузит список всех листов, которые есть в этом файле.

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

Обратите внимание:\
Если список не подгружается:

- проверьте корректность ссылки;
- убедитесь, что у подключённого аккаунта есть доступ к таблице;
- проверьте, есть ли заголовки в первой строке на выбранном листе (A1–Z1).
- Если названия листов слишком длинные, они могут обрезаться визуально — но данные при этом подтягиваются корректно.

⚠️ Если выбранный лист не содержит заголовков, BotMan покажет предупреждение и не позволит продолжить настройку.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/03cf754fa39aec7888471dcf1edd45ec6ffd10436b5afdab0d1ac2fcc4b2017c.png)

**Шаг 3: Настройте сопоставление столбцов и переменных**\
На этом этапе вы указываете, какие данные из сценария нужно сохранить в таблицу и в какие именно столбцы они должны попасть.

Это важнейший шаг, поскольку именно он определяет:

- что именно будет записано в таблицу при выполнении блока;
- из каких переменных будут подставляться значения;
- в какие колонки они попадут.

Как работает:

- Слева отображаются заголовки столбцов из таблицы (строка №1).
- Справа — вы выбираете переменную, из которой бот возьмёт значение.

📌 Для каждого заголовка вы можете указать соответствующую переменную, которая содержит нужные данные.

Пример: значение из переменной {{user\_name}} → Столбец Имя в таблице

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/1c36f808c296c1889fa6a9876015223f1ce6d1e117cfa37614f31aacf8a55a40.png)

Что произойдёт при выполнении блока

- Если блок выполнился успешно — будет создана новая строка, в которой:\
  \- Каждая выбранная переменная подставит своё значение в соответствующий столбец.\
  \- Столбцы, для которых переменная не указана, останутся пустыми.
- Если переменная пуста — в таблицу будет записано пустое значение.
- Если сопоставление не настроено вовсе — строка может добавиться, но останется пустой.

Обратите внимание:

- Вы можете указать любое количество сопоставлений — от одного до всех (в пределах колонок A–Z).
- Название переменной нельзя ввести вручную. Выберите нужную из выпадающего списка.
- В списке доступны:\
  🔹 Системные переменные (например, Имя, Телефон) — только те, в которые разрешена запись. Технические переменные (например, Дата подписки, Статус пользователя, Telegram ID) — нельзя использовать, они доступны только для чтения.\
  🔹 Пользовательские поля, созданные вами в настройках.\
  🔹 Глобальные переменные, доступные в вашем аккаунте.
- Все значения записываются в таблицу в виде текста (даже если это дата, число и т. п.).

---

**Финальный шаг: протестируйте сценарий**

Чтобы убедиться, что блок работает корректно, обязательно протестируйте его до публикации сценария.

**Как это сделать:**

1. В режиме редактирования сценария перейдите в верхнюю панель.
2. Нажмите кнопку «Тестировать».
3. Выберите режим:

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

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/bab93f7a40235a28ad0669c0903bf5541e9e2b6d9207e49baf831b30b75d56aa.png)

**Что проверить:**

- Создаётся ли новая строка в нужной таблице и на нужном листе?
- Подставились ли данные корректно (все переменные отработали)?
- Не пустые ли ячейки?
- Отработал ли шаг при разных типах входных данных (например, при пустой переменной)?

**💡 Советы:**

- Добавьте временный шаг с сообщением перед «Вставкой строки», чтобы проверить, какие значения содержат переменные.
- Проверьте структуру таблицы: все ли заголовки указаны, нет ли лишних колонок.
- Если данные не записались, проверьте права доступа и наличие интеграции.

---

**🚫 Возможные ошибки и что делать**

Даже при правильной настройке блок может не сработать. Ниже — список частых ситуаций и объяснение, как их устранить.

**❌ Блок не записывает данные, но ошибок не видно**

Что это может значить:

- У таблицы нет заголовков в первой строке.
- Переменные не сопоставлены — блок не знает, что именно записывать.
- Переменные пустые — ничего не передаётся.
- Таблица недоступна (отключена интеграция или нет прав доступа).

Что делать:

- Убедитесь, что в первой строке есть заголовки.
- Проверьте настройки сопоставления столбцов и переменных.
- Проверьте значения переменных в предыдущих шагах.
- Переподключите интеграцию и проверьте доступ к таблице.

**❌ Строка не добавляется**

Что это может значить:

- Подключённый Google-аккаунт не имеет прав «Редактор».
- Таблица удалена, перемещена или закрыта.
- Указан неправильный лист или он был переименован.

Что делать:

- Откройте таблицу в Google и проверьте:\
  \- доступ для подключённого аккаунта,\
  \- наличие листа,\
  \- структуру заголовков.
- Заново вставьте ссылку в блок и выберите актуальный лист.

**❌ Данные записались в неправильные столбцы**

Что это может значить:

- Заголовки столбцов изменились в таблице после настройки.
- Порядок столбцов был нарушен.
- Неправильно сопоставлены переменные.

Что делать:

- Откройте блок и заново сопоставьте переменные.
- Убедитесь, что заголовки таблицы остались прежними.
- Проверьте, не поменяли ли вы названия столбцов в Google Таблице.

**❌ Появились лишние столбцы (AA, AB…)**

Что это может значить:

- Вы случайно заполнили ячейки за пределами колонки Z.
- При импорте таблицы из Excel или другой системы добавились лишние колонки.

Что делать:

- Удалите пустые или неиспользуемые столбцы правее Z.
- Очистите «мусорные» ячейки, даже если они кажутся пустыми.

**❌ Переменные не подставились**

Что это может значить:

- Переменная не была получена до момента вставки строки.
- Используется переменная, которая недоступна (удалили).

Что делать:

- Убедитесь, что переменные задаются в предыдущих шагах.
- Проверьте переменные в тестовом сценарии (через сообщение или шаг «Проверка поля»).
- Используйте только разрешённые переменные из выпадающего списка.