Google Таблицы: блок «Вставка строки»
Когда блок срабатывает, он берёт значения из переменных (например, Имя, Email, Телефон) и добавляет их в таблицу. Это удобно, если вы хотите сохранить заявки, ответы, события или другую информацию прямо из бота.
Когда пригодится:
Сбор заявок и регистраций → Каждый пользователь = новая строка в таблице.
Сохранение ответов из форм или квизов → Вся информация сохраняется структурированно и доступна для экспорта.
Учёт заказов и оплат → Можно зафиксировать, кто, когда и что заказал.
Фиксация действий пользователя → Добавляйте в таблицу метки, статусы, результаты.
Передача данных в другие сервисы → Google Таблицы можно использовать как мост к CRM, рассылкам или 1С.
Где найти блок «Вставка строки» и как его добавить
Чтобы использовать блок «Вставка строки» в сценарии, сначала его нужно добавить на канву конструктора.
Для этого:
Перейдите в нужный сценарий → шаг «Действие» → «Добавить действие» → «Интеграции Google Таблицы» → «Вставка строки»
После этого блок появится на канве, и его можно будет настроить.
Блок работает только при активной интеграции
Для работы блока необходимо, чтобы Google-аккаунт был подключён в разделе «Интеграции».
Если интеграция не настроена:
блок может не отображаться в списке доступных;
вы не сможете выбрать таблицу или подгрузить листы;
сохранение данных не сработает.
👉 Подробнее: см. инструкцию по подключению интеграции
Что подготовить в Google Таблице перед настройкой блока
Для корректной работы блока «Вставить строку» важно заранее правильно оформить таблицу. Ниже — ключевые требования и рекомендации.
1. Заголовки в первой строке
Первая строка таблицы должна содержать названия столбцов, например: Имя, Телефон, Email, Дата, Статус и т. д.
Эти заголовки будут использоваться при настройке блока — именно по ним вы будете сопоставлять, какое значение записывать в какую колонку.
Если заголовки отсутствуют (первая строка пуста), блок не сможет отобразить список полей и не сработает.
Рекомендация: используйте короткие и понятные названия без спецсимволов и лишних пробелов.
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...
После этого автоматически подгрузится список рабочих листов — они появятся в выпадающем списке ниже.
Обратите внимание:
Таблица должна быть доступна из подключённого аккаунта, иначе листы не подгрузятся.
В таблице должна быть хотя бы одна строка с заголовками (первая строка).
Если вы не видите список листов — проверьте права доступа и правильность ссылки.
Шаг 2: Выберите рабочий лист
После того как вы вставили ссылку на Google Таблицу, BotMan автоматически подгрузит список всех листов, которые есть в этом файле.
В выпадающем списке отобразятся все листы с их названиями — выберите нужный, с которым будете работать.
Обратите внимание:
Если список не подгружается:
проверьте корректность ссылки;
убедитесь, что у подключённого аккаунта есть доступ к таблице;
проверьте, есть ли заголовки в первой строке на выбранном листе (A1–Z1).
Если названия листов слишком длинные, они могут обрезаться визуально — но данные при этом подтягиваются корректно.
⚠️ Если выбранный лист не содержит заголовков, BotMan покажет предупреждение и не позволит продолжить настройку.
Шаг 3: Настройте сопоставление столбцов и переменных
На этом этапе вы указываете, какие данные из сценария нужно сохранить в таблицу и в какие именно столбцы они должны попасть.
Это важнейший шаг, поскольку именно он определяет:
что именно будет записано в таблицу при выполнении блока;
из каких переменных будут подставляться значения;
в какие колонки они попадут.
Как работает:
Слева отображаются заголовки столбцов из таблицы (строка №1).
Справа — вы выбираете переменную, из которой бот возьмёт значение.
📌 Для каждого заголовка вы можете указать соответствующую переменную, которая содержит нужные данные.
Пример: значение из переменной {{user_name}} → Столбец Имя в таблице
Что произойдёт при выполнении блока
Если блок выполнился успешно — будет создана новая строка, в которой:
- Каждая выбранная переменная подставит своё значение в соответствующий столбец.
- Столбцы, для которых переменная не указана, останутся пустыми.Если переменная пуста — в таблицу будет записано пустое значение.
Если сопоставление не настроено вовсе — строка может добавиться, но останется пустой.
Обратите внимание:
Вы можете указать любое количество сопоставлений — от одного до всех (в пределах колонок A–Z).
Название переменной нельзя ввести вручную. Выберите нужную из выпадающего списка.
В списке доступны:
🔹 Системные переменные (например, Имя, Телефон) — только те, в которые разрешена запись. Технические переменные (например, Дата подписки, Статус пользователя, Telegram ID) — нельзя использовать, они доступны только для чтения.
🔹 Пользовательские поля, созданные вами в настройках.
🔹 Глобальные переменные, доступные в вашем аккаунте.Все значения записываются в таблицу в виде текста (даже если это дата, число и т. п.).
Финальный шаг: протестируйте сценарий
Чтобы убедиться, что блок работает корректно, обязательно протестируйте его до публикации сценария.
Как это сделать:
В режиме редактирования сценария перейдите в верхнюю панель.
Нажмите кнопку «Тестировать».
Выберите режим:
Тестировать — запускает сценарий с задержками, как увидит пользователь.
Тестировать без задержек — ускоренный запуск без пауз и таймеров.
Что проверить:
Создаётся ли новая строка в нужной таблице и на нужном листе?
Подставились ли данные корректно (все переменные отработали)?
Не пустые ли ячейки?
Отработал ли шаг при разных типах входных данных (например, при пустой переменной)?
💡 Советы:
Добавьте временный шаг с сообщением перед «Вставкой строки», чтобы проверить, какие значения содержат переменные.
Проверьте структуру таблицы: все ли заголовки указаны, нет ли лишних колонок.
Если данные не записались, проверьте права доступа и наличие интеграции.
🚫 Возможные ошибки и что делать
Даже при правильной настройке блок может не сработать. Ниже — список частых ситуаций и объяснение, как их устранить.
❌ Блок не записывает данные, но ошибок не видно
Что это может значить:
У таблицы нет заголовков в первой строке.
Переменные не сопоставлены — блок не знает, что именно записывать.
Переменные пустые — ничего не передаётся.
Таблица недоступна (отключена интеграция или нет прав доступа).
Что делать:
Убедитесь, что в первой строке есть заголовки.
Проверьте настройки сопоставления столбцов и переменных.
Проверьте значения переменных в предыдущих шагах.
Переподключите интеграцию и проверьте доступ к таблице.
❌ Строка не добавляется
Что это может значить:
Подключённый Google-аккаунт не имеет прав «Редактор».
Таблица удалена, перемещена или закрыта.
Указан неправильный лист или он был переименован.
Что делать:
Откройте таблицу в Google и проверьте:
- доступ для подключённого аккаунта,
- наличие листа,
- структуру заголовков.Заново вставьте ссылку в блок и выберите актуальный лист.
❌ Данные записались в неправильные столбцы
Что это может значить:
Заголовки столбцов изменились в таблице после настройки.
Порядок столбцов был нарушен.
Неправильно сопоставлены переменные.
Что делать:
Откройте блок и заново сопоставьте переменные.
Убедитесь, что заголовки таблицы остались прежними.
Проверьте, не поменяли ли вы названия столбцов в Google Таблице.
❌ Появились лишние столбцы (AA, AB…)
Что это может значить:
Вы случайно заполнили ячейки за пределами колонки Z.
При импорте таблицы из Excel или другой системы добавились лишние колонки.
Что делать:
Удалите пустые или неиспользуемые столбцы правее Z.
Очистите «мусорные» ячейки, даже если они кажутся пустыми.
❌ Переменные не подставились
Что это может значить:
Переменная не была получена до момента вставки строки.
Используется переменная, которая недоступна (удалили).
Что делать:
Убедитесь, что переменные задаются в предыдущих шагах.
Проверьте переменные в тестовом сценарии (через сообщение или шаг «Проверка поля»).
Используйте только разрешённые переменные из выпадающего списка.