Integration von 3CX mit Office 365 über die Azure API

Die 3CX-Telefonanlage der Editionen Pro und Enterprise bietet eine umfassende Integration mit den Anwendungen von Office 365. Besonders umgesetzt ist:

  • Die Synchronisation der Office 365-Benutzer und der Nebenstellen (Benutzer) von 3CX.
  • Die Synchronisation der persönlichen Kontakte der Office-Benutzer und des persönlichen Adressbuchs von 3CX.
  • Die Synchronisation der Status (Verfügbarkeit) des Kalenders des Office 365-Benutzers und des Status der Nebenstelle von 3CX.   

Um aus den Webanwendungen von Office aus Anrufe zu initiieren, verwendet 3CX die Erweiterung 3CX Click to Call für Browser Chrome und Firefox. Es können auch Tastenkombinationen in der 3CX-Anwendung für Windows.

verwendet werden. Um zu beginnen, benötigen Sie ein Abonnement für Office 3CX und die Anmeldedaten des Administrators des Office-Portals mit den Rechten „Global Administrator“.

Einige Office 365-Abonnements bieten eingeschränkte Integrationsmöglichkeiten mit 3CX oder gar keine:

  • Abonnements ohne Benutzerverwaltung, d.h. alle „Home“-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 Echtzeit-Statusübertragungen zu ermöglichen. Auch wenn eine ständige Verbindung nicht möglich ist, wird 3CX täglich Synchronisierungen durchführen.

Bitte beachten Sie, dass die Synchronisierung nur in eine Richtung erfolgt — von Office 365 zu 3CX. Damit die Synchronisierung erfolgreich ist, müssen Benutzer von Office 365 das Attribut „UserType“ auf „Member“ setzen (dies erfolgt in Active Directory). Wenn ein aus Office 365 synchronisierter Benutzer über die 3CX-Oberfläche gelöscht oder geändert wird, wird er bei der nächsten manuellen oder automatischen Synchronisierung in den vorherigen Zustand zurückgesetzt.

Microsoft Azure Authentifizierungsanwendung

Integration von 3CX mit Office 365 über die Azure API

Erster Schritt zur Verbindung Office 365-Integration — erstellen Sie eine individuelle Anwendung in Ihrem Konto zur Autorisierung der Integration.

  1. Gehen Sie im 3CX-Verwaltungsinterface zu den Optionen — Office 365 — Registerkarte Optionen — Abschnitt Schritt 3 und kopieren Sie die Redirect-URL.
  2. Melden Sie sich mit den Anmeldedaten des Global Administrators im Office 365-Portal an und gehen Sie zur Seite App-Registrierungen von Microsoft Azure.
  3. Klicken Sie auf Neue Registrierung und geben Sie den Namen der Anwendung an, z. B. 3CX PBX Office 365 Sync App.
  4. Lassen Sie im Abschnitt Unterstützte Kontotypen die Standardeinstellung für Konten nur in diesem Katalog der Organisation aktiviert.
  5. Geben Sie im Abschnitt Weiterleitungs-URI (optional) den Typ Web an und fügen Sie den Weiterleitungs-URI aus dem 3CX-Interface ein: Einstellungen > Integration mit Office 365 > Registerkarte Einstellungen > Abschnitt Schritt 3. Plattform und Berechtigungen, zum Beispiel: company.3cx.eu:5001/oauth2office2
  6. Klicken Sie auf Registrieren, und die Anwendung wird erstellt.
  7. Die Seite mit den Einstellungen der erstellten Anwendung öffnet sich. Kopieren Sie den Wert der Anwendungs-ID (Client) und fügen Sie ihn in das entsprechende Feld im 3CX-Verwaltungsinterface ein, Einstellungen > Integration mit Office 365 > Registerkarte Einstellungen > Schritt 1. App-ID konfigurieren.

Integration von 3CX mit Office 365 über die Azure API

Authentifizierungsschlüssel

Jetzt müssen Sie eine vertrauensvolle Beziehung mit dem öffentlichen Schlüssel zwischen Ihrem 3CX v16-System und der erstellten Anwendung im Office 365-Portal einrichten.

  1. Im 3CX-Interface (Abschnitt Einstellungen > Integration mit Office 365 > Registerkarte Einstellungen) klicken Sie auf Neue Schlüsselpaar generieren und speichern Sie den Schlüssel public_key.pem.
  2. Navigieren Sie zur Seite der Anwendungsparameter im Abschnitt Zertifikate und Geheimnisse. Klicken Sie auf Zertifikat hochladen und laden Sie den erstellten Schlüssel hoch.

Integration von 3CX mit Office 365 über die Azure API
Integration von 3CX mit Office 365 über die Azure API

Berechtigungen für die Anwendung

Der letzte Schritt der Einrichtung besteht darin, die API-Berechtigungen im Abschnitt API-Berechtigungen festzulegen. Diese Berechtigungen bestimmen die Zugriffsrechte Ihres 3CX-Systems auf das Office 365-Konto.

  1. Gehen Sie zum Abschnitt API-Berechtigungen, klicken Sie auf Berechtigung hinzufügen und wählen Sie Microsoft Graph aus.
  2. Fügen Sie im Abschnitt Berechtigungen der Anwendung die API-Berechtigungen hinzu: Kalender > Calendars.Read, Kontakte > Contacts.Read, Verzeichnis > Directory.Read.All und klicken Sie auf Berechtigungen hinzufügen.
  3. Im Abschnitt Zustimmung erteilen klicken Sie auf Zustimmung des Administrators für …, um die Berechtigungen zu aktivieren.
  4. Warten Sie etwa 10 Minuten, bis die Änderungen wirksam werden.
  5. Wechseln Sie zur 3CX-Oberfläche und klicken Sie im Abschnitt Integration mit Office 365 auf In Office 365 anmelden. Bestätigen Sie die Berechtigungen für die erstellte Anwendung, und die Verbindung zwischen den Systemen wird hergestellt.

Integration von 3CX mit Office 365 über die Azure API

Synchronisierungsfunktionen

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

  • Benutzersynchronisierung – Benutzer von Office 365 werden mit Benutzern (Durchwahlnummern) von 3CX synchronisiert. Im 3CX-Management-Interface sind die synchronisierten Benutzer in der Azure AD-Organisationsgruppe platziert.
  • Kontaktsynchronisierung – Persönliche Kontakte von Office 365 werden mit dem Adressbuch von 3CX synchronisiert. Der Benutzer sieht diese Kontakte in den 3CX-Anwendungen auf allen Plattformen.
  • Kalendersynchronisierung – automatische Änderung des Status der Durchwahlnummer von 3CX gemäß der Verfügbarkeit im Kalender von Office 365:

Nach Abschluss eines Termins im Kalender von Office 365 wird der Status des 3CX-Benutzers ebenfalls synchronisiert und kehrt in den vorherigen Zustand zurück.

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

Integration von 3CX mit Office 365 über die Azure API

Damit ist die Integration abgeschlossen.

Quelle: habr.com

Kaufen Sie zuverlässiges Hosting für Websites mit DDoS-Schutz, VPS VDS-Server 🔥 Kaufen Sie zuverlässiges Hosting für Websites mit DDoS-Schutz, VPS VDS-Server | ProHoster