TeamsConnect für STARFACE

Sie sind hier:
Inhalt

Beschreibung

Mit der Erweiterung „TeamsConnect“ integrieren Sie Ihre STARFACE Telefonanlage in Ihre Microsoft Teams Umgebung. Die Erweiterung setzt Ihre Mitarbeiter in der STARFACE automatisiert auf „Nicht stören / Do not Disturb“, sodass diese während eines Teams Telefonats nicht parallel angerufen werden können. Zudem wird der aktuelle Status in Teams in den STARFACE Chat-Status übertragen. 

Voraussetzung

Zur Verwendung dieser STARFACE Erweiterung muss eine Microsoft Graph API eingerichtet werden, hierzu ist mindestens eine „Microsoft 365 Business Basic“-Lizenz erforderlich.

Anwendung

Die STARFACE Erweiterung „TeamsConnect“ ist so entwickelt, dass Microsoft Teams zum führenden System wird. Das Modul setzt je nach Konfiguration bei bestimmten Status in Microsoft Teams den Benutzer in der STARFACE auf „Nicht stören / Do not Disturb“ und überschreibt den Chat-Status. 

Beispiel: Tätigt man einen Anruf in Microsoft Teams wird der Status automatisch auf „Beschäftigt – Am Telefon“ gesetzt. Dies führt dazu, dass der Benutzer (je nach Konfiguration) in der STARFACE auf Nicht stören / Do not Disturb gesetzt wird und der Chat-Status auf „On a call in MS Teams“ gesetzt wird.

Verfügbare Plattformen:
Kompatibel mit STARFACE Appliance Kompatibel mit STARFACE VM-Edition Kompatibel mit STARFACE Cloud

Vorbereitung Microsoft Teams

Zur Verwendung dieser STARFACE Erweiterung muss eine Microsoft Graph API eingerichtet werden. Hierzu loggen Sie sich bitte ins Microsoft Azure Active Directory Portal ein.

Teams Connect - Anwendung in Microsoft Azure Active Directory Portal registrieren
Teams Connect – Anwendung in Microsoft Azure Active Directory Portal registrieren
Teams Connect - Berechtigung zur Anwendung hinzufügen
Teams Connect – Berechtigung zur Anwendung hinzufügen

Anwendung in Microsoft Azure Active Directory Portal registrieren

Wechseln Sie bitte zum Punkt „App-Registrierung“. Im oberen Bereich finden Sie den Button „Neue Registrierung“, hiermit registrieren Sie eine neue Anwendung. Sie können einen beliebigen Namen für die Anwendung vergeben, in diesem Beispiel „MSTeamsConnect“. Wählen Sie unter dem Punkt „Unterstützte Kontotypen“ den ersten Punkt: „Nur Konten in diesem Organisationsverzeichnis (nur „AD-Bezeichnung“ – einzelner Mandant)“. Belassen Sie den Punkt „Umleitung-URI“ bei den voreingestellten Werten.

Berechtigung zur Anwendung hinzufügen

Nachdem Sie die Anwendung registriert haben, werden Sie zur Übersicht der Anwendung weitergeleitet. Auf der linken Seite finden Sie den Punkt „API-Berechtigung“. Über den Button „Berechtigung hinzufügen“ lassen sich neue Rechte der Anwendung hinzufügen. Folgende Rechte aus der Microsoft Graph API werden benötigt: 

Delegierte Berechtigungen:

  • Presence.Read.All
  • User.Read.All

Das vorausgewählte Recht „User.Read“ wird nicht benötigt und kann gelöscht werden.

Nachdem Sie die erforderlichen Rechte hinzugefügt haben, ist eine Administratorzustimmung erforderlich. Hierzu finden Sie im oberen Bereich einen Button „Administratorzustimmung für „AD-Bezeichnung“ erteilen“. Die API-Berechtigungs- übersicht sollte nun wie im Screenshot Teams Connect – Berechtigung zur Anwendung hinzufügen aussehen.

Abschließend wechseln Sie in den Bereich „Authentifizierung“ und stellen den „Standardclienttyp“ auf „Ja“. Speichern Sie die Konfiguration. In der Übersicht der Anwendung finden Sie nun alle erforderlichen Informationen für die Konfiguration der Erweiterung auf der STARFACE. 

Vorbereitung in Microsoft Teams mit Multi-Faktor-Authentifizierung

In manchen Umgebungen ist der „Silent Login“, wie oben beschrieben, als Authentifizierung nicht ausreichend (zum Beispiel bei Multi-Faktor-Authentifizierung). Ist dies der Fall, so sind die oben genannten Schritte sowie zusätzlich die folgenden Schritte durchzuführen.

Teams Connect - Erweiterte Berechtigung zur Anwendung hinzufügen
Teams Connect – Erweiterte Berechtigung zur Anwendung hinzufügen
Teams Connect – Umleitungs-URI zur Anwendung hinzufügen

Zusätzliche API-Berechtigungen

Sie müssen weitere Berechtigungen zu Ihrer Anwendung hinzufügen. In der Übersicht Ihrer Anwendung finden Sie auf der linken Seite den Punkt „API-Berechtigung“. Über den Button „Berechtigung hinzufügen“ lassen sich neue Rechte der Anwendung hinzufügen. Folgende Rechte aus der Microsoft Graph API werden zusätzlich benötigt:

  • openid
  • offline_access
  • People.Read.All

Umleitungs-URI hinzufügen

Wechseln Sie in der Übersicht Ihrer Anwendung zum Punkt „Authentifizierung“. Über den Button „Plattform hinzufügen“ können Sie eine neue Umleitungs-URL hinzufügen. Wählen Sie anschließend „Mobilgerät- und Desktopanwendungen“ als Plattform aus. Anschließend wählen Sie bitte die folgende Umleitungs-URL aus:

https://login.microsoftonline.com/common/oauth2/nativeclient

Speichern Sie die Einstellungen.


Konfiguration des STARFACEModuls

TeamsConnect - Authentifikation
TeamsConnect – Authentifikation

Allgemeine Konfiguration / Authentifikation

Benutzerauswahl

Geben Sie an, ob alle STARFACE Benutzer von der Microsoft Teams Integration berücksichtigt werden. Alternativ können Sie eine Auswahlgruppe definieren. Nur Mitglieder dieser Gruppe werden dann von der Microsoft Teams Integration berücksichtigt. 

Zugangsdaten

Client_id: Geben Sie die Anwendungs-ID (Client) der erstellten Anwendung im Microsoft Azure Active Directory Portal an. Diese finden Sie in der Übersicht der Anwendung.

Nutzer / Passwort: Geben Sie den Nutzernamen / Passwort eines Benutzers Ihrer Organisation an. Es empfiehlt sich einen gesonderten Service-User hierfür einzurichten.

Microsoft Teams mit Multi-Faktor Authentifizierung

Sollte der „Silent Login“ in Ihrer Umgebung nicht ausreichend sein, aktivieren Sie die „Device Code“ Authentifikation und geben Sie zusätzlich die Verzeichnis_id an, diese finden Sie in der Übersicht Ihrer Anwendung im Microsoft Azure Active Directory Portal. Der Benutzer, den Sie zur Authentifizierung angegeben haben, erhält eine E-Mail mit allen weiteren Schritten.

Benutzerstatus

TeamsConnect – Benutzerstatus

Präsenzstatus

Setze Chat-Status: Hier können Sie einstellen, ob der Chat-Status in der STARFACE gesetzt werden soll. Der Chat-Status kann hierdurch nicht mehr im STARFACE UCC Client manuell gesetzt werden. Folgend kann noch der Statustext frei konfiguriert werden.

Do not Disturb

Hier können Sie definieren, ob Benutzer in der STARFACE auf „Nicht stören / Do not Disturb“ gesetzt werden sollen und bei welchem Microsoft Teams Status. Der Präsenzstatus wird in Microsoft Teams aufgeteilt: „Availability“ und „Activity“, wobei die „Activity“ die „Availability“ näher umschreibt. Mehr zu den Status in Microsoft Teams finden Sie unter: https://docs.microsoft.com/de-de/microsoftteams/presence-admins. Die diversen Status aus Microsoft Teams sind im Modul zusammengefasst, welche folgende Tabelle erläutert:

Status-Übersicht: TeamsConnect

Bezeichnung in STARFACE Erweiterung Microsoft Teams Availability (Benutzerdefiniert) Microsoft Teams Activity (Durch die App konfiguriert)
Im Gespräch Beschäftigt Am Telefon
Nicht stören Hält Präsentation
Beschäftigt Beschäftigt Jede Activity
Nicht stören Nicht stören Jede Activity
Abwesend Abwesend Jede Activity
Abgemeldet Offline
Status unbekannt

Versionen

VERSIONKOMPATIBILITÄTDOWNLOADCHANGELOG
v54STARFACE 6.7.1TeamsConnect_v54.sfmErste Version
v56STARFACE 6.7.1TeamsConnect_v56.sfmBugfix
– Verbesserung STARFACE-Cloud-Kompatibilität
– Anpassung Modul-Text
v66STARFACE 6.7.1TeamsConnect_v66.sfmFeatures
– Statusnachrichten konfigurierbar gemacht
– Logging bei Fehlern in der Benutzerzuordnung verbessert
v67STARFACE 6.7.1TeamsConnect_v67.sfmBugfix
– Unterstützung für mehr als 100 Teams-User zugefügt
– Bei Teams Status „Busy“ wird jetzt auch DnD gesetzt
v68STARFACE 6.7.1 – 6.7.2TeamsConnect_v68.sfmFeatures
– Anzeige des Teams-TelefonieStatus auf den BLF-Tasten
v70STARFACE 6.7.1 – 6.7.3TeamsConnect_v70.sfmFeatures
– Englische Übersetzung hinzugefügt
Bugfix
– Verbesserung im Lizenzsystem
v83STARFACE 6.7.1 – 6.7.3TeamsConnect_v83.sfmFeatures
– Alternative Authentifikation hinzugefügt (DeviceCodeFlow)
Bugfix
– Verbesserung im Lizenzsystem
– GUI Anpassungen