Google Workspace

Підключіть Gmail, Google Docs, Sheets, Drive, Calendar та Meet

​

Огляд

Шість сервісів Google доступні через спільний OAuth-потік. Підключіться один раз зі своїм Google-акаунтом — і ваші AI-агенти отримають доступ до пошти, документів, таблиць, файлів, календаря та відеозустрічей.

​

Підтримувані сервіси

Сервіс	Інструменти	Опис
Gmail	6	Надсилання листів, читання, пошук, відповіді, чернетки, вкладення
Google Docs	5	Створення, читання, доповнення, пошук та експорт документів
Google Sheets	7	Читання/запис діапазонів, додавання рядків, пошук, створення таблиць
Google Drive	8	Список, пошук, завантаження, поширення файлів та папок
Google Calendar	6	Створення подій, перевірка доступності, пошук вільних слотів
Google Meet	1	Створення посилань на відеозустрічі

​

Автентифікація

Усі інтеграції Google Workspace використовують OAuth 2.0 з офлайн-доступом:

1. Додайте інтеграцію

   Перейдіть в Інтеграції → Додати інтеграцію → оберіть будь-який сервіс Google (напр., Gmail).

2. OAuth-згода

   Натисніть “Connect with Google”. Ви будете перенаправлені на екран згоди Google, де авторизуєте доступ до конкретного сервісу.

3. Збереження токенів

   Revol отримує access token та refresh token. Обидва зашифровані та зберігаються в базі даних. Refresh token забезпечує довготривалий доступ — Revol автоматично оновлює прострочені access token.

4. Створення інструментів

   Після успішного OAuth інструменти агента створюються автоматично відповідно до типу інтеграції.

​

OAuth Scopes

Кожен сервіс запитує лише потрібні дозволи:

Сервіс	Scope
Gmail	gmail.modify
Google Docs	documents, drive.file
Google Sheets	spreadsheets, drive.file
Google Drive	drive
Google Calendar	calendar
Google Meet	calendar (Meet-посилання створюються через Calendar API)

​

Інструменти агента

Gmail

Інструмент	Опис
send_email	Створити та надіслати лист з темою, тілом, опціональними CC/BCC
read_inbox	Отримати останні листи зі скриньки
search_emails	Пошук листів за синтаксисом Gmail (від, тема, дата, ключові слова)
reply_to_email	Відповісти на конкретний тред листів
create_draft	Створити чернетку без надсилання
get_attachments	Завантажити або переглянути вкладення листа

Google Docs

Інструмент	Опис
create_document	Створити новий Google Doc
read_document	Прочитати вміст документа за ID
append_to_document	Додати текст у кінець документа
search_documents	Знайти документи за назвою або вмістом у Drive
export_document	Експортувати документ у PDF, DOCX або текст

Google Sheets

Інструмент	Опис
read_range	Прочитати дані з діапазону комірок (напр., A1:D10)
write_range	Записати дані у діапазон комірок
append_rows	Додати рядки в кінець таблиці
search_rows	Знайти рядки за значенням стовпця
create_spreadsheet	Створити нову таблицю
get_info	Отримати метадані таблиці (аркуші, кількість рядків)
update_cells	Оновити конкретні комірки

Google Drive

Інструмент	Опис
list_files	Список файлів у папці
search_files	Пошук файлів за ім’ям, типом або вмістом
read_file	Завантажити або прочитати вміст файлу
create_file	Завантажити новий файл
update_file	Оновити вміст або метадані файлу
delete_file	Перемістити файл у кошик
create_folder	Створити нову папку
share_file	Поділитися файлом з конкретними користувачами

Calendar і Meet

Google Calendar:

Інструмент	Опис
create_event	Створити подію з учасниками та нагадуваннями
list_events	Список подій у діапазоні дат
update_event	Оновити деталі існуючої події
delete_event	Скасувати/видалити подію
check_availability	Перевірити, чи часовий слот вільний
find_free_slots	Знайти вільні слоти у діапазоні дат

Google Meet:

Інструмент	Опис
create_meeting	Створити Google Meet посилання (через подію Calendar з conferenceData)

​

Використання інструментів у workflow-нодах

Інструменти Google Workspace особливо потужні у workflow-нодах, де агент може комбінувати кілька інструментів в одній розмові:

1. Підключіть сервіс Google та верифікуйте через OAuth
2. Інструменти з’являться у вкладці Tools агента
3. Додайте їх до custom node у workflow-редакторі
4. LLM викликає їх автоматично, коли це доречно

Приклад workflow: Клієнт просить запланувати демо →

• Агент викликає check_availability для пошуку вільних слотів
• Клієнт обирає час → агент викликає create_event для бронювання
• Агент викликає create_meeting для генерації Google Meet посилання
• Агент викликає send_email для надсилання підтвердження з посиланням

​

Приклади використання

Автоматичні follow-up листи

Агент кваліфікує ліда через чат → використовує send_email для надсилання follow-up з цінами → логує взаємодію в Google Sheets через append_rows.

Запис на зустріч

Клієнт хоче запланувати зустріч → агент використовує check_availability для пошуку вільних слотів → create_event для бронювання → create_meeting для генерації Meet-посилання → надсилає підтвердження через чат або email.

Генерація документів

Агент збирає інформацію від клієнта → використовує create_document для створення пропозиції або звіту → share_file для надання доступу клієнту.

CRM-подібне відстеження лідів

Кожна розмова з лідом → агент використовує append_rows для додавання даних ліда в Google Sheet → send_email для сповіщення відділу продажів.

​

Оновлення токенів

Access token Google діє 1 годину. Revol обробляє це автоматично:

1. Перед кожним API-викликом Revol перевіряє, чи токен спливає протягом 5 хвилин
2. Якщо прострочений — використовує збережений refresh token для отримання нового access token
3. Новий токен зашифровується та зберігається в базі даних
4. API-виклик виконується зі свіжим токеном

Якщо refresh token стає недійсним (користувач відкликав доступ), інтеграція позначається як відключена і потребує повторної авторизації.