Dieser Artikel beschreibt die Konfiguration für den Connector für die Microsoft365-Funktionalität. Zur Vorbereitung müssen Sie zunächst eine Anwendung in Ihrem Azure-Portal konfigurieren. Anschließend nehmen Sie die Konfiguration in der App des myApps Clients vor.

• Lizenzen für innovaphone Connector für Microsoft 365 pro Benutzer, der den innovaphone myApps Connector für Microsoft 365 nutzen möchte.
• Konto im Azure-Portal von Microsoft (für jeden der technischen Kommunikationsbenutzer, keine Berechtigungsrolle erforderlich)
• Administratorkonto für das Azure-Portal (nur erforderlich, um während der Einrichtung die erforderlichen Berechtigungen für die registrierte App zu erteilen).

Wenn der Connector für Microsoft 365-App vollständig konfiguriert ist, verbindet sich die App mit Microsoft, um ein Token zu erhalten. Mit dem Token ruft die App die Teams-Benutzer (mit einer Teams-Lizenz) über die Microsoft Graph API ab. Ein Präsenzabonnement bei Microsoft wird mit den lizenzierten Benutzern der Telefonanlage gestartet, um Präsenzänderungen in Microsoft Teams für diese Benutzer zu erhalten. Außerdem wird ein Benutzerabonnement gestartet, um Änderungen der Benutzer (Hinzufügen, Löschen oder Aktualisieren) abzurufen. Wenn sich ein Benutzer geändert hat, werden die Teams-Benutzer erneut abgerufen. Wenn sich die Anwesenheit geändert hat, wird sie an die Telefonanlage weitergeleitet. Die Anwesenheiten von Teams werden den Anwesenheiten der Telefonanlage zugeordnet.

• Benutzerabonnements werden alle 60 Minuten erneuert.
• Anwesenheitsabonnements werden alle 10 Minuten erneuert.
• Die Lizenzprüfung wird regelmäßig durchgeführt.

Die App synchronisiert die PBX-Präsenz über die Graph-API mit Teams. Die Präsenz am Telefon wird alle 5 Minuten erneuert. Die anderen Präsenzen haben eine Lebensdauer von 1 Tag, die Abwesenheit jedoch eine Lebensdauer von 7 Tagen. Die Lebensdauern sind hier beschrieben

Bitte beachten Sie: Die tatsächliche Änderung des Präsenz- oder Leitungsstatus erfolgt live, die oben genannten Abonnements sind erforderlich, um Änderungen bei der Microsoft-API zu registrieren. Nach erfolgreichem Abonnement löst Microsoft jedes Mal, wenn sich der Präsenz- oder Leitungsstatus eines Benutzers ändert, den Connector für die Microsoft 365-App aus. Das Abonnement wird dann in dem oben genannten Zeitintervall erneuert, um weitere Live-Updates zu erhalten.

Sie können nun die Felder, die für den Benutzerabgleich auf beiden Seiten verwendet werden, aus den folgenden Optionen auswählen:

PBX

• CN (Long Name property from the PBX user object)
• h323 (Name property from the PBX user object)

Azure Portal

• displayName
• mail
• mailNickname
• onPremisesDistinguishedName
• onPremisesSamAccountName
• onPremisesUserPrincipalName
• userPrincipalName

Der Wert „online“ hebt die Teams-Präsenz in der Telefonanlage auf.

Erstellen Sie eine App zum Synchronisieren von Kalenderereignissen aus Teams mit der Telefonanlage

• Im Azure-Portal von Microsoft müssen Sie eine App-Registrierung hinzufügen
• Sie müssen lediglich einen Namen für die App vergeben

• Wechseln Sie zur Authentifizierung auf der linken Seite
• Sie müssen nur den öffentlichen Client-Flow zulassen konfigurieren

• Wechseln Sie links zu den API-Berechtigungen.
• Sie müssen die Anwendungsberechtigungen (Calendars.Read) und (User.Read.All) wie in der Abbildung gezeigt konfigurieren.
• Erteilen Sie Zugriff auf die API-Berechtigungen. Ist dies nicht möglich, müssen Sie einen Administrator fragen.

Mit diesen Konfigurationen können Sie den Connector für Microsoft365 konfigurieren

• Client-ID wie in der Abbildung gezeigt
• Mandanten-ID wie in der Abbildung gezeigt
• Benutzer
• Passwort

Erstellen Sie eine App für die Synchronisierung von PBX mit Teams

• Im Azure-Portal von Microsoft müssen Sie eine neue App-Registrierung hinzufügen
• Auf dem Bild sehen Sie, dass wir danach zwei Werte haben, die wir für die Konfiguration der App verwenden können

• Wechseln Sie links zu „Zertifikate und Geheimnisse“.
• Sie müssen lediglich ein Client-Geheimnis konfigurieren und den Wert für die Konfiguration der App speichern.

• Wechseln Sie links zu den API-Berechtigungen.
• Sie müssen die Anwendungsberechtigung (Presence.ReadWrite.All) wie in der Abbildung gezeigt konfigurieren.
• Erteilen Sie Zugriff auf die API-Berechtigungen. Ist dies nicht möglich, müssen Sie einen Administrator fragen.

Synchronisierung von Teams zu PBX

Für die Kalendersynchronisierung wählen Sie in der Admin-App „Teams zu PBX für Kalenderpräsenz” aus.

• ClientIDCalendar – Bitte geben Sie die Anwendungs-ID (Client-ID) aus dem Azure-Portal aus der in Vorbereitung befindlichen Kalender-App ein.
• TenantCalendar – Bitte geben Sie die Verzeichnis-ID (Tenant) aus dem Azure-Portal aus der in Vorbereitung befindlichen Kalender-App ein.
• ClientSecretCalendar – Bitte geben Sie das gemeinsame Geheimnis aus der in Vorbereitung befindlichen Kalender-App ein.
• NotificationURLCalendar – Sie müssen die Adresse angeben, an die Microsoft Präsenzaktualisierungen senden kann.
  • Sie müssen sicherstellen, dass Sie eine URL definieren, über die Sie Ihre App-Plattform über das öffentliche Internet erreichen können: public.dns
  • Als Nächstes benötigen Sie die Domäne, die Sie zuvor in der App-Instanz konfiguriert haben (3.2.2) your.domain
  • Als Nächstes benötigen Sie den Namen der Instanz, die Sie zuvor konfiguriert haben (3.2.2) microsoft365
  • Die URL endet immer mit „subscriptions“
    • https://public.dns/your.domain/microsoft365/subscriptions

From Teams to PBX

• Master PBX = slave-AnlagenID (bspw. slave-12000)
• ClientIDSynctoPbx
• TenantSynctoPBX
• Notification URL = https://app08.prod01.s-proxy.cloud/AnlagenID.prod01.s-proxy.cloud/m365-AnlagenID/subscriptions (bspw. 12000)
• PBX-Field = h323 (Name) ←- empfohlen
• Azure-Field = Je nach Konfiguration im Azure
• Cut Domain = optional
• Disable Presence Synchronisation to PBX = optional
• Disable Line Status Synchronisation to PBX = optional

Manage Teams accounts

• Lizensierter Teams Account zur Abfrage der Nutzerdaten
• Es können max. 650 Nutzer pro Teams Account abgefragt werden

From PBX to Teams

• ClientIDSynctoTeams
• TenantSynctoTeams
• Disable Presence Synchronisation to Teams = optional
• Disable Line Status Synchronisation to Teams = optional