TeamsConnect für STARFACE

Sie sind hier:

Was kann das Modul?

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. Mit dem Update auf die STARFACE 7 unterstützt TeamsConnect das Setzen des DND-Status in Microsoft Teams, wenn in der STARFACE gesprochen wird. Somit findet der Statusabgleich in beide Richtungen statt.

Technische Voraussetzung

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

Verfügbare Plattformen:

  • – Appliance
  • – VM
  • – Cloud


Exkurs zum Präsenzstatus von Microsoft Teams

Wie setzt Microsoft Teams den Präsenzstatus zusammen?

Der Präsenzstatus von Microsoft Teams sich aus den folgenden drei Quellen zusammen:

  1. Manueller Status in Microsoft Teams
  2. Terminstatus des Outlook-Kalenders
  3. Anrufstatus bei Microsoft Teams

Zu 1:

Der Manuelle Status (Quelle 1) in Microsoft Teams überschreibt immer die beiden anderen Status.

Manueller Status in Microsoft Teams

Zu 2:

Wenn kein Manueller Status gesetzt ist („Status zurücksetzen“, siehe Bild 1), dann wird der Terminstatus des Outlook-Kalenders (Quelle 2) übernommen.

Termin erstellen in Outlook für Windows
Termin erstellen in Outlook für Mac

Zu 3:

Wenn kein manueller Status gesetzt wurde auch der Outlook-Kalender keinen Status aus einem Termin vorgibt, dann greift der Anrufstatus bei Microsoft Teams.

Zusammenfassend:

Damit der Anrufstatus bei Microsoft Teams als Präsenzstatus angezeigt, darf kein manueller Status gesetzt werden und Termine im Outlook-Kalender müssen mit „Anzeigen als frei“ angelegt werden!

Wie setzt TeamsConnect den Status in der STARFACE?

Unser Modul TeamsConnect liest den zusammengesetzten Präsenzstatus von Microsoft Teams aus und setzt diesen, je nach Konfiguration, in der STARFACE.

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.


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 (bis Version 2.1)
Teams Connect – Berechtigung zur Anwendung hinzufügen (ab Version 2.1)

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: 

Es gibt delegierte Berechtigungen und Anwendungsberechtigungen. Folgende Rechte werden benötigt.

Bis Version 2.1:

Delegierte Berechtigungen:

  1. openid
  2. offline_access
  3. User.Read.All
  4. Presence.Read.All

Ab Version 2.1:

  1. Delegiert:
    1. openid
    2. offline_access
    3. Presence.Read.All
  2. Anwendung:
    1. User.Read.All
    2. Presence.ReadWrite.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.

Bis Version 2.1

Die Multi-Faktor Authentifizierung läuft hier über einen Microsoft Azure User (Service User, siehe unten), der über seine E-Mailadresse die Authentifizierung bestätigt.

Ab Version 2.1

Ab Version 2.1 muss ein Secret für die Anwendung erzeugt werden. Dieser Wert muss in der Modulkonfiguration eingetragen werden:

Unter dem Menüpunkt Zertifikate & Geheimnisse klicken Sie auf „+ Neuer geheimer Clientschlüssel“ und legen einen neuen Authentifizierungsschlüssel für die Anwendung an.

Das Secret ist max. 2 Jahre gültig und muss dann neu erzeugt werden.

Teams Connect – Umleitungs-URI zur Anwendung hinzufügen

Umleitungs-URL 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.

Aktivieren Sie hier hie Option für die Öffentlichen Clientflows in dem Sie den Regler auf Ja stellen


Konfiguration des STARFACE Moduls

TeamsConnect – Allgemeine Konfiguration

TeamsConnect – Benutzerstatus
TeamsConnect – Benutzerstatus

TeamsConnect – Authentifikation bis Version 2.1

Allgemeine Konfiguration

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.  Benutzer der Gruppe dürfen nicht die gleiche E-Mailadresse verwenden (Bsp.: info@…). Da die Benutzer über ihre E-Mailadresse verifiziert werden, müssen die STARFACE User die entsprechende E-Mailadresse des jeweiligen Users im Azure AD hinterlegt haben.

Ab Modul-Version 2.3:

Zusätzlich zur gruppenbasierten Auswahl der User können Sie über die Auswahlliste Login-Ids von Benutzern angeben, die ebenfalls die TeamsConnect Funktionen nutzen sollen.

Benutzerstatus

Teams-Präsenzstatus

Hier können Sie einstellen, ob der Chatstatus in Teams gesetzt werden soll. Dies sorgt bei einem aktiven Gespräch in der STARFACE, dass Sie nicht durch einen parallelen Teamscall gestört werden können.

STARFACE-Präsenzstatus

Der Präsenzstatus ist hier in 3 Status aufgegliedert.

  • Telefoniestatus (klingelt, im Gespräch, Verfügbar)
  • DnD-Status (do not disturb)
  • Chatstatus (Symbolanzeige, Beispiel: grüner Haken – Verfügbar für Chat)

Setze Telefonie-Status: Hier können Sie einstellen, ob der Teams-Telefoniestatus in der STARFACE App (ehem. UCC Client) angezeigt werden soll. Dadurch werden STARFACE-Benutzer nur als telefonierend angezeigt. Dies verhindert nicht, dass Benutzer über die STARFACE angerufen werden. Verwenden Sie stattdessen die DND-Einstellung.

Setze DnD-Status: 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 in der Tabelle unten erläutert werden.

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 für jeden Teams-Status die DND-Konfiguration und der Statustext frei konfiguriert werden

Authentifikation bis Version 2.1

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. Dieser User benötigt eine E-Mailadresse, zur Bestätigung des Berechtigungstokens. Der Nutzer benötigt keine besonderen Rechte.

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.

TeamsConnect – Authentifikation ab Version 2.1

Authentifikation ab Version 2.1

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

Geheimer Clientschlüssel: Geben Sie hier den erstellten Schlüssel aus dem Azure AD ein (siehe oben). Unter Zertifikate & Geheimnisse – Geheime Clientschlüssel – kopieren Sie den „Wert“ und fügen ihn hier ein.

Nutzer / Passwort: Geben Sie den Nutzernamen / Passwort eines Benutzers Ihrer Organisation an. Es empfiehlt sich einen gesonderten Service-User hierfür einzurichten. Dieser User benötigt ab Version 2.1 keine E-Mailadresse mehr und benötigt keine besonderen Rechte.

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

Known Issues

Fehlermeldung im Modul LogProblemlösung
AADSTS50076: Due to a configuration change made by your administrator, or because you moved to a new location, you must use multi-factor authentication to accessDa in dem Azure Tenant MFA erzwungen ist. Reicht hier die Einstellung über App mit Secret nicht.
Es muss zusätzlich die IP der STARFACE im Azure unter dem Punkt „Sicherheit – Multi-Faktor-Authentifizierung  – Zusätzliche Einstellungen für die Cloudbasierte Multi-Faktor-Authentifizierung“
unter dem Punkt „Für Anforderungen von Partnerbenutzern in meinem Intranet die Multi-Faktor-Authentifizierung überspringen“ hinterlegt werden.
Known Issues

Modulversionen & Download

Hinweise:

Bitte achten Sie beim Download auf die Kompatibilität zu Ihrer STARFACE!

Mit Klick auf den Downloadlink einer Modulversion öffnen sich ein Fenster mit Installationshinweisen und ein Pop-up-Fenster.

Modul testen: Bitte tragen Sie Ihre Mailadresse ein, stimmen der Datenschutzbestimmung zu und klicken auf „Download“. Der Downloadlink wird Ihnen per Mail zur Verfügung gestellt. Sie können das Modul 14 Tage kostenlos testen.

Nach dem Kauf oder Update: Bitte verifizieren Sie sich mit Ihrer Mailadresse. Für die Inbetriebnahme/das Update ist kein Lizenzschlüssel nötig.

Das Modul wird Ihnen als .sfm Datei zur Verfügung gestellt.

VERSIONKOMPATIBILITÄTDOWNLOADCHANGELOG
1.0STARFACE
6.7.1.14 – 6.7.1.23
TeamsConnect_v54.sfmErste Version
1.0.1STARFACE
6.7.1.14 – 6.7.1.23
TeamsConnect_v56.sfm Verbesserung STARFACE-Cloud-Kompatibilität
– Anpassung Modul-Text

1.1
STARFACE
6.7.1.20 – 6.7.1.23
TeamsConnect_v66.sfm– Statusnachrichten konfigurierbar gemacht
– Logging bei Fehlern in der Benutzerzuordnung verbessert
1.1.2STARFACE
6.7.1.20 – 6.7.1.23
TeamsConnect_v67.sfm– Unterstützung für mehr als 100 Teams-User zugefügt
– Bei Teams Status „Busy“ wird jetzt auch DnD gesetzt
1.2.2STARFACE
6.7.1.20 – 6.7.3.22
TeamsConnect_v68.sfm– Anzeige des Teams-TelefonieStatus auf den BLF-Tasten
1.2.3STARFACE
6.7.1.20 – 6.7.3.22
TeamsConnect_v70.sfm– Englische Übersetzung hinzugefügt
1.2.5STARFACE
6.7.1.20 – 6.7.3.22
TeamsConnect_v83.sfm– Alternative Authentifikation hinzugefügt (DeviceCodeFlow)
– GUI Anpassungen
1.2.6STARFACE
6.7.1.20 – 6.7.3.22
TeamsConnect_v84.sfm– Verbesserung Token refresh
– Verbesserung der Statusanzeige bei STARFACE-Anrufen während eines Teams-Gesprächs
1.3STARFACE
6.7.2.2 – 6.7.3.22
TeamsConnect_v90.sfm– Graph service URL auf v1.0 updated
– Logikfehler beim setzen der Authentifikation korrigiert
2.1.4STARFACE
7.0.0.2 – 7.1.1.7
TeamsConnect_v120.sfmUpdate auf STARFACE 7
– API-Zugriffe neu implementiert
– Authentifizierung via oAuth.
– Teams-Status „Beschäftigt – Im Gespräch bei Anruf in der STARFACE
– Verbesserung Token refresh
– Sonderzeichen im Benutzer-Passwort nun zulässig
2.2.1 STARFACE
7.1.x
TeamsConnect_v124.sfm – Verbesserung der Stabilität: Anpassung der Timeout-Behandlung
– Neues Feature: DnD-Status in Teams während Telefonat in der STARFACE -> Teams-Calls werden für den Zeitraum des Gesprächs in der STARFACE nicht signalisiert
2.2.2STARFACE
7.0.0.2 – 7.2.0.5
TeamsConnect_v125.sfm – Verbesserung der Stabilität: Authentifizierungstoken
2.3STARFACE
7.0.0.2 – 7.2.1.3
TeamsConnect_v162.sfm – Jeder Teams-Präsenzstatus einzeln konfigurierbar gemacht
– STARFACE Benutzer lassen sich jetzt auch über die Login ID auswählen
– Die Modulinstanz deaktiviert sich selbst, wenn keine Zugangsdaten eingegeben wurden
Update auf STARFACE 7.2 / 7.2.1
2.4STARFACE
7.3.0.10 – 7.3.x
TeamsConnect_v164.sfm Update auf STARFACE 7.3
– Update Lizenzierung auf 2.9

Schreibe einen Kommentar

Inhalt