Połączenie Gmail z Mantrego: własny klient OAuth krok po kroku

Połączenie Gmail z Mantrego działa przez logowanie Google z użyciem Twojej własnej aplikacji OAuth. Wynika to z konstrukcji Mantrego: nie ma wspólnego klienta Google dla wszystkich użytkowników, więc identyfikator i sekret klienta tworzysz sam w Google Cloud i wpisujesz w koncie integracji. Ten poradnik opisuje całą drogę, od Google Cloud do pierwszej synchronizacji.

Sprawdzone w wersji 0.6.2, 2026-10-07. Nazwy poleceń w konsoli Google bywają zmieniane, więc mogą wyglądać nieco inaczej niż poniżej.

Zanim zaczniesz

• Konto Google, z którego chcesz czytać pocztę, oraz dostęp do Google Cloud Console.
• W Mantrego rola Właściciel organizacji. Członek zespołu nie dodaje kont integracji, ale może sprawdzać i synchronizować istniejące.
• Limit planu: Free pozwala na 3 konta integracji.

Kroki

Część 1. Google Cloud

1. Wejdź do Google Cloud Console i utwórz nowy projekt albo wybierz istniejący.
2. W bibliotece API (Interfejsy API i usługi, a w niej Biblioteka) włącz Gmail API.
3. Otwórz Google Auth Platform i skonfiguruj aplikację: nazwę, adres e-mail pomocy i typ odbiorców Zewnętrzni (External). Dla kont w Google Workspace możliwy jest też typ wewnętrzny.
4. W ustawieniach odbiorców (Audience) dodaj swoje konto Google do Użytkowników testowych, jeśli aplikacja ma status Testowanie.
5. W sekcji Clients wybierz Create client i jako typ aplikacji wybierz Web application (Aplikacja internetowa).
6. W polu Authorized redirect URIs dodaj adres https://mantrego.com/api/oauth/google/callback. Za chwilę porównasz go z adresem, który pokaże Mantrego.
7. Utwórz klienta i zapisz Client ID oraz Client secret. Sekret traktuj jak hasło. Google pokazuje go w całości tylko przy tworzeniu, potem widoczne są ostatnie cztery znaki.

Część 2. Mantrego

1. Wejdź w Integracje. W sekcji Dodaj połączenie znajdź kartę Gmail i kliknij Dodaj konto.
2. Wpisz Nazwa połączenia (na przykład „Studio Forma / Gmail") i wybierz Klient, jeśli skrzynka ma należeć do konkretnego klienta. Opcja Ogólne oznacza brak klienta.
3. W polu Identyfikator klienta OAuth Google wpisz Client ID, a w polu Sekret klienta OAuth Google wpisz Client secret. Pól tokenów (Token dostępu Gmail, Refresh token) nie wypełniaj. Uzupełnią się same po zalogowaniu.
4. W polu Synchronizacja skrzynki wybierz Na bieżąco (zalecane), Co 15 min albo Ręcznie.
5. Kliknij Zapisz połączenie.
6. Na karcie nowego konta kliknij Zaloguj z Google. Otworzy się okno Autoryzacja Google z polem Adres przekierowania.
7. Porównaj ten adres z adresem dodanym w Google Cloud. Jeśli się różnią, dodaj w Google Cloud także adres z okna Mantrego. Google wymaga dokładnej zgodności.
8. Kliknij Otwórz logowanie Google. Link jest jednorazowy i ważny 10 minut, więc nie udostępniaj go nikomu.
9. Wybierz konto Google i zaakceptuj uprawnienia. Mantrego prosi o odczyt wiadomości oraz tworzenie szkiców i wysyłanie. Ponieważ to Twoja własna aplikacja, Google może pokazać ostrzeżenie, że aplikacja nie została zweryfikowana. W takim przypadku wybierz opcję kontynuowania.
10. Po powrocie do Mantrego zobaczysz komunikat Konto Google zostało połączone. Użyj przycisku Sprawdź, aby potwierdzić połączenie. Kliknij Sprawdź. Karta powinna pokazać Połączono.
11. Otwórz Skrzynka. Jeśli widzisz pustą listę, kliknij Synchronizuj.

Przypisanie poczty do klienta

Konto przypisane do klienta nadaje tego klienta pobieranym wiadomościom. W konkretnej wiadomości możesz też zmienić klienta w sekcji Klient i konto AI, polem Przypisz klienta. Poczta klienta jest widoczna na jego stronie, w zakładce Poczta. Mantrego szuka wiadomości po przypisaniu i po adresie kontaktowym klienta.

Jak działa tryb Na bieżąco

Dla Gmaila Mantrego pyta o zmiany co około 25-30 sekund na konto. Nowe wiadomości pojawiają się w otwartej skrzynce bez klikania Synchronizuj. Nad listą widać stan: Na bieżąco, komunikat o łączeniu albo błąd z przyciskiem Ponów.

Odłączenie

Na karcie konta kliknij Ustawienia, potem Usuń połączenie i Potwierdź usunięcie konta. Konta nie usuniesz, gdy ma oczekujące operacje w centrum Akceptacje. Dodatkowo cofnij dostęp aplikacji w ustawieniach swojego konta Google, w sekcji dotyczącej dostępu aplikacji firm trzecich.

Rozwiązywanie problemów

• Ustaw identyfikator klienta OAuth Google w koncie integracji. Wpisz Client ID w Ustawieniach konta i zapisz.
• Google odrzuciło autoryzację albo pokazuje błąd redirect_uri_mismatch. Adres przekierowania w Google Cloud musi być identyczny z adresem z okna Autoryzacja Google. Dodaj brakujący adres i spróbuj ponownie.
• Google nie zwróciło tokenu odświeżania. Cofnij dostęp aplikacji w koncie Google i ponów Zaloguj z Google. Mantrego prosi o zgodę offline za każdym razem.
• Po tygodniu połączenie przestaje działać. Gdy aplikacja w Google Cloud ma status Testowanie, Google wygasza token odświeżania po 7 dniach. Kliknij ponownie Zaloguj z Google. Aby uniknąć tego na stałe, trzeba zmienić status aplikacji na produkcyjny, co dla zakresów Gmail oznacza weryfikację u Google (patrz niżej).
• Link logowania wygasł. Kliknij Zaloguj z Google jeszcze raz, link żyje 10 minut.
• Przycisk Sprawdź jest wyszarzony. Konto nie ma jeszcze tokenu. Dokończ logowanie przez Google.
• Konto zmieniło się podczas autoryzacji. Nie edytuj konta w trakcie logowania. Zacznij od początku.
• Błąd odczytu poczty. Sprawdź połączenie przyciskiem Sprawdź, a potem Synchronizuj.

Ograniczenia

• Uprawnienia Gmail gmail.readonly i gmail.compose Google klasyfikuje jako zakresy ograniczone (restricted). Publikacja aplikacji dla wielu użytkowników zwykle wymaga weryfikacji i audytu bezpieczeństwa po stronie Google. Do własnej pracy najczęściej używa się statusu Testowanie z dodanymi użytkownikami testowymi, pamiętając o 7-dniowym wygasaniu tokenu.
• Mantrego nie pobiera treści załączników. Wiadomości HTML są pokazywane w izolowanej ramce po oczyszczeniu, a skrypty nie są wykonywane. Obrazy z zewnątrz są domyślnie zablokowane (przycisk Pokaż obrazy), a przełącznik Pokaż jako tekst zamienia wiadomość na tekst.
• Wysyłka wiadomości zawsze przechodzi przez centrum Akceptacje.
• Podłączenie ma sens tylko po poprawnej konfiguracji u Google. Mantrego nie zastępuje konfiguracji konta Google Cloud.

Powiązane artykuły

• Jak dodać pocztę firmową przez IMAP i SMTP
• Jak połączyć Kalendarz Google
• Gmail i poczta IMAP w jednym miejscu, z wątkami przypisanymi do klienta
• Maile od klientów pod kontrolą: porządek w skrzynce managera
• Otwórz aplikację