Google Таблицы

#Что можно делать

• Записывать из бота — действие «Записать в Google Таблицу» в шаге бота: в каждый столбец идёт своё значение, можно с переменными — например имя, телефон, дата. Можно не добавлять новую строку, а обновлять старую: «Обновлять строку, если совпадает значение в столбце».
• Читать в боте — действие «Прочитать из Google Таблицы». Режим «Ячейка» берёт одну ячейку, например B2. Режимы «Случайно» и «По порядку» берут значение из столбца: впишите его букву, например A, или A2 — тогда Sender начнёт со второй строки. «По порядку» выдаёт значения по одному — удобно для промокодов. Результат попадёт в переменную из поля «Сохранить в переменную».
• Отвечать AI-агентом по таблице — источник «Google Таблица» в базе знаний. Sender читает таблицу ключом того канала проекта, который вы выберете для источника.

Выгружать всю базу подписчиков в Google Таблицу Sender не умеет — для этого есть экспорт в файл: Импорт и экспорт подписчиков.

#Что понадобится

• Аккаунт Google.
• Роль «Администратор» или «Владелец» в Sender — настройки канала меняют только они.

#Шаг 1. Создайте сервисный аккаунт в Google

1. Откройте console.cloud.google.com, создайте проект или выберите существующий.
2. В разделе «API и сервисы» найдите в библиотеке Google Sheets API и включите его.
3. В разделе «IAM и администрирование» → «Сервисные аккаунты» создайте сервисный аккаунт.
4. Откройте его, вкладка «Ключи» → «Добавить ключ» → «Создать новый ключ» → тип JSON. Файл ключа скачается.

Названия пунктов в Google иногда меняются — ищите похожие. Файл ключа никому не пересылайте.

#Шаг 2. Подключите ключ в Sender

1. Откройте Управление → Каналы и в строке разделов над карточкой канала нажмите «Google Таблицы».
2. Откройте скачанный файл в любом текстовом редакторе и скопируйте весь текст.
3. Вставьте его в поле «Ключ сервисного аккаунта (JSON)» и нажмите «Сохранить».

Появится «Google Таблицы подключены» и строка «Подключено:» с адресом вида …@….iam.gserviceaccount.com. Ключ хранится в зашифрованном виде и работает только для этого канала — у каждого канала свой ключ.

#Шаг 3. Откройте таблицу для Sender

1. В разделе «Google Таблицы» нажмите «Скопировать адрес».
2. В Google Таблице откройте настройки доступа и добавьте этот адрес, как добавили бы коллегу.
3. Выберите права «Редактор» — чтобы бот мог записывать. Для базы знаний агента достаточно права на чтение.
4. В действии бота вставьте ссылку на таблицу и нажмите «Проверить доступ» — должно появиться «Доступ есть» и название таблицы. Проверка работает у ролей «Администратор» и «Владелец».

Лист выбирается в списке рядом. Если не выбрать, Sender возьмёт лист из ссылки, а если в ссылке его нет — первый.

#Как пишет и читает бот

• Значения идут в столбцы A, B, C… по порядку. Если лист пустой, а у столбцов в действии есть заголовки, первой строкой Sender запишет их.
• Значения записываются как есть: формулы не выполняются, текст «=СУММ(…)» останется текстом.
• «По порядку» выдаёт непустые значения столбца по одному, счёт общий для всех ботов канала. Когда значения закончились, бот получит ошибку «В столбце закончились значения», и счёт не сдвинется.
• Ошибка таблицы не останавливает бота: он продолжит, а текст ошибки будет в переменной {%_gsheets_error%}.

#Частые ошибки

#Частые вопросы