Google Workspace

Połącz Gmail, Google Docs, Sheets, Drive, Calendar i Meet

​

Przegląd

Sześć usług Google jest dostępnych przez wspólny przepływ OAuth. Połącz się raz ze swoim kontem Google — a Twoi agenci AI uzyskają dostęp do poczty, dokumentów, arkuszy kalkulacyjnych, plików, kalendarza i wideokonferencji.

​

Obsługiwane usługi

Usługa	Narzędzia	Opis
Gmail	6	Wysyłanie e-maili, czytanie skrzynki, wyszukiwanie, odpowiadanie, tworzenie szkiców, pobieranie załączników
Google Docs	5	Tworzenie, czytanie, dopisywanie, wyszukiwanie i eksportowanie dokumentów
Google Sheets	7	Czytanie/pisanie zakresów, dopisywanie wierszy, wyszukiwanie, tworzenie arkuszy
Google Drive	8	Lista, wyszukiwanie, przesyłanie, pobieranie, udostępnianie plików i folderów
Google Calendar	6	Tworzenie wydarzeń, sprawdzanie dostępności, znajdowanie wolnych terminów
Google Meet	1	Tworzenie linków do wideokonferencji

​

Uwierzytelnianie

Wszystkie integracje Google Workspace używają OAuth 2.0 z dostępem offline:

1. Dodaj integrację

   Przejdź do Integracje → Dodaj integrację → wybierz dowolną usługę Google (np. Gmail).

2. Ekran zgody OAuth

   Kliknij „Połącz z Google”. Zostaniesz przekierowany na ekran zgody Google, gdzie autoryzujesz dostęp do konkretnej usługi.

3. Przechowywanie tokenów

   Revol otrzymuje token dostępu i refresh token. Oba są szyfrowane i przechowywane w bazie danych. Refresh token zapewnia długoterminowy dostęp — Revol automatycznie odświeża wygasłe tokeny dostępu.

4. Udostępnienie narzędzi

   Po pomyślnym uwierzytelnieniu OAuth narzędzia agenta są tworzone automatycznie na podstawie typu integracji.

​

Zakresy OAuth

Każda usługa żąda tylko potrzebnych zakresów:

Usługa	Zakres
Gmail	gmail.modify
Google Docs	documents, drive.file
Google Sheets	spreadsheets, drive.file
Google Drive	drive
Google Calendar	calendar
Google Meet	calendar (linki Meet są tworzone przez Calendar API)

​

Narzędzia agenta

Gmail

Narzędzie	Opis
send_email	Utwórz i wyślij e-mail z tematem, treścią, opcjonalnym CC/BCC
read_inbox	Wyświetl ostatnie e-maile ze skrzynki odbiorczej
search_emails	Wyszukaj e-maile za pomocą składni zapytań Gmail (od, temat, data, słowa kluczowe)
reply_to_email	Odpowiedz na konkretny wątek e-mailowy
create_draft	Utwórz szkic e-maila bez wysyłania
get_attachments	Pobierz lub sprawdź załączniki e-maila

Google Docs

Narzędzie	Opis
create_document	Utwórz nowy dokument Google
read_document	Przeczytaj zawartość dokumentu po ID
append_to_document	Dopisz tekst na końcu dokumentu
search_documents	Wyszukaj dokumenty po tytule lub treści na Drive
export_document	Eksportuj dokument do PDF, DOCX lub zwykłego tekstu

Google Sheets

Narzędzie	Opis
read_range	Odczytaj dane z zakresu komórek (np. A1:D10)
write_range	Zapisz dane w zakresie komórek
append_rows	Dopisz wiersze na końcu arkusza
search_rows	Wyszukaj wiersze pasujące do wartości kolumny
create_spreadsheet	Utwórz nowy arkusz kalkulacyjny
get_info	Pobierz metadane arkusza (arkusze, liczba wierszy)
update_cells	Zaktualizuj konkretne komórki

Google Drive

Narzędzie	Opis
list_files	Wyświetl pliki w folderze
search_files	Wyszukaj pliki po nazwie, typie lub treści
read_file	Pobierz lub odczytaj zawartość pliku
create_file	Prześlij nowy plik
update_file	Zaktualizuj zawartość lub metadane istniejącego pliku
delete_file	Przenieś plik do kosza
create_folder	Utwórz nowy folder
share_file	Udostępnij plik konkretnym użytkownikom lub ustaw jako publiczny

Calendar i Meet

Google Calendar:

Narzędzie	Opis
create_event	Utwórz wydarzenie z uczestnikami i przypomnieniami
list_events	Wyświetl nadchodzące wydarzenia w zakresie dat
update_event	Zaktualizuj szczegóły istniejącego wydarzenia
delete_event	Anuluj/usuń wydarzenie z kalendarza
check_availability	Sprawdź, czy termin jest wolny czy zajęty
find_free_slots	Znajdź dostępne terminy w zakresie dat

Google Meet:

Narzędzie	Opis
create_meeting	Utwórz link Google Meet (przez wydarzenie Calendar z conferenceData)

​

Używanie narzędzi w węzłach workflow

Narzędzia Google Workspace są szczególnie skuteczne w węzłach workflow, gdzie agent może łączyć wiele narzędzi w jednej rozmowie:

1. Połącz usługę Google i zweryfikuj przez OAuth
2. Narzędzia pojawią się w zakładce Narzędzia agenta
3. Dodaj je do węzłów niestandardowych w edytorze workflow
4. LLM wywołuje je automatycznie, gdy jest to potrzebne

Przykładowy workflow: Klient prosi o zaplanowanie demo →

• Agent wywołuje check_availability, aby znaleźć wolne terminy
• Klient wybiera godzinę → agent wywołuje create_event, aby zarezerwować termin
• Agent wywołuje create_meeting, aby wygenerować link Google Meet
• Agent wywołuje send_email, aby wysłać e-mail z potwierdzeniem i linkiem

​

Przypadki użycia

Automatyczne e-maile follow-up

Agent kwalifikuje leada przez czat → używa send_email do wysłania follow-upu z cennikiem → loguje interakcję w Google Sheets przez append_rows.

Rezerwacja spotkań

Klient prosi o umówienie spotkania → agent używa check_availability, aby znaleźć wolne terminy → create_event, aby je zarezerwować → create_meeting, aby wygenerować link Meet → wysyła potwierdzenie przez czat lub e-mail.

Generowanie dokumentów

Agent zbiera informacje od klienta → używa create_document, aby wygenerować ofertę lub raport → share_file, aby dać klientowi dostęp.

Śledzenie leadów w stylu CRM

Każda rozmowa zakończona leadem → agent używa append_rows, aby dodać dane leada do Google Sheet → send_email, aby powiadomić zespół sprzedaży.

​

Odświeżanie tokenów

Tokeny dostępu Google wygasają po 1 godzinie. Revol obsługuje to automatycznie:

1. Przed każdym wywołaniem API Revol sprawdza, czy token wygasa w ciągu 5 minut
2. Jeśli wygasł, używa zapisanego refresh tokena do uzyskania nowego tokena dostępu
3. Nowy token jest szyfrowany i zapisywany z powrotem w bazie danych
4. Wywołanie API jest wykonywane z nowym tokenem

Jeśli refresh token stanie się nieważny (użytkownik cofnął dostęp), integracja jest oznaczana jako rozłączona i wymaga ponownej autoryzacji.