3CX-Integration mit Office 365 über Azure API

Die Editionen PBX 3CX v16 Pro und Enterprise bieten eine vollständige Integration mit Office 365-Anwendungen. Insbesondere ist Folgendes implementiert:

• Synchronisierung von Office 365-Benutzern und 3CX-Erweiterungen (Benutzern).
• Synchronisierung der persönlichen Kontakte von Office-Benutzern und des persönlichen Adressbuchs von 3CX.
• Synchronisierung des Status des Office 365-Benutzerkalenders (beschäftigt) und des Status der 3CX-Nebenstellennummer.   

Um ausgehende Anrufe über die Weboberfläche von Office-Anwendungen zu tätigen, nutzt 3CX die Erweiterung 3CX Click to Call für Browser Chrome и Firefox. Sie können auch Tastaturkürzel verwenden 3CX-Anwendung für Windows.

Um zu beginnen, benötigen Sie ein Office 3CX-Abonnement und Administratoranmeldeinformationen für das Office-Portal mit der Berechtigung „Globaler Administrator“.

Einige Office 365-Abonnements verfügen über eine eingeschränkte oder keine Integration mit 3CX:

• Abonnements ohne Benutzerverwaltung, d.h. alle „Heim“-Abonnements.
• Abonnements ohne Exchange können keine Kontakte und Kalender synchronisieren (Office 365 Business und Office 365 Pro Plus).

Office 365-Server müssen eine direkte Verbindung zu Ihrem 3CX-Server haben, um Echtzeitstatus zu übertragen. Wenn eine dauerhafte Verbindung nicht möglich ist, führt 3CX dennoch eine tägliche Synchronisierung durch.

Bitte beachten Sie, dass die Synchronisierung nur in eine Richtung erfolgt – von Office 365 zu 3CX. Für eine erfolgreiche Synchronisierung muss bei Office 365-Benutzern das Attribut „UserType“ auf „Mitglied“ gesetzt sein (in Active Directory festgelegt). Wenn ein aus Office 365 synchronisierter Benutzer über die 3CX-Schnittstelle gelöscht oder geändert wird, wird er bei der nächsten manuellen oder automatischen Synchronisierung auf den vorherigen Status zurückgesetzt.

Microsoft Azure-Authentifizierungsanwendung

Erster Verbindungsschritt Office 365-Integration — Erstellung eines individuellen Antrags in Ihrem Konto zur Autorisierung der Integration.

1. Gehen Sie in der 3CX-Verwaltungsoberfläche zu Einstellungen – Office 365 – Registerkarte „Einstellungen“ – Abschnitt Schritt 3 und kopieren Sie die Umleitungs-URL.
2. Melden Sie sich mit Ihren Anmeldeinformationen als globaler Administrator beim Office 365-Portal an und gehen Sie zu Registrierungen von Microsoft Azure-Anwendungen.
3. Klicken Sie auf Neue Registrierung und geben Sie den Anwendungsnamen an, zum Beispiel 3CX PBX Office 365 Sync App.
4. Behalten Sie im Abschnitt „Unterstützte Kontotypen“ die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ bei
5. Wählen Sie im Abschnitt „Umleitungs-URI“ (optional) den Typ „Web“ aus und fügen Sie den Umleitungs-URI aus dem Abschnitt „3CX-Schnittstelle“ ein: Einstellungen > Office 365-Integration > Registerkarte „Einstellungen“ > Schritt 3. Abschnitt „Plattform und Berechtigungen“, z. B. unternehmen.3cx.eu:5001/oauth2office2
6. Klicken Sie auf Registrieren und die Anwendung wird erstellt.
7. Die Einstellungsseite für die erstellte Anwendung wird geöffnet. Kopieren Sie den Wert der App-ID (Client) und fügen Sie ihn aus dem entsprechenden Feld in der 3CX-Verwaltungsoberfläche ein: Einstellungen > Office 365-Integration > Registerkarte „Optionen“ > Schritt 1. Konfigurieren Sie die App-ID.

Authentifizierungsschlüssel

Jetzt müssen Sie eine öffentliche Schlüsselvertrauensstellung zwischen Ihrem 3CX v16-System und der erstellten Anwendung im Office 365-Portal herstellen.

1. Klicken Sie in der 3CX-Benutzeroberfläche (Einstellungen > Office 365-Integration > Registerkarte „Optionen“) auf „Neues Schlüsselpaar generieren“ und speichern Sie den Schlüssel „public_key.pem“.
2. Gehen Sie zur Seite mit den Anwendungseinstellungen im Abschnitt „Zertifikate und Geheimnisse“. Klicken Sie auf Zertifikat hochladen und laden Sie den generierten Schlüssel hoch.

Anwendungsberechtigungen

Der letzte Einrichtungsschritt besteht darin, API-Berechtigungen im Abschnitt „API-Berechtigungen“ festzulegen. Diese Berechtigungen bestimmen, wie Ihr 3CX-System auf Ihr Office 365-Konto zugreifen kann.

1. Gehen Sie zu API-Berechtigungen, klicken Sie auf Berechtigung hinzufügen und wählen Sie Microsoft Graph aus.
2. Fügen Sie API-Berechtigungen unter Anwendungsberechtigungen hinzu: Kalender > Calendars.Read, Kontakte > Contacts.Read, Verzeichnis > Directory.Read.All und klicken Sie auf Berechtigungen hinzufügen.
3. Klicken Sie im Abschnitt „Einwilligung erteilen“ auf „Administratoreinwilligung erteilen für...“, um Berechtigungen zu aktivieren.
4. Warten Sie etwa 10 Minuten, bis die Änderungen ordnungsgemäß wirksam werden.
5. Wechseln Sie zur 3CX-Schnittstelle und klicken Sie im Abschnitt „Integration mit Office 365“ auf „Bei Office 365 anmelden“. Bestätigen Sie die Berechtigungen für die erstellte Anwendung und die Verbindung zwischen den Systemen wird hergestellt.

Synchronisierungsfunktionen

Die Synchronisierung zwischen 3CX und Office 365 wird auf drei Registerkarten konfiguriert:

• Benutzersynchronisierung – Office 365-Benutzer werden mit 3CX-Benutzern (Erweiterungen) synchronisiert. In der 3CX-Verwaltungsoberfläche werden synchronisierte Benutzer in der Azure AD-Organisationsgruppe platziert.
• Synchronisierung von Kontakten – Persönliche Kontakte von Office 365 werden mit dem 3CX-Adressbuch synchronisiert. Der Benutzer sieht diese Kontakte in 3CX-Anwendungen für alle Plattformen.
• Kalendersynchronisierung – ändert automatisch den Status einer 3CX-Nebenstelle, je nachdem, ob sie im Office 365-Kalender belegt ist:

Nachdem ein Ereignis im Office 365-Kalender abgeschlossen ist, wird auch der 3CX-Benutzerstatus synchronisiert und auf den vorherigen Status zurückgesetzt.

Alle Synchronisierungselemente können sowohl für alle Office 365-Benutzer als auch für ausgewählte Benutzer konfiguriert werden.

Damit ist die Integration abgeschlossen.

Source: habr.com