Консоль
Интеграции

Google Sheets

Запись результатов разговоров в Google Sheets через сервисный аккаунт

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

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

  • URL Google-таблицы
  • полный Service Account JSON из Google Cloud
  • доступ сервисного аккаунта к таблице с ролью Editor

Как подготовить доступ

  1. В Google Cloud создайте проект и включите Google Sheets API.
  2. Создайте сервисный аккаунт и скачайте JSON-ключ.
  3. Откройте таблицу и выдайте email сервисного аккаунта роль Editor.

Как добавить интеграцию

  1. Откройте Integrations -> Google Sheets -> Добавить интеграцию.
  2. Укажите Название и URL таблицы.
  3. Вставьте полный Service Account JSON.
  4. Сохраните запись.

Если соединение удалось проверить сразу, интеграция получит статус Проверено.

Что сделать после сохранения

  • На странице интеграции нажмите Сохранить подключение, если меняли URL или JSON-ключ.
  • При необходимости нажмите Обновить метаданные, чтобы перечитать список вкладок и колонок.
  • Выберите вкладку для записи и включите только те заголовки, которые Айва должна заполнять.
  • Для каждой включенной колонки можно оставить инструкцию для LLM: что извлекать из разговора и в каком формате писать значение.
  • Сохраните маппинг полей.

Как назначить агенту

  1. Откройте агента.
  2. В секции интеграций выберите нужную подготовленную интеграцию Google Sheets.
  3. Если редактор показывает требует настройки, сначала завершите настройку вкладки и маппинга в карточке интеграции.
  4. Сохраните агента.

Безопасный пример

{
  "type": "service_account",
  "project_id": "aiva-docs-demo",
  "private_key_id": "demo-private-key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\nREDACTED\n-----END PRIVATE KEY-----\n",
  "client_email": "aiva-docs-demo@aiva-docs-demo.iam.gserviceaccount.com"
}
Spreadsheet URL: https://docs.google.com/spreadsheets/d/demo-spreadsheet-id/edit

Если таблица не проверяется

  • проверьте, что сервисный аккаунт добавлен именно к этой таблице
  • убедитесь, что вставлен полный JSON, а не только email
  • обновите метаданные после смены заголовков первой строки