Integracja Google Workspace z systemem telefonicznym 3CX

Wprowadzenie

System 3CX może integrować się z usługą Google, zapewniając następujące funkcjonalności:

  • Synchronizacja kont użytkowników z Google Workspace.
  • Synchronizacja osobistych kontaktów użytkownika z osobistą książką telefoniczną 3CX (jednokierunkowa).
  • Zmiana statusu profilu 3CX na podstawie wydarzeń w Kalendarzu Google (np. jeśli jesteś na spotkaniu, Twój status zostanie ustawiony jako zajęty).
  • Tworzenie i używanie zasobników Google Buckets jako zdalnego magazynu dla systemu telefonicznego 3CX.
  • Używanie usługi Google Speech do transkrypcji nagrań i wiadomości poczty głosowej.
  • Używanie kont Google Workspace do wysyłania wiadomości e-mail.
  • Włączenie opcji Google SSO, co pozwala użytkownikom na logowanie się do aplikacji Web Client przy użyciu ich poświadczeń Google (wymaga osobnej konfiguracji w utworzonym projekcie Google).
  • Włączenie usługi Google reCAPTCHA w celu ochrony przed automatycznymi atakami i nadużyciami.

Konfiguracja integracji z Google

Krok 1: Rola Super Admina w usłudze Workspace

Aby integracja działała, logujący się użytkownik musi posiadać rolę Super Admina w usłudze Workspace. Postępuj zgodnie z poniższymi krokami, aby nadaj rolę Super Admina użytkownikowi, którego użyjesz do uwierzytelnienia integracji Google z Twoją centralą PBX.

  1. Zaloguj się na stronie https://admin.google.com/
  2. Przejdź do „Directory” (Katalog) > „Users” (Użytkownicy).

  1. Edytuj użytkownika, którego chcesz podnieść do roli Super Admina, i otwórz sekcję „Admin roles and privileges” (Role i uprawnienia administratora).
  2. Włącz rolę Super Admin dla użytkownika, którego użyjesz do uwierzytelnienia integracji z Google, i kliknij „Save” (Zapisz).

Krok 2: Role na poziomie organizacji w konsoli Google Console

Dodatkowo, w przypadku gdy planujesz włączyć następujące funkcje, musisz nadaj użytkownikowi rolę IAM „Billing Account Administrator” w konsoli Google Console.

  • Używanie Google Cloud jako zdalnego magazynu dla systemu telefonicznego 3CX.
  • Używanie transkrypcji dla nagrań i wiadomości poczty głosowej.

Aby to zrobić, postępuj zgodnie z poniższymi krokami:

  1. Zaloguj się na stronie https://console.cloud.google.com
  2. Upewnij się, że działasz na poziomie Organizacji. Możesz wybrać organizację, klikając rozwijane menu na górze strony.
  3. W lewym menu nawigacyjnym przejdź do „IAM & Admin” > „IAM”.
  4. Kliknij „Grant Access” (Przyznaj dostęp).
  5. W otwartym prawym panelu > w polu „New Principals” (Nowe podmioty) dodaj adres e-mail użytkownika uwierzytelniającego integrację z Google.
  6. W sekcji „Assign Roles” (Przypisz role) dodaj rolę „Billing Account Administrator”, jak pokazano na zrzucie ekranu.
  7. Kliknij „Save” (Zapisz).

Krok 3: Wyłączenie egzekwowania tworzenia kluczy kont usługowych – jeśli dotyczy

W zależności od daty utworzenia Twojego konta Google, polityka organizacji disableServiceAccountKeyCreation może być domyślnie egzekwowana, co uniemożliwia tworzenie kluczy dla Twojego konta.

W takim przypadku podczas integracji usługi Google z centralą PBX możesz otrzymać błąd informujący o braku zezwolenia na tworzenie klucza.

Aby to rozwiązać, może być konieczne zatrzymanie egzekwowania tej polityki za pomocą następujących kroków:

Uwaga: Aby zarządzać politykami organizacji na swoim koncie Google, musisz zalogować się do konsoli Google Console jako użytkownik posiadający rolę „Organization Policy Administrator”.

  1. W konsoli Google Console przejdź do „IAM & Admin” > „Organization Policies” (Polityki organizacji).
  2. Wyszukaj iam.disableServiceAccountKeyCreation, jeśli używasz starszej wersji ograniczenia, lub iam.managed.disableServiceAccountKeyCreation, jeśli używasz nowej wersji ograniczenia.
  3. Otwórz „Disable service account key creation” i kliknij „Manage Policy” (Zarządzaj polityką).
  4. W sekcji „Policy Source” (Źródło polityki) wybierz „Override parent’s policy” (Zastąp politykę nadrzędną).
  5. W sekcji „Rules” (Reguły) dodaj regułę z ustawieniem Enforcement = Off (Egzekwowanie = Wyłączone).
  6. Kliknij „Set Policy” (Ustaw politykę).

Krok 4: Integracja centrali PBX z Google

  1. W sekcji Admin przejdź do „Integrations” (Integracje) > „Google” i wybierz „Configure” (Skonfiguruj).

  1. Zostaniesz przekierowany na następującą stronę integracji. Wybierz wszystkie potrzebne funkcje, których planujesz używać, i kliknij „Connect” (Połącz).

  1. Po wyświetleniu monitu o zalogowanie się do konta Google uwierzytelnij się przy użyciu użytkownika, któremu w poprzednich krokach nadano wszystkie odpowiednie role i uprawnienia.
  2. Jeśli pojawi się monit, wybierz opcję „All” (Wszystkie), aby zezwolić systemowi 3CX na dostęp do wymaganych zasobów, i kliknij „Continue” (Kontynuuj).

  1. Podczas procesu uwierzytelniania (tylko w przypadku pierwszego logowania nowym użytkownikiem), jeśli otrzymasz komunikat o akceptacji warunków korzystania z usługi, postępuj zgodnie z poniższymi krokami. Jeśli nie otrzymasz tego komunikatu, możesz przejść bezpośrednio do punktu 9 poniżej.

  1. Przejdź do strony https://console.developers.google.com/terms/appsadmin.
  2. Powinieneś otrzymać prośbę o zaakceptowanie warunków korzystania z usługi.

  1. Kliknij „Accept” (Zaakceptuj) i powtórz proces uwierzytelniania z kroku 4.2 powyżej.
  2. Po zakończeniu uwierzytelniania zobaczysz następującą stronę.

  1. Skopiuj wygenerowany identyfikator klienta (Client ID) i kliknij link, aby otworzyć „Domain-wide Delegation” (Delegacja dla całej domeny) w panelu administracyjnym.
  2. Kliknij „Add New” (Dodaj nowy) w sekcji „API Clients” (Klienci API), podaj skopiowany powyżej identyfikator klienta (Client ID) i wypełnij wszystkie wartości zakresów OAuth (OAuth scopes) wymienione na poprzednim ekranie (skopiuj je bezpośrednio ze strony).
  3. Po zakończeniu kliknij „Authorize” (Autoryzuj).

  1. Kliknij przycisk „Back” (Wstecz) na poprzednim ekranie, a zostaniesz przekierowany z powrotem do konsoli administracyjnej centrali PBX, gdzie integracja z Google Workspace wyświetli się jako skonfigurowana, podając identyfikator projektu (Project ID) wygenerowany w powyższym procesie.

Włączenie synchronizacji

Po sfinalizowaniu integracji Google z centralą PBX możesz przejść do synchronizacji użytkowników z Google do 3CX:

  1. W konsoli administracyjnej 3CX przejdź do „Users” (Użytkownicy) i kliknij „Google”.
  2. Włącz opcję „Sync Google Users” (Synchronizuj użytkowników Google), aby synchronizować użytkowników z Google do 3CX. Synchronizacja jest jednokierunkowa (z Google do 3CX) i następuje natychmiast po zapisaniu konfiguracji, a następnie raz dziennie w nocy.
  3. Możesz ustawić początkowy numer wewnętrzny, który zostanie przypisany do zaimportowanych użytkowników Google. W przeciwnym razie użyty zostanie pierwszy dostępny numer wewnętrzny.
  4. Nie musisz synchronizować wszystkich użytkowników. Możesz wykluczyć określonych użytkowników lub wskazać tylko konkretny zestaw użytkowników do synchronizacji. Kliknij przycisk „Add” (Dodaj), aby skonfigurować.

Wybór opcji synchronizacji

Po włączeniu synchronizacji użytkowników możesz wybrać, co ma być synchronizowane dla zaimportowanych użytkowników Google:

  1. Włącz „SSO”, aby umożliwić użytkownikom logowanie się do aplikacji Web Client przy użyciu ich poświadczeń Google (wymaga osobnej konfiguracji. Zobacz jak tutaj).
  2. Synchronizuj zdjęcia użytkowników z Google do 3CX jako awatary użytkowników, włączając opcję „Sync user photo” (Synchronizuj zdjęcie użytkownika).
  3. Możesz włączyć opcję „Sync Personal Contacts” (Synchronizuj kontakty osobiste), która zsynchronizuje kontakty użytkownika Google z osobistą książką telefoniczną 3CX. Jest to synchronizacja jednokierunkowa. Kontaktami należy zarządzać i aktualizować je z poziomu Google.
  4. Włącz opcję „Use calendar events as presence” (Używaj wydarzeń z kalendarza jako statusu obecności), aby automatycznie aktualizować status użytkowników 3CX na podstawie zaplanowanych spotkań w ich Kalendarzach Google. Dzięki temu, gdy jesteś na zaplanowanym spotkaniu, Twój telefon nie będzie dzwonił. Po zakończeniu wpisu w Kalendarzu Google system 3CX przywraca profil do poprzedniego statusu. Jeśli wybrany jest profil 3CX Wyjazd służbowy / Lunch (Business Trip / Lunch), zmiany wynikające z informacji w kalendarzu są ignorowane.

Mapowanie typów spotkań z Kalendarza Google na profile 3CX wygląda następująco:

  • Wydarzenie (Event) > Nie przeszkadzać (Do Not Disturb)
  • Czas skupienia (Focus Time) > Nie przeszkadzać (Do Not Disturb)
  • Poza biurem (Out of Office) > Zaraz wracam (Away)

Dodatkowe funkcje

Google Cloud jako magazyn zdalny

Podczas konfiguracji integracji z Google w systemie 3CX, jeśli w procesie konfiguracji udzielono odpowiednich uprawnień, system 3CX automatycznie utworzy zasobnik Google (Google bucket) w Twoim projekcie Google Cloud i odpowiednio skonfiguruje ustawienia magazynu 3CX.

Następnie w konsoli administracyjnej: „Admin” > „System” > „Storage” (Magazyn) wybierz dane, które chcesz przechowywać w zdalnej lokalizacji Google. W razie potrzeby możesz przechowywać zdalnie pliki czatu (Chat Files), faksy (Faxes), nagrania (Recordings), pocztę głosową (Voicemails) oraz kopie zapasowe (Backups).

Google Speech do transkrypcji

Jeśli wybrano odpowiednie uprawnienia, możesz włączyć transkrypcję Google Speech przy użyciu konfiguracji Google utworzonej automatycznie w procesie integracji.

Po skonfigurowaniu integracji i magazynu Google w systemie 3CX przejdź do konsoli administracyjnej: „Admin” > „Integrations” (Integracje) > „Transcription” (Transkrypcja) i włącz transkrypcję Google Speech dla wybranego języka.

Używanie Google Workspace do wysyłania wiadomości e-mail

Jeśli podczas procesu integracji przyznano odpowiednie prawa, system 3CX automatycznie skonfiguruje systemowe ustawienia poczty e-mail, aby używać zintegrowanego konta Google Workspace do wysyłania systemowych wiadomości e-mail.

Google ReCaptcha

Gdy integracja z Google posiada odpowiednie uprawnienia, możesz włączyć usługę Google reCAPTCHA w konsoli administracyjnej: „Admin” > „Integrations” (Integracje) > „Google”, aby chronić system 3CX przed automatycznymi atakami i nadużyciami.

Informacje techniczne i często zadawane pytania (FAQ)

Synchronizacja w czasie rzeczywistym a synchronizacja codzienna

Następujące dane są synchronizowane w czasie rzeczywistym przy zmianach w usłudze Google:

  • Imię użytkownika
  • Nazwisko użytkownika
  • Zdjęcie użytkownika
  • Służbowy numer telefonu użytkownika
  • Utworzenie nowego użytkownika w usłudze Workspace
  • Zawieszenie/Usunięcie użytkownika w usłudze Workspace > Wyłącza numer wewnętrzny w 3CX
  • Odwieszenie użytkownika w usłudze Workspace > Włącza numer wewnętrzny w 3CX
  • Wydarzenia z kalendarza

Pozostałe dane, dla których nie nasłuchujemy zmian na żywo, centrala PBX synchronizuje raz dziennie. Codzienna synchronizacja jest kontrolowana przez parametr GW_SYNC_TIME. Przechowuje on porę dnia w formacie 24-godzinnym: HH:MM:SS, w której centrala PBX ponownie zsynchronizuje wszystkie dane z Google.

Statusy synchronizacji kalendarza

Utworzenie wpisu w Kalendarzu Google zsynchronizuje status obecności użytkownika w następujący sposób:

  • Wydarzenie (Event) > DND (Nie przeszkadzać)
  • Poza biurem (Out of Office) > Away (Zaraz wracam)
  • Czas skupienia (Focus time) > DND (Nie przeszkadzać)

Synchronizacja danych użytkowników i kontaktów

Dla zsynchronizowanych użytkowników synchronizujemy następujące informacje z Google:

  • Imię
  • Nazwisko
  • E-mail
  • Telefon (Służbowy) do pola Komórkowy (Mobile) użytkownika w 3CX
  • Zdjęcie

Dla zsynchronizowanych kontaktów synchronizujemy następujące informacje z Google:

  • Imię
  • Nazwisko
  • Zdjęcie
  • Firma
  • Stanowisko
  • Komórkowy
  • Komórkowy2
  • Domowy
  • Służbowy
  • Służbowy2
  • E-mail

Aby prawidłowo zsynchronizować te informacje o kontaktach, musisz oznaczyć je w Kontaktach Google tak, jak pokazano na zrzucie ekranu poniżej.

Istniejąca konfiguracja magazynu Google Storage

W przypadku, gdy masz już włączony magazyn Google Storage, podczas procesu integracji kreator poinformuje Cię o tym i nie skonfiguruje go ponownie za Ciebie.

Ograniczenia i znane problemy

  • Kontakty firmowe nie istnieją
  • Usługa Gmail posiada maksymalny rozmiar załącznika wynoszący 25 MB na wiadomość
  • Brak możliwości nasłuchiwania zmian w kontaktach osobistych
  • Tworzenie kontaktów z poziomu aplikacji Web Client do Google będzie dostępne w przyszłym wydaniu

Zobacz również


Ostatnia aktualizacja
Ten dokument był ostatnio aktualizowany 10 września 2026 r.
https://www.3cx.pl/docs/administrator/google-workspace/