Google Workspace-Integration für das 3CX-Telefonsystem

Einführung

3CX kann in Google integriert werden, um die folgenden Funktionen bereitzustellen:

• Synchronisieren Sie Nutzerkonten aus Google Workspace.
• Synchronisieren Sie die persönlichen Kontakte des Nutzers mit dem persönlichen 3CX-Telefonbuch (einseitig).
• Der 3CX-Profilstatus wird basierend auf Google Kalender-Terminen geändert, z. B. wenn Sie sich in einem Meeting befinden, wird Ihr Status auf beschäftigt gesetzt.
• Erstellen und verwenden Sie Google Buckets für den Remote-Speicher des 3CX-Telefonsystems.
• Verwenden Sie Google Speech zur Transkription von Aufzeichnungen und Sprachnachrichten.
• Verwenden Sie Google Workspace-Konten zum Senden von E-Mails.
• Aktivieren von Google SSO, damit sich Nutzer mit ihren Google-Anmeldedaten beim Webclient anmelden können (Muss separat im erstellten Google-Projekt konfiguriert werden).
• Aktivieren von Google ReCaptcha zum Schutz vor automatisierten Angriffen und Missbrauch.

Konfigurieren der Google-Integration

Schritt 1: Super-Admin-Rolle im Arbeitsbereich

Damit die Integration funktioniert, muss der sich anmeldende Nutzer über die Super-Admin-Rolle im Arbeitsbereich verfügen. Befolgen Sie die folgenden Schritte, um dem Nutzer, den Sie zur Authentifizierung der Google-Integration mit Ihrer Telefonanlage verwenden, die Super-Admin-Rolle zu gewähren.

1. Melden Sie sich an unter https://admin.google.com/
2. Navigieren Sie zu Verzeichnis > Nutzer.

3. Bearbeiten Sie den Nutzer, den Sie zum Super-Admin heraufstufen möchten, und öffnen Sie den Bereich Administratorrollen und -rechte.
4. Aktivieren Sie die Super-Admin-Rolle für den Nutzer, den Sie zur Authentifizierung der Google-Integration verwenden werden, und klicken Sie auf Speichern.

Schritt 2: Rollen auf Organisationsebene in der Google Console

Falls Sie die folgenden Funktionen aktivieren möchten, müssen Sie Ihrem Nutzer in der Google Console zusätzlich die IAM-Rolle "Rechnungskonto-Administrator" zuweisen.

• Verwenden Sie Google Cloud für den Remote-Speicher des 3CX-Telefonsystems.
• Verwenden Sie die Transkription für Aufzeichnungen und Sprachnachrichten.

Gehen Sie dazu wie folgt vor:

1. Melden Sie sich an unter https://console.cloud.google.com
2. Stellen Sie sicher, dass Sie auf Organisationsebene arbeiten. Sie können die Organisation auswählen, indem Sie oben auf der Seite auf das Dropdown-Menü klicken.
3. Gehen Sie im linken Navigationsmenü zu IAM & Admin > IAM.
4. Klicken Sie auf Zugriff gewähren.
5. Fügen Sie im geöffneten rechten Bereich im Feld Neue Hauptmitglieder die E-Mail-Adresse des Nutzers hinzu, der sich bei der Google-Integration authentifiziert.
6. Fügen Sie unter Rollen zuweisen die Rolle Rechnungskonto-Administrator hinzu, wie im Screenshot gezeigt.
7. Speichern.

Schritt 3: Deaktivieren der Durchsetzung der Dienstkontoschlüsselerstellung – falls zutreffend

Abhängig vom Erstellungsdatum Ihres Google-Kontos ist die Organisationsrichtlinie disableServiceAccountKeyCreation möglicherweise standardmäßig erzwungen, was die Erstellung von Kontoschlüsseln für Ihr Konto verhindert.

In diesem Fall erhalten Sie möglicherweise eine Fehlermeldung bei der Integration von Google in Ihre Telefonanlage, dass die Schlüsselerstellung nicht zulässig ist.

Um dies zu beheben, müssen Sie die Durchsetzung dieser Richtlinie mithilfe der folgenden Schritte aufheben:

Hinweis: Um Organisationsrichtlinien für Ihr Google-Konto zu verwalten, müssen Sie sich mit einem Nutzer bei der Google Console anmelden, der über die Rolle Organisationsrichtlinien-Administrator verfügt.

1. Navigieren Sie in der Google Console zu IAM & Admin > Organisationsrichtlinien.
2. Suchen Sie nach iam.disableServiceAccountKeyCreation, wenn Sie die Legacy-Version der Einschränkung verwenden, oder nach iam.managed.disableServiceAccountKeyCreation, wenn Sie die neue Version verwenden.
3. Öffnen Sie Erstellung von Dienstkontoschlüsseln deaktivieren und klicken Sie auf Richtlinie verwalten.
4. Wählen Sie unter Richtlinienquelle Übergeordnete Richtlinie überschreiben.
5. Fügen Sie unter Regeln eine Regel mit Durchsetzung = Aus hinzu.
6. Klicken Sie auf Richtlinie festlegen.

Schritt 4: PBX mit Google integrieren

1. Gehen Sie im Admin-Bereich zu "Integrationen" > "Google" und wählen Sie "Konfigurieren".

2. Sie werden zur folgenden Integrationsseite weitergeleitet. Wählen Sie alle benötigten Funktionen aus, die Sie verwenden möchten, und klicken Sie auf Verbinden.

3. Authentifizieren Sie sich mit dem Nutzer, dem Sie in den vorherigen Schritten alle relevanten Rollen und Berechtigungen erteilt haben, wenn Sie aufgefordert werden, sich bei Ihrem Google-Konto anzumelden.
4. Wenn Sie aufgefordert werden, wählen Sie Alle aus, um 3CX den Zugriff auf die erforderlichen Ressourcen zu erlauben, und klicken Sie auf Weiter.

5. Wenn Sie während des Authentifizierungsprozesses (nur bei der ersten Anmeldung mit einem neuen Nutzer) die Meldung zum Akzeptieren der Nutzungsbedingungen erhalten, befolgen Sie diese Schritte. Wenn Sie diese Meldung nicht erhalten, können Sie direkt zu Schritt 9 unten übergehen.

6. Navigieren Sie zu https://console.developers.google.com/terms/appsadmin.
7. Sie sollten eine Aufforderung zum Akzeptieren der Nutzungsbedingungen erhalten haben.

8. Klicken Sie auf Akzeptieren und wiederholen Sie den Authentifizierungsprozess aus Schritt 4.2 oben.
9. Sobald die Authentifizierung abgeschlossen ist, wird Ihnen die folgende Seite angezeigt.

10. Kopieren Sie die generierte Client-ID und klicken Sie auf den Link, um die domänenweite Delegation in der Admin-Konsole zu öffnen.
11. Klicken Sie unter API-Clients auf Neu hinzufügen, geben Sie die oben kopierte Client-ID ein und tragen Sie alle auf dem vorherigen Bildschirm aufgelisteten OAuth-Bereichswerte ein (kopieren Sie diese direkt von der Seite).
12. Klicken Sie anschließend auf Autorisieren.

13. Klicken Sie auf dem vorherigen Bildschirm auf die Schaltfläche Zurück. Sie werden zur 3CX Admin-Konsole weitergeleitet, wo die Google Workspace-Integration als konfiguriert angezeigt wird und Ihnen die durch den obigen Prozess generierte Projekt-ID bereitstellt.

Aktivieren der Synchronisierung

Nach Abschluss der Google-Integration mit der Telefonanlage können Sie mit der Synchronisierung der Nutzer von Google zu 3CX fortfahren:

1. Gehen Sie in der 3CX Admin-Konsole zu Nutzer und klicken Sie auf Google.
2. Aktivieren Sie Google-Nutzer synchronisieren, um Nutzer von Google zu 3CX zu synchronisieren. Die Synchronisierung erfolgt einseitig (Google zu 3CX) und wird sofort ausgeführt, wenn Sie die Konfiguration speichern, sowie danach einmal täglich nachts.
3. Sie können eine Start-Nebenstellennummer festlegen, die importierten Google-Nutzern zugewiesen wird. Andernfalls wird die erste verfügbare Nebenstelle verwendet.
4. Sie müssen nicht alle Nutzer synchronisieren. Sie können bestimmte Nutzer ausschließen oder nur eine bestimmte Gruppe von Nutzern für die Synchronisierung festlegen. Klicken Sie auf die Schaltfläche Hinzufügen, um dies zu konfigurieren.

Wählen Sie Synchronisierungsoptionen

Nach der Aktivierung der Nutzersynchronisierung können Sie auswählen, was für die importierten Google-Nutzer synchronisiert werden soll:

1. Aktivieren Sie SSO, um Nutzern die Anmeldung am Webclient mit ihren Google-Anmeldedaten zu ermöglichen (Muss separat konfiguriert werden. Siehe Anleitung hier).
2. Synchronisieren Sie Google-Nutzerfotos zu 3CX als Nutzer-Avatar, indem Sie Nutzerfoto synchronisieren aktivieren.
3. Sie können die Option Pers. Kontakte synchronisieren aktivieren, um Google-Kontakte von Nutzern mit dem persönlichen 3CX-Telefonbuch zu synchronisieren. Dies ist eine einseitige Synchronisierung. Kontakte müssen in Google verwaltet und aktualisiert werden.
4. Aktivieren Sie Kalendertermine als Präsenz verwenden, um den Status von 3CX-Nutzern automatisch basierend auf ihren geplanten Google Kalender-Meetings zu aktualisieren. Wenn Sie sich in einem geplanten Meeting befinden, klingelt Ihr Telefon nicht. Am Ende des Google Kalender-Eintrags schaltet 3CX das Profil wieder auf den vorherigen Status zurück. Wenn das 3CX-Profil Geschäftsreise/Mittagessen ausgewählt ist, werden Änderungen durch Kalenderinformationen ignoriert.

Die Zuordnung von Google Kalender-Ereignistypen zu 3CX-Profilen ist wie folgt:

• Termin > Nicht stören
• Fokuszeit > Nicht stören
• Abwesend > Abwesend

Zusätzliche Funktionen

Google Cloud für Remote-Speicher

Wenn Sie die Google-Integration in Ihrer 3CX-Anlage konfigurieren und während des Konfigurationsprozesses die entsprechenden Berechtigungen erteilen, erstellt 3CX automatisch einen Google Bucket in Ihrem Google Cloud-Projekt und konfiguriert Ihre 3CX-Speichereinstellungen entsprechend.

Wählen Sie dann in der Admin-Konsole > System > Speicher die Daten aus, die Sie am entfernten Google-Speicherort speichern möchten. Sie können Chat-Dateien, Faxe, Aufzeichnungen, Sprachnachrichten und Backups nach Bedarf remote speichern.

Google Speech zur Transkription

Wenn relevante Berechtigungen ausgewählt sind, können Sie die Google Speech-Transkription mithilfe der durch den Integrationsprozess automatisch erstellten Google-Konfiguration aktivieren.

Sobald die Google-Integration und der Speicher in 3CX konfiguriert sind, gehen Sie zu Admin-Konsole > Integrationen > Transkription und aktivieren Sie die Google Speech-Transkription für Ihre bevorzugte Sprache.

Verwenden Sie Google Workspace zum Senden von E-Mails

Wenn Sie während des Integrationsprozesses die entsprechenden Rechte gewähren, konfiguriert 3CX Ihre System-E-Mail-Einstellungen automatisch so, dass das integrierte Google Workspace-Konto zum Senden von System-E-Mails verwendet wird.

Google ReCaptcha

Sobald die Google-Integration über die entsprechende Berechtigung verfügt, können Sie Google reCAPTCHA in der Admin-Konsole > Integrationen > Google aktivieren, um 3CX vor automatisierten Angriffen und Missbrauch zu schützen.

Technische Informationen und FAQ

Echtzeit vs. tägliche Synchronisierung

Die folgenden Daten werden in Echtzeit mit Änderungen bei Google synchronisiert:

• Vorname des Nutzers
• Nachname des Nutzers
• Foto des Nutzers
• Geschäftstelefon des Nutzers
• Neuer im Workspace erstellter Nutzer
• Nutzer im Workspace sperren/löschen > Deaktiviert 3CX-Nebenstelle
• Sperrung des Nutzers im Workspace aufheben > Aktiviert 3CX-Nebenstelle
• Kalendertermine

Die restlichen Daten, bei denen wir nicht auf Live-Änderungen lauschen, werden von der Telefonanlage einmal täglich synchronisiert. Die tägliche Synchronisierung wird durch den Parameter GW_SYNC_TIME gesteuert. Er speichert die Uhrzeit des Tages im 24-Stunden-Format: HH:MM:SS, zu der die Telefonanlage alle Daten erneut von Google synchronisiert.

Kalender-Synchronisierungsstatus

Das Erstellen eines Eintrags im Google Kalender synchronisiert die Präsenz des Nutzers wie folgt:

• Termin > DND
• Abwesend > Abwesend
• Fokuszeit > DND

Synchronisierung von Benutzer- und Kontaktdaten

Für synchronisierte Nutzer synchronisieren wir die folgenden Informationen von Google:

• Vorname
• Nachname
• E-Mail
• Telefon (Geschäftlich) zu Mobiltelefon des Nutzers in 3CX
• Foto

Für synchronisierte Kontakte synchronisieren wir die folgenden Informationen von Google:

• Vorname
• Nachname
• Foto
• Firma
• Titel
• Mobiltelefon
• Mobiltelefon 2
• Privat
• Geschäftlich
• Geschäftlich 2
• E-Mail
  

Um diese Kontaktinformationen ordnungsgemäß zu synchronisieren, müssen Sie sie in Google Kontakte taggen, wie im folgenden Screenshot gezeigt.

Vorhandene Google Storage-Konfiguration

Falls Sie Google Storage bereits aktiviert haben, wird Sie der Assistent während des Integrationsprozesses darüber informieren und die Konfiguration nicht für Sie überschreiben.

Einschränkungen und bekannte Probleme

• Unternehmenskontakte existieren nicht
• Gmail hat eine maximale Anhangsgröße von 25 MB pro Nachricht
• Es gibt keine Möglichkeit, auf Änderungen bei persönlichen Kontakten zu lauschen
• Das Erstellen von Kontakten aus dem Webclient nach Google wird in einer zukünftigen Version verfügbar sein

Siehe auch

• Konfigurieren von Google SSO Single Sign-On
• So integrieren Sie Ihre Telefonanlage in Microsoft 365 | 3CX 

Letztes Update
Dieses Dokument wurde zuletzt am 18. September 2026 aktualisiert.
https://www.3cx.de/docs/adminhandbuch/google-workspace/