Урок 2. Google Sheets как база данных#
Цель: научиться организовывать данные в Google Sheets для подключения к агенту.
Почему Google Sheets подходит для старта#
- знакомый интерфейс (как Excel)
- бесплатно до 10 млн ячеек на документ
- есть API для чтения и записи
- легко интегрируется с Zapier, Make, n8n, Coze
- можно работать совместно с командой
Как устроена таблица для агента#
Агент работает с таблицей как с базой данных, а значит:
- Первая строка — это заголовки столбцов (имена полей)
- Каждая следующая строка — это одна запись (клиент, заказ, задача)
- Столбцы имеют чёткий формат (текст, число, дата, да/нет)
- Нет пустых строк и столбцов в середине таблицы
- Нет объединённых ячеек и лишнего форматирования
Пример: таблица «Клиенты»#
| ID | Имя | Телефон | Статус | Дата регистрации | |
|---|---|---|---|---|---|
| 1 | Иван Петров | ivan@example.com | +79001234567 | Активен | 2026-01-15 |
| 2 | Мария Сидорова | maria@example.com | +79007654321 | Лид | 2026-01-20 |
| 3 | Алексей Ковалёв | alex@example.com | +79009876543 | Неактивен | 2025-12-10 |
Что важно:
- ID — уникальный номер записи (чтобы не перепутать двух Иванов Петровых)
- Формат данных — телефон всегда в одном формате, дата в формате YYYY-MM-DD
- Статус — только три варианта (не «активен», «Активен», «active»)
- Нет пустых строк между записями
Как подключить Google Sheets к агенту#
Шаг 1. Подготовить таблицу
- заполните первую строку заголовками
- убедитесь, что нет пустых строк и столбцов
- проверьте формат данных (даты, числа, текст)
Шаг 2. Открыть доступ
- нажмите «Настройки доступа» → «Доступ для всех, у кого есть ссылка» (или дайте доступ сервисному аккаунту)
- если используете API — создайте сервисный аккаунт в Google Cloud Console (для продвинутых сценариев)
Шаг 3. Подключить через интеграцию
- в Zapier / Make / n8n выберите модуль «Google Sheets»
- авторизуйтесь (дайте доступ к таблице)
- выберите документ и лист
- настройте действие: «Прочитать строки», «Добавить строку», «Обновить строку»
Шаг 4. Протестировать
- запустите тест — убедитесь, что данные читаются и записываются корректно
- проверьте, что новые строки добавляются в конец таблицы, а не в случайное место
Типичные ошибки при работе с Google Sheets#
| Ошибка | Почему это проблема | Как исправить |
|---|---|---|
| Пустые строки внутри таблицы | Агент не понимает, где заканчиваются данные | Удалите все пустые строки между записями |
| Объединённые ячейки | API не может прочитать структуру | Разъедините ячейки, используйте одну ячейку на поле |
| Разные форматы в одном столбце | «+7 900 123-45-67» и «89001234567» — разные строки | Приведите к единому формату |
| Нет заголовков | Агент не знает, что означает каждый столбец | Добавьте первую строку с названиями полей |
| Формулы в ячейках | API читает формулу, а не результат | Копируйте значения, а не формулы |
Практический пример: бот квалификации лидов#
Задача: клиент пишет в Telegram-бот, бот проверяет, есть ли клиент в базе Google Sheets.
Таблица «Клиенты»:
| Имя | Статус | Дата последнего контакта | |
|---|---|---|---|
| ivan@example.com | Иван | Активен | 2026-01-30 |
| maria@example.com | Мария | Лид | 2026-01-25 |
Логика агента:
- Клиент пишет email в бот
- Агент делает запрос в Google Sheets: «Найти строку, где Email = [введённый email]»
- Если строка найдена → агент отвечает: «Здравствуйте, [Имя]! Ваш статус: [Статус]»
- Если строка не найдена → агент отвечает: «Вы новый клиент. Зарегистрируем вас?»
- Если клиент согласен → агент добавляет новую строку в таблицу
Инструменты: Coze (для бота) + Google Sheets (для данных) + интеграция через API или Zapier.