Integracja Google Workspace z systemem telefonicznym 3CX

Wstęp

3CX może integrować się z Google, aby zapewnić następującą funkcjonalność:

  • Synchronizacja kont użytkowników z Google Workspace.
  • Jednokierunkowa synchronizacja osobistych kontaktów użytkownika z osobistą książką telefoniczną 3CX.
  • Zmiana statusu profilu 3CX na podstawie wydarzeń z Kalendarza Google, np. podczas spotkania status zostanie ustawiony na „zajęty”
  • Tworzenie i używanie Google Buckets do zdalnego przechowywania danych systemu telefonicznego 3CX.
  • Wykorzystanie Google Speech do transkrypcji nagrań i poczty głosowej.
  • Wysyłanie e-maili przy użyciu kont Google Workspace.
  • Włączenie Google SSO umożliwiające użytkownikom logowanie do Web Client za pomocą danych logowania Google (wymaga osobnej konfiguracji w utworzonym projekcie Google).
  • Włączenie Google ReCaptcha w celu ochrony przed zautomatyzowanymi atakami i nadużyciami.

Konfigurowanie integracji z Google

Krok 1: Rola Super Admin w Google Workspace

Aby integracja działała poprawnie, użytkownik logujący się musi mieć przypisaną rolę Super Admin w Google Workspace. Wykonaj poniższe kroki, aby nadać użytkownikowi tę rolę do uwierzytelnienia integracji Google z Twoim systemem PBX:

  1. Zaloguj się na stronie https://admin.google.com/
  2. Przejdź do Katalog > Użytkownicy.

  1. Edytuj użytkownika, którego chcesz podnieść do roli Super Admin, i otwórz sekcję Role i uprawnienia administratora.
  2. Włącz rolę Super Admin dla użytkownika, którego będziesz używać do uwierzytelnienia integracji Google, i kliknij Zapisz.

Krok 2: Role na poziomie organizacji w Google Console

Dodatkowo, jeśli planujesz włączyć następujące funkcje, musisz nadać swojemu użytkownikowi rolę Billing Account Administrator (Administrator konta rozliczeniowego) w Google Console:

  • Korzystanie z Google Cloud do zdalnego przechowywania danych systemu telefonicznego 3CX.
  • Wykorzystanie transkrypcji dla nagrań i poczty głosowej.

Aby to zrobić, wykonaj poniższe kroki:

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

Krok 3: Wyłączenie wymuszania tworzenia kluczy konta usługi – jeśli dotyczy

W zależności od daty utworzenia Twojego konta Google, polityka organizacyjna disableServiceAccountKeyCreation może być domyślnie wymuszona, co uniemożliwia tworzenie kluczy konta usługi.

W takim przypadku podczas integracji Google z Twoim PBX możesz otrzymać komunikat o błędzie dotyczący braku możliwości utworzenia klucza.

Aby obejść ten problem, możesz wyłączyć wymuszanie tej polityki, wykonując poniższe kroki:

Uwaga: Uwaga: Aby zarządzać politykami organizacyjnymi na swoim koncie Google, musisz zalogować się do Google Console przy użyciu konta z przypisaną rolą Administratora polityk organizacyjnych (Organization Policy Administrator).

  1. W Google Console przejdź do IAM & Admin > Polityka organizacji.
  2. Wyszukaj iam.disableServiceAccountKeyCreation– jeśli używasz starszej wersji ograniczenia lub iam.managed.disableServiceAccountKeyCreation– jeśli korzystasz z nowej wersji ograniczenia.
  3. Otwórz opcję Disable service account key creation (Wyłącz tworzenie kluczy konta usługi) i kliknij Manage Policy (Zarządzaj polityką).
  4. Pod Policy Source (Źródło polityki) wybierz Override parent’s policy (Nadpisz politykę nadrzędną).
  5. Under Rules Add a rule with Enforcement = Off. W sekcji Zasady dodaj zasadę z ustawieniem „Enforcement = Off” (Egzekwowanie = Wyłącz).
  6. Kliknij Set Policy (Ustaw politykę).

Krok 4: Zintegrowanie PBX z Google

  1. W konsoli administracyjnej PBX przejdź do sekcji Integracje > Google i kliknij Skonfiguruj.

  1. Zostaniesz przekierowany na stronę integracji. Wybierz wszystkie funkcje, które planujesz używać, i kliknij Połącz.

  1. Uwierzytelnij się przy użyciu użytkownika, któremu nadałeś wszystkie odpowiednie role i uprawnienia w poprzednich krokach, gdy pojawi się monit o zalogowanie się do konta Google.
  2. Jeśli pojawi się monit, wybierz Wszystkie, aby zezwolić 3CX na dostęp do wymaganych zasobów i kliknij Kontynuuj.

  1. Podczas procesu autoryzacji (tylko jeśli logujesz się po raz pierwszy nowym użytkownikiem), w przypadku otrzymania komunikatu o akceptacji warunków użytkowania, wykonaj następujące kroki. Jeśli nie otrzymasz tego komunikatu, przejdź do kroku 9 poniżej.

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

  1. Kliknij Akceptuj i powtórz proces uwierzytelniania w kroku 4.2 powyżej.
  2. Po zakończeniu uwierzytelniania zostanie wyświetlona następująca strona.

  1. Skopiuj wygenerowany identyfikator klienta i kliknij w link, aby otworzyć Delegację w całej domenie w Panelu administracyjnym.
  2. Kliknij Dodaj nowego w sekcji API Clients (Klienci API), wprowadź skopiowany wcześniej identyfikator klienta (Client ID) i wypełnij wszystkie wartości zakresów OAuth, które były wyświetlone na poprzednim ekranie (skopiuj je bezpośrednio ze strony).
  3. Po zakończeniu kliknij Autoryzuj.

  1. Kliknij Wstecz na poprzednim ekranie, a zostaniesz przekierowany do konsoli administracyjnej PBX, gdzie integracja z Google Workspace będzie widoczna jako skonfigurowana, podając identyfikator projektu (Project ID) wygenerowany w powyższym procesie.

Włączanie synchronizacji

Po zakończeniu integracji Google z PBX możesz przystąpić do synchronizacji użytkowników z Google do 3CX:

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

Wybierz opcje synchronizacji

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

  1. Włącz SSO, aby umożliwić użytkownikom logowanie do Web Client przy użyciu danych logowania Google (wymaga osobnej konfiguracji. Patrz tutaj).
  2. Włącz „Sync user photo” (Synchronizuj zdjęcie użytkownika), aby zsynchronizować zdjęcia użytkowników Google jako awatary w 3CX.
  3. Możesz włączyć opcję „Sync Personal Contacts” (Synchronizuj kontakty osobiste), która zsynchronizuje kontakty użytkowników Google z osobistą książką telefoniczną 3CX. Jest to synchronizacja jednokierunkowa – kotaktami należy zarządzać i aktualizować z poziomu Google.
  4. Włącz „Use calendar events as presence” (Użyj wydarzeń kalendarza jako statusu obecności), aby automatycznie aktualizować statusy użytkowników 3CX na podstawie zaplanowanych spotkań w kalendarzu Google. Jeśli użytkownik ma zaplanowane spotkanie, jego telefon nie zadzwoni. Po zakończeniu 3CX przywróci poprzedni status. Jeśli wybrano profil Podróż służbowa/Przerwa na lunch w 3CX, zmiany wynikające z informacji z kalendarza są ignorowane.

Mapowanie typów spotkań Google Calendar na profile 3CX:

  • Wydarzenie > Nie przeszkadzać
  • Czas skupienia > Nie przeszkadzać
  • Poza biurem > Nieobecny

Dodatkowe funkcje

Google Cloud do zdalnego przechowywania danych

Konfigurując integrację Google w 3CX, jeśli podczas procesu konfiguracji zostaną nadane odpowiednie uprawnienia, 3CX automatycznie utworzy Google bucket w Twoim projekcie Google Cloud i odpowiednio skonfiguruje ustawienia przechowywania w 3CX.

Następnie możesz przejść do Konsola administracyjna > System > Storage i wybrać dane, które chcesz przechowywać w tej zdalnej lokalizacji Google. Możesz wybrać zdalne przechowywanie plików z czatu, faksów, nagrań, poczty głosowej oraz zaplanowanych kopii zapasowych.

Google Speech do transkrypcji

Jeśli wybrane zostały odpowiednie uprawnienia, możesz włączyć transkrypcję za pomocą Google Speech, korzystając z konfiguracji Google utworzonej automatycznie podczas procesu integracji.


Po zakończeniu integracji Google i skonfigurowaniu przechowywania w 3CX, przejdź do Konsola administracyjna > Integracje > Transkrypcja i włącz transkrypcję przy użyciu Google Speech dla preferowanego języka.

Używanie Google Workspace do wysyłania e-maili

Przy nadaniu odpowiednich uprawnień podczas procesu integracji, 3CX automatycznie skonfiguruje systemowe ustawienia poczty e-mail, aby korzystać ze zintegrowanego konta Google Workspace do wysyłania wiadomości systemowych.

Google ReCaptcha

Po skonfigurowaniu integracji Google z odpowiednimi uprawnieniami, możesz włączyć Google ReCaptcha, przechodząc do Konsola administracyjna > Integracje > Google. ReCaptcha będzie działać w tle, chroniąc 3CX przed automatycznymi atakami i nadużyciami.

Informacje techniczne i FAQ

Synchronizacja w czasie rzeczywistym vs codzienna

Poniższe dane są synchronizowane w czasie rzeczywistym przy zmianach w Google:

  • Imię użytkownika
  • Nazwisko użytkownika
  • Zdjęcie użytkownika
  • Służbowy numer telefonu użytkownika
  • Nowy użytkownik utworzony w Workspace
  • Zawieszenie/usunięcie użytkownika w Workspace > powoduje wyłączenie numeru wewnętrznego w 3CX
  • Przywrócenie użytkownika w Workspace > powoduje włączenie numeru wewnętrznego w 3CX
  • Wydarzenia z kalendarza

Pozostałe dane, dla których nie są monitorowane zmiany w czasie rzeczywistym, PBX synchronizuje raz dziennie. Codzienna synchronizacja jest kontrolowana przez parametr GW_SYNC_TIME. Kiedy PBX ponownie zsynchronizuje wszystkie dane z Google, określa on godzinę synchronizacji w formacie 24-godzinnym: HH:MM:SS,

Statusy synchronizacji kalendarza

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

  • Wydarzenie > DND
  • Poza biurem > Nieobecny
  • Czas skupienia > DND

Synchronizacja danych użytkownika i kontaktów

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

  • Imię
  • Nazwisko
  • E-mail
  • Phone(Work) to user’s Mobile in 3CX
  • Telefon (służbowy) do pola Mobile (Telefon komórkowy) w 3CX
  • Zdjęcie

Dla synchronizowanych kontaktów pobierane są następujące informacje z Google:

  • Imię
  • Nazwisko
  • Zdjęcie
  • Firma
  • Stanowisko
  • Telefon komórkowy
  • Telefon komórkowy 2
  • Telefon domowy
  • Telefon służbowy
  • Telefon służbowy 2
  • E-mail

Aby poprawnie zsynchronizować te dane kontaktowe, musisz oznaczyć je w Kontaktach Google, jak pokazano na poniższym zrzucie ekranu.

Istniejąca konfiguracja Google Storage

W przypadku, gdy masz już włączony Google Storage, podczas procesu integracji kreator poinformuje Cię o tym i nie dokona ponownej konfiguracji.

Ograniczenia i znane problemy

  • Kontakty firmowe nie istnieją.
  • Gmail ma maksymalny rozmiar załącznika wynoszący 25 MB na wiadomość.
  • Nie ma sposobu, aby nasłuchiwać zmian w kontaktach osobistych.
  • Tworzenie kontaktów z Web Client do Google będzie dostępne w przyszłej wersji.

Zobacz również

Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 19 lutego 2025
https://www.3cx.pl/docs/administrator/google-workspace/