Документация › Интеграции › Google Sheets
Google Sheets
Самая популярная интеграция: бот пишет лидов в таблицу, читает прайс/расписание, бронирует слоты. Подключается за минуту — нужно лишь поделиться таблицей с сервис-аккаунтом.
⏱ 8 мин · 👤 для владельца · 🟢 live
За 30 секунд:
- Подключение = поделиться Google-таблицей с email сервис-аккаунта как «Редактор» (см. Обзор интеграций).
- В функцию вставляешь ID таблицы — это часть ссылки между
/d/и/edit.- Бот умеет: читать, искать, добавлять/обновлять/удалять строки, форматировать, создавать листы.
- Не поделился → ошибка с подсказкой добавить email сервис-аккаунта.
Что бот умеет с таблицей
Готовые шаблоны Google Таблиц разбиты на две группы — Чтение и Запись:
| Функция | Группа | Что делает |
|---|---|---|
get_sheet_info | Чтение | структура: листы, заголовки, размеры |
read_sheet | Чтение | прочитать строки |
find_in_sheet | Чтение | найти строку по значению |
add_row | Запись | добавить строку (например, нового лида) |
update_row | Запись | обновить строку или ячейку (с защитой от перезаписи занятого слота) |
delete_row | Запись | удалить строку |
Типичные сценарии: записывать лидов (имя/телефон/услуга → строка), читать прайс или расписание из таблицы, бронировать слоты в сетке расписания (через update_row с защитой ячейки).
💡 Раскраска диапазонов и создание листов из каталога шаблонов убраны (2026-06-13) — это администрирование таблиц, а не работа бота-продавца. Сами операции на сервере остаются доступны для импортируемых функций.
Как подключить
- Поделись таблицей. Открой свою Google-таблицу → «Поделиться» → добавь email сервис-аккаунта (он показан в разделе «Интеграции») с правами «Редактор».
- Возьми ID таблицы из ссылки. В URL
https://docs.google.com/spreadsheets/d/`1AbC…XyZ`/edit— ID это часть между/d/и/edit. - Создай/настрой функцию (см. Функции) и укажи в ней этот
spreadsheet_id. - Проверь в тест-чате: попроси бота сделать то, для чего функция (например, «запиши меня»).
💡 Один бот — несколько таблиц. ID таблицы — параметр функции, так что у разных функций могут быть разные таблицы (одна под лиды, другая под расписание).
Частая ошибка: «нет доступа»
Если указал ID, но не поделился таблицей с сервис-аккаунтом, бот вернёт ошибку вида:
«Сервис-аккаунт не имеет доступа в таблицу. Откройте её → Поделиться → добавьте `<email сервис-аккаунта>` с правами Редактор»
Лечится ровно так, как написано: добавь email в «Поделиться» как Редактора (не «Читатель» — боту нужно и писать).
Другие типовые причины разобраны в Функция не вызывается / падает.
💬 Простыми словами
Google-таблица — это самый простой «склад данных» для бота. Он может складывать туда заявки (каждый лид — новая строчка), а может, наоборот, подсматривать в неё цены или расписание, чтобы отвечать клиентам.
Подключение — на минуту. Открываешь свою таблицу, жмёшь «Поделиться» и добавляешь туда email бота (платформа его показывает) как Редактора — будто делишься с коллегой. Потом копируешь из ссылки на таблицу её «номер» (кусок между /d/ и /edit) и вставляешь в функцию. Готово.
И главное правило, на котором спотыкаются все: если бот говорит «нет доступа к таблице» — значит, ты забыл с ним поделиться или дал права только на чтение. Добавь его как Редактора — и заработает.
Дальше: → Google Calendar
Связано: Обзор интеграций · Функции · Тест-чат
Не получилось? → Функция не вызывается / падает