Google Sheets API связывает таблицу с CRM: агенты пишут код, инженер задаёт направление и проверку

Google Sheets API даёт программе читать и менять таблицу, но направление обмена с CRM и проверку результата нужно задать отдельно.

Разберём заказ и приёмку коннектора по документации Google и опыту нашей машины агентов. Своего клиентского кейса этой интеграции у нас пока нет.

Не хотите разбираться сами? Внедряем ИИ в ваш бизнес: задачи без лимита, одна цена в месяц, отмена в любой момент.

API связывает таблицу с программой. Эта программа читает выбранные ячейки и обращается к API вашей CRM. Сам Sheets API не знает, что строка стала заявкой, а статус сделки уже изменил менеджер.

Учебный сценарий статьи: отдел продаж заносит заявки в Google Таблицу, CRM ведёт сделки, таблица показывает результат. Менеджер исправил состав заказа в таблице, коллега закрыл сделку в CRM. Обмен должен сохранить оба изменения.

Агенты пишут код коннектора и проверки по заданию инженера. Для обычного переноса согласованных полей модель не нужна при каждом запуске. Решение, какой статус верный, нельзя оставлять ответу модели.

Двусторонний обмен не требует двусторонней записи каждого поля. Состав заявки можно брать из таблицы, этап сделки из CRM, номер сделки возвращать в таблицу. Так менеджеры видят общую картину, не споря за право менять один статус.

Главный источник назначают до разработки. Если одному полю разрешены изменения в обоих местах, нужно отдельное правило конфликта. «Побеждает последнее» опасно, если последним пришёл старый повтор после сбоя.

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

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

Сохранить привычную CRM часто достаточно. Выбор между коробкой и своей CRM нужен, когда ограничений самой CRM уже нельзя обойти коннектором. Замена всей системы не входит в задачу переноса полей.

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

Метод append в Sheets добавляет значения после существующей таблицы. Это не поиск заявки по ключу. У коннектора должен быть след операции, по которому он восстановит незавершённый перенос и проверит уже созданную запись в CRM.

Общая запись в Google Таблицы не блокирует коллегу. Google предупреждает в описании batchUpdate, что изменения соавторов могут повлиять на результат. Пакет применяется вместе внутри таблицы, но не объединяет её и CRM в одну операцию.

Конфликт ловят до перезаписи чужого значения. Если CRM поддерживает проверку версии при записи, инженер использует её. Простое «прочитали, сравнили, записали» оставляет промежуток для чужой правки.

Когда такого механизма нет, общий статус лучше закрепить за CRM. Спорную запись коннектор помечает для разбора руководителем. Эта конкретика входит в задачу для агента вместе с примером правильного результата.

Лимиты считают запросами, не строками таблицы. На 8 октября 2026 Google указывает для чтения и отдельно для записи по 300 запросов в минуту на проект, внутри него 60 на пользователя. Сервисный аккаунт считается одним аккаунтом.

При превышении квоты API возвращает ошибку 429. Google рекомендует повтор с растущей паузой. Частый повтор без паузы продлевает сбой, поэтому коннектор сохраняет очередь незавершённых операций.

Задержку согласуют исходя из работы отдела. Для заявок на завтра и заказов, которые нужно принять сейчас, требования разные. «Мгновенно» не является измеримым условием заказа.

Права на файл не равны правам на отдельную вкладку. В Google Sheets области доступа API нельзя сузить до одной вкладки документа. Для чтения выбирают разрешение на чтение, для работы с выбранными файлами рассматривают drive.file.

Скрытая вкладка не разделяет доступ. Если обмену нужны заявки, а в соседней вкладке зарплаты, файлы стоит разделить. Затем проверяют доступ коннектора разрешённым и запрещённым действием.

Агентам для разработки нужны схема и вымышленные записи. Боевые контакты и ключи к ним не нужны для написания правил переноса. Разделение данных клиентов и разработки проверяют отдельно от прав работающего коннектора.

Нашего клиентского кейса связи Google Таблиц с CRM пока нет. Есть практика машины агентов на vibecoding.ru, где инженер задаёт правила, а поломки превращаются в проверки. На публичном счётчике 8 октября видно 7 107 коммитов за 99 дней с 1 июля 2026.

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

Сначала обмен должен доказать полноту данных. Сообщение «запуск завершён» не показывает, что нужное поле оказалось в CRM. Сверять нужно конечную запись и задержку переноса.

Поддержка коннектора начинается с видимой очереди. Руководителю нужно знать, что перенесено, что ждёт и что требует решения. Если проверка видит только работающий процесс, потерянные заявки останутся незамеченными.

Для регулярной сверки нужен способ обнаружить пропуск. Например, коннектор сравнивает ключи подходящих заявок с записями CRM. Контрольная тестовая заявка полезна только в разрешённом тестовом режиме, без рассылки и действий с настоящим клиентом.

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

Если готовый коннектор уже переносит нужные поля, возвращает результат и переживает ваши сбои, его достаточно проверить. Собственный код нужен, когда готовой связке не хватает правил по полям, конфликтов или доступа.

У агентной разработки по подписке есть тариф «Один проект», 250 000 ₽ в месяц на 8 октября 2026. Инженер ведёт машину агентов, пишет согласованный обмен и проверки. В потоке одна задача в работе, следующая ждёт, подписку можно поставить на паузу в любой месяц.

Цена месяца не является ценой одной интеграции. Отдельно считают лицензию CRM, сторонние коннекторы, работу сервиса обмена и комиссии, если они нужны. Для редкого переноса готового файла постоянная разработка не требуется.

Первая задача должна назвать файл, CRM и разрешённые изменения. Проверку проводят на вымышленных заявках, включая потерянный ответ, повтор и одновременную правку. Только после приёмки обсуждают запуск на рабочих данных.

Пауза разработки не останавливает готовый коннектор сама по себе. Работу сервиса и доступы поддерживает их владелец. Ответственного за сигнал ошибки назначают до паузы, а ночные дежурства не считают включёнными в подписку на разработку.

С описанием таблицы и CRM можно перейти к обсуждению обмена. На звонке согласуют поля, направление записи и результат приёмки.

1. API даёт доступ к ячейкам. Закажите правила переноса полей и проверку результата в CRM.

2. Назначьте главный источник каждого поля. Общие изменения должны иметь правило конфликта.

3. Принимайте обмен на повторе, потере ответа и сортировке. Одна заявка должна остаться одной сделкой.

4. Проверяйте очередь и свежесть результата. Работающий процесс ещё не доказывает перенос.

5. Согласуйте код, инструкции и ответственного за сбой. Цена месяца разработки не включает все расходы работающего обмена.