Komunikacja
Podłączenie Gmaila do autonomicznego agenta AI
Gmail koncentruje korespondencję z klientami i wewnątrz firmy. Agent Atako może klasyfikować, przygotowywać szkice i czyścić skrzynkę, nigdy nie widząc Twojego hasła do Google.
Wkrótce dostępne — załóż konto, a powiadomimy Cię, gdy tylko ta integracja będzie gotowa.
Możliwe scenariusze
Klasyfikacja i szkice odpowiedzi dla współdzielonej skrzynki wsparcia
Skrzynka support@ odbiera dziesiątki wiadomości dziennie. Agent listuje nieprzeczytane wiadomości za pomocą list_messages, klasyfikuje je etykietami za pomocą add_label_to_message (fakturowanie, błąd, pytanie ogólne), a następnie redaguje odpowiedź jako szkic za pomocą create_draft dla każdej jasnej prośby. Człowiek sprawdza i wysyła za pomocą send_draft. Agent korzysta z send_email tylko wtedy, gdy ten precyzyjny grant został mu przyznany.
Okresowe czyszczenie skrzynki
Newslettery, automatyczne powiadomienia, potwierdzenia odbioru: agent wyszukuje te wiadomości za pomocą search_messages (np. from:noreply), sprawdza ich etykietę za pomocą list_labels, a następnie przenosi je do kosza za pomocą trash_message zamiast pozwalać im gromadzić się w skrzynce głównej. Skrzynka pozostaje czytelna bez konieczności poświęcania przez człowieka dziesięciu minut każdego ranka na to powtarzalne, ręczne sortowanie.
Śledzenie wątków klientów wymagających ponaglenia
Agent wyszukuje wątki bez odpowiedzi od ponad trzech dni za pomocą search_messages, pobiera pełny kontekst za pomocą get_thread, oznacza je etykietą za pomocą add_label_to_message, a następnie przygotowuje szkic ponaglenia za pomocą create_draft. Nic nie wychodzi bez zatwierdzenia przez człowieka: agent ogranicza się do przygotowania gruntu, aby ponaglenie wyszło tego samego dnia, bez czekania, aż pomyśli o tym handlowiec.
Akcje konektora
list_messages
Odczyt. Wylistowanie identyfikatorów wiadomości, filtrowalnych według etykiety.
search_messages
Odczyt. Wyszukanie wiadomości zapytaniem Gmaila.
get_message
Odczyt. Pobranie pełnej wiadomości, wraz z nagłówkami i treścią.
get_thread
Odczyt. Pobranie całego wątku konwersacji.
list_drafts
Odczyt. Wylistowanie istniejących szkiców.
create_draft
Zapis. Utworzenie szkicu odpowiedzi bez wysyłania.
send_draft
Zapis. Wysłanie istniejącego szkicu.
send_email
Zapis. Bezpośrednie wysłanie emaila z podłączonego konta.
add_label_to_message
Zapis. Dodanie etykiety do wiadomości.
trash_message
Zapis. Przeniesienie wiadomości do kosza.
Wymagania wstępne
- Rola admina w firmie Atako, aby podłączyć integrację.
- Konto Gmail lub Google Workspace, którego skrzynka ma zostać podłączona.
- Zgoda OAuth Google, scope https://www.googleapis.com/auth/gmail.modify.
- Jawny grant dla każdego agenta, w szczególności dla działania send_email.
Jak połączyć
- 1
Otworzyć Ustawienia → Integracje
Admin wybiera Gmail z listy dostępnych konektorów.
- 2
Sprawdzić udostępniane działania
Okno pokazuje wszystkie działania odczytu i zapisu, wraz z send_email, przed autoryzacją.
- 3
Uwierzytelnić się przez ekran Google
Przekierowanie do zgody Google, żadne hasło nie trafia do Atako.
- 4
Przyznać dostęp agentowi
Wybiera się precyzyjne działania dla każdego agenta, na przykład samo create_draft, aby zachować ostrożność.
Dlaczego podłączyć autonomicznego agenta do Gmaila
Gmail koncentruje korespondencję z klientami, dostawcami i zespołem. Autonomiczny agent podłączony do niego nie ogranicza się do odpowiadania na jednorazowe polecenie: działa nieprzerwanie i decyduje, zależnie od otrzymanej instrukcji, o wyszukaniu wiadomości, jej klasyfikacji czy przygotowaniu odpowiedzi, dzięki tool calling.
Połączenie wykorzystuje OAuth 2.0, scope https://www.googleapis.com/auth/gmail.modify (scopes Gmaila od Google). Ten scope pozwala czytać, redagować i wysyłać, ale nie usuwać wiadomości natychmiast i trwale.
To właśnie sprawia, że użyteczny jest przepływ taki jak klasyfikacja skrzynki wsparcia, bliski temu, co robi agent klasyfikacji zgłoszeń wsparcia czy automatyzacji wsparcia: odbiera każdą nową wiadomość i przygotowuje odpowiedź, bez czekania, aż człowiek otworzy rozmowę na czacie. Gmail należy do integracji objętych planem Standard, bez osobnej pozycji rozliczeniowej za konektor.
Ograniczenia i dobre praktyki
Najbardziej wrażliwym działaniem konektora jest send_email: raz przyznane w zakresie zapisu, agent wysyła bez ponownego kontaktu z Tobą. Najbezpieczniejszą praktyką jest przyznanie wyłącznie create_draft, agent przygotowuje, człowiek sprawdza i wywołuje wysyłkę za pomocą send_draft.
Scope gmail.modify obejmuje całą podłączoną skrzynkę, nie jedną wybraną etykietę. Rzeczywiste ograniczenie wynika więc z grantu: wylistuj dokładne działania, których agent potrzebuje, zamiast przyznawać wszystko naraz przy podłączeniu.
Dokumentacja nie wspomina o limicie przepustowości właściwym dla konektora Gmaila. Każde wywołanie, wysłane lub odrzucone, pozostaje dostępne w dzienniku audytu na stronie agenta. I jak w przypadku każdego konta OAuth, jeśli token wygaśnie lub zostanie odwołany po stronie Google, połączenie przechodzi w status błędu do ponownego podłączenia.
Powiązane przypadki użycia
Powiązane integracje
Najczęstsze pytania
Czy agent może wysłać email w moim imieniu bez zatwierdzenia?
Tak, jeśli grant obejmuje send_email w zakresie zapisu, agent wysyła wtedy bezpośrednio. Większość firm woli przyznawać tylko create_draft: agent przygotowuje odpowiedź, człowiek ją sprawdza i wysyła za pomocą send_draft.
Czy trzeba mieć płatny plan, aby podłączyć Gmail?
Tak, potrzebny jest aktywny plan Atako, ale Gmail należy do wszystkich integracji już objętych planem Standard, bez dodatkowej opłaty za konektor.
Jak odwołać dostęp Atako do mojej skrzynki Gmail?
Z poziomu Ustawienia → Integracje kliknij Revoke przy połączeniu Gmail. Zaszyfrowany token zostaje natychmiast usunięty, a wszystkie agenty, które z niego korzystały, od razu tracą dostęp.
Czy scope gmail.modify pozwala trwale usuwać emaile?
Nie, ten scope pozwala czytać, redagować, wysyłać i przenosić do kosza, ale nie usuwać wiadomości natychmiast i trwale, to wymagałoby szerszego scope niż ten używany przez konektor.
Co przeczytać dalej
Źródła
- Gmail API, scopes OAuth · dostęp dnia 4 września 2026
- Gmail API, guide d'envoi d'emails · dostęp dnia 4 września 2026
CTO w Atako
Ta treść została napisana przez agentów AI firmy Atako, a następnie sprawdzona, poprawiona i zatwierdzona przez Romaina Laodicinę, CTO Atako.