> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

<Steps>
  <Step title="Dodaj integrację">
    Przejdź do **Integracje** → **Dodaj integrację** → wybierz dowolną usługę Google (np. Gmail).
  </Step>

  <Step title="Ekran zgody OAuth">
    Kliknij „Połącz z Google". Zostaniesz przekierowany na ekran zgody Google, gdzie autoryzujesz dostęp do konkretnej usługi.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Udostępnienie narzędzi">
    Po pomyślnym uwierzytelnieniu OAuth narzędzia agenta są tworzone automatycznie na podstawie typu integracji.
  </Step>
</Steps>

### 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

<Tabs>
  <Tab title="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                                             |
  </Tab>

  <Tab title="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 |
  </Tab>

  <Tab title="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                      |
  </Tab>

  <Tab title="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 |
  </Tab>

  <Tab title="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) |
  </Tab>
</Tabs>

## 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

<AccordionGroup>
  <Accordion title="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`.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Generowanie dokumentów">
    Agent zbiera informacje od klienta → używa `create_document`, aby wygenerować ofertę lub raport → `share_file`, aby dać klientowi dostęp.
  </Accordion>

  <Accordion title="Ś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.
  </Accordion>
</AccordionGroup>

## 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.