...

...

Voraussetzungen für die Auswertung von MS Teams Kommunikationsdaten

• Freischaltecode / Lizenzierung:  Die MS-Teams Datenquelle ist ein kostenpflichtiges Zusatzmodul und kann optional nachgeordert werden. Wenden Sie sich an Ihren Distributor oder an das aurenz Vertriebs-Team.

• Administrativen Zugriff auf das Microsoft Azure Portal.

• Es gibt 3 verschiedene Anbindungsvarianten. Bitte prüfen Sie vorab, welche Variante Ihre Anforderungen erfüllt bzw. technisch realisierbar ist.

  • Call-Records-Schnittstelle:
    Diese Schnittstelle liefert Teams-interne Kommunikationsdaten unabhängig des Anschlusses an das PSTN/ den ITSP. 
    --> Achtung: erfordert eine an UC-Analytics angebundene MS SQL Datenbank!

  • Direct Routing Calls Schnittstelle:
    Dies ist die korrekte Schnittstelle, wenn MS Teams Telefonie über einen Session Border Controller erfolgt (Direct Routing) 

  • PSTN Calls Schnittstelle:
    Dies ist die korrekte Schnittstelle, wenn MS Teams Telefonie über einen ITSP Anschluss bei Microsoft erfolgt (Operator Connect oder Dialplan) 

...

Microsoft Teams befindet sich in der Cloud. Damit aurenz Zugriff auf die MS-Teams Daten bekommt, müssen entsprechende Berechtigungen erstellt werden. Um diese Berechtigungen zu vergeben, können Sie zwei verschiedene Vorgehensweisen verwenden.

a. aurenz Teams Connectivity Services
In dieser Variante werden alle Berechtigungen weitgehend automatisch vergeben. Ebenso wird ein Cloud Service bereitgestellt, der Daten von Microsoft Teams zwischenspeichert, bevor sie von UC-Analytics abgeholt werden.

Diese Variante steht ab UC-Analytics Version 14.1.1.02 zur Verfügung.

b. Manuelle Vergabe der Berechtigungen
Hier müssen Sie die Berechtigungen manuell im Azure Portal festlegen. Sofern Sie die Call-Records Schnittstelle nutzen wollen, müssen Sie in Ihrer DMZ einen Server bereitstellen, der Daten von Microsoft Teams zwischenspeichert, bevor sie von UC-Analytics abgeholt werden.

Beide Verfahren unterscheiden sich grundsätzlich in ihrer Einrichtung und haben daher eigenständige Kapitel. Für die spätere Abrechnung der Daten ist es hingegen egal, welches der beiden Verfahren Sie verwenden. Beide Verfahren haben dieselben Gesprächsdaten zur Folge.

Verwendung des Teams Connectivity Service

Nachdem Sie eine Microsoft Teams Datenquelle erstellt haben, wählen Sie die Einstellung Microsoft Teams. Wählen Sie dort die gewünschte Schnittstelle und anschließend die Variante Aurenz TeamsConnectivityserver einsetzen.

...

Klicken Sie jetzt auf Verbinden. Sie erhalten nun einen weiteren Dialog mit zusätzlichen Erklärungen

...

Klicken Sie jetzt auf App registrieren und verbinden.

Es öffnet sich nun Ihr Standard Web-Browser und Sie werden aufgefordert, sich mir Ihrem Microsoft Konto anzumelden.

...

Nachdem Sie sich angemeldet haben, werden Sie noch gefragt, ob Sie der Vergabe der Rechte zustimmen. Dies müssen Sie akzeptieren.

...

Haben Sie dies akzeptiert, so werden die entsprechenden Rechte in Ihrem Azure-Portal unter Unternehmensanwendungen gespeichert.

Sie erhalten abschließend noch eine Meldung, dass der Browser jetzt wieder geschlossen werden kann.

...

Schließen Sie jetzt den Browser und kehren Sie zu UC-Analytics zurück.

Hier erhalten Sie nochmals eine Bestätigung, dass die Verbindung von UC-Analytics zum Teams Connectivity Service hergestellt werden konnte.

...

Die Einrichtung ist damit abgeschlossen und Sie können Daten von Microsoft Teams für UC-Analytics abrufen.

Manuelle Vergabe der Berechtigungen

Rufen Sie dazu das Azure Portal auf:

...

Melden Sie sich am Portal als Administrator an.

App-Registrierung durchführen

Wählen Sie hier Azure Active Directory

...

• Mandanten-ID

• Anwendungs ID (Client)

• Geheimer Wert

Berechtigung hinzufügen

Im letzten Kapitel haben wir eine App Registrierung für den Zugang zu Microsoft Teams angelegt. Im nächsten Schritt muss dieser App jetzt das Recht für den Zugriff auf die Daten gewährt werden.

...

Die Vergabe der Zugriffsrechte ist damit abgeschlossen und sie können sich vom Azure Portal abmelden.

Einrichtung von AlwinPro

Anker
3MST-Varianten 3MST-Varianten

Übersicht der drei MS Teams Anbindungs-Varianten

Microsoft Teams bietet drei Schnittstellen, über die man Gesprächsdaten abrufen kann:

...

Diese Schnittstelle benötigt eine PSTN-Integration, sonst werden keine Daten erzeugt. Diese Schnittstelle greift direkt auf die Gesprächsdaten zu, so dass keine Installation in der DMZ notwendig ist.
Die Daten dieser Schnittstelle können Sie mit den Standard UC-Analytics Auswertungen verwenden. Die Daten dieser Schnittstelle können jedoch nicht über den Teams Explorer ausgewertet werden. Hier werden nur die Daten des PSTN Gateways erfasst. Interne Gespräche, Rufumleitungen und Sammelgruppen werden nicht erkannt.

Anker
CallRecordsSetup CallRecordsSetup

Einrichtung der Call Records Schnittstelle

Einrichtung des AlwinPro Teams Connectivity Server

Die Einrichtung der AlwinPro Teams Connectivity Server ist nur dann notwendig, wenn Sie die Call Records Schnittstelle nutzen wollen. Bei Verwendung der Direct Routing Calls oder PSTN Calls Schnittstelle entfällt dieser Punkt.

...

1. Erzeugen Sie auf dem DMZ-Server ein neues Verzeichnis und kopieren Sie dort den Inhalt des Verzeichnisses AlwinProTeamsServer von der AlwinPro Installations-CD hinein.

2. Starten Sie AlwinProTeamsServer.exe als Administrator.

3. Sie sehen jetzt die Einstellmöglichkeiten des Programms:
   

   

   
   Legen Sie hier als erstes den Port fest, über den der AlwinPro Teams Connectivity Server erreichbar ist. Ein HTTPS Port muss hier vergeben werden, da Microsoft zurzeit Gesprächsinformationen nur über HTTPS überträgt. Einen HTTP Port können Sie optional zusätzlich festlegen. Klicken Sie anschließend auf Einstellungen speichern.
   
   

4. Für einen HTTPS Zugang ist ein SSL-Zertifikat notwendig. Klicken Sie daher auf SSL-Zertifikat
   

   

5. Für ein SSL-Zertifikat wird ein privater Schlüssel benötigt. Im Auslieferungszustand ist zwar bereits ein privater Schlüssel mit einer Länge von 1024 Bit enthalten, sie sollten aber aus Sicherheitsgründen immer einen eigenen, privaten Schlüssel erzeugen. Wenn Sie eine höhere Sicherheit wünschen, so können Sie hier eine andere Länge des Schlüssels festlegen. Klicken Sie anschließend auf Erzeugen um den privaten Schlüssel zu erzeugen.

6. Legen Sie im Feld Common Name den Namen fest, unter dem der AlwinPro Teams Connectivity Server vom Internet aus erreichbar ist. Achten Sie darauf, dass der Name wirklich exakt stimmt, sonst ist das Zertifikat später ungültig. Klicken Sie anschließend auf das darunter liegende Erzeugen. Es öffnet sich jetzt ein Fenster, in dem Sie Name und Ort für den erzeugten Zertifikatsrequest angeben können. Lassen Sie diesen Zertifikatsrequest von einer vertrauenswürdigen Zertifizierungsstelle signieren. Sie erhalten damit ein Zertifikat. Achten Sie darauf, dass das Zertifikat im PEM Format erstellt wird (Manchmal auch als Apache-Format bezeichnet). Andere Formate können vom AlwinPro Teams Connectivity Server nicht gelesen werden.

7. (Optional) Es kann sein, dass die Zertifizierungsstelle von Ihnen verlangt, eine Datei zur Verifikation ihres Servers zur Verfügung zu stellen. Geben Sie dazu bei Web-Pfad den Pfad (ohne Server Namen) an, unter dem die Zertifizierungsstelle die Datei erwartet und laden Sie die Datei mit Hilfe der Upload Schaltfläche hoch. Schließen Sie jetzt die Zertifikatsverwaltung, speichern Sie die Einstellungen und starten Sie den Server, jedoch ohne HTTPS, da zurzeit noch kein gültiges Zertifikat vorhanden ist. Nach Abschluss der Verifikation durch die Zertifizierungsstelle, beenden Sie den Server, aktivieren Sie wieder HTTPS und kehren Sie zur Zertifikatsverwaltung zurück.

8. Sobald Ihnen ein Zertifikat im PEM-Format vorliegt, Wählen Sie Laden und geben den Dateinamen des Zertifikats an. Das Zertifikat wird jetzt geprüft und im AlwinPro Teams Connectivity Server installiert. Schließen Sie anschließend das Fenster

9. Sichern Sie jetzt die Dateien alwin.key und alwin.cert aus dem Installationsverzeichnis des AlwinPro Teams Connectivity Servers. Diese Dateien enthalten ihren privaten Schlüssel und ihr Zertifikat. Sollten Sie den AlwinPro Teams Connectivity Server aus irgendeinem Grund neu installieren müssen, müssen Sie auch diese beiden Dateien wieder herstellen, sonst ist ihr Zertifikat verloren und sie müssen ein neues beantragen.

10. Nachdem Sie wieder ins Hauptfenster zurückgekehrt sind, wählen Sie Einstellungen testen. Sollte dieser Test erfolgreich sein, so können Sie fortfahren, ansonsten müssen Sie den gemeldeten Fehler erst beheben.
    

    Image RemovedImage Added

11. Wählen Sie jetzt im Bereich Dienst die Auswahl Installieren.
    
    

12. und im nächsten Schritt dann Starten.
    

    

13. Überprüfen Sie jetzt, ob der Server auch wirklich aus dem Internet und von der AlwinPro Installation aus erreichbar ist. Geben Sie dazu die vergebene URL in einen Web Browser ein. Führen diesen Test unbedingt vom öffentlichen Internet und vom AlwinPro Server aus durch.
    Im Erfolgsfall erhalten Sie diese Anzeige:
    

    

14. Der AlwinPro Teams Connectivity Server ist jetzt vollständig installiert. Fahren Sie nun mit der Einrichtung von AlwinPro fort.

Einrichtung der AlwinPro Datenquelle für die Call Record Schnittstelle

1. Wählen Sie in der Datenaufnahme den Menüpunkt Telefonanlagen > Einstellen und anschließend den Punkt Neu. Wählen Sie nun die Microsoft Teams Datenquelle mit Graph-API
   

   

2. Folgen Sie dem Assistenten und geben Sie die entsprechenden Daten ein

3. Die Einstellungen der Datenquelle enthält eine Reihe von Registerkarten, wovon nur zwei spezifisch für Microsoft Teams sind:
   Verzeichnis Scannen: Hier wird das Verzeichnis angegeben, in dem die von Microsoft heruntergeladenen Gespräche zwischengespeichert werden, bevor sie verarbeitet werden. In der Regel können die Werte so belassen werden, wie sie sind.
   Microsoft Teams: Hier sind die Teams-Daten einzutragen

4. Wählen Sie die Registerkarte Microsoft Teams. Wählen Sie dort als API Call Record.
   

   

   
   Die Werte für Mandanten ID, Anwendungs ID und Geheimer Wert entnehmen Sie aus den Einstellungen im Microsoft Azure-Portal, wie oben beschrieben. Für den Zugang zum AlwinPro Teams Connectivity Server geben Sie die jeweilige URL ein, die sie beim Test aus dem letzten Kapitel verwendet haben.

5. Wählen Sie anschließend Test um die Einstellungen zu überprüfen.

6. Nach erfolgreichem Test kann die Datenquelle für den Abruf von Daten verwendet werden.

Hinweis: Nach dem Führen eines Gesprächs werden die Daten von Microsoft an den AlwinPro Teams Connectivity Server übertragen. Das Übertragen der Daten erfolgt aber nicht sofort. In unseren Tests haben wir eine Verzögerung von bis zu 20 Minuten festgestellt, wobei die Verzögerung allerdings von Gespräch zu Gespräch stark unterschiedlich war.

Einrichtung der AlwinPro Datenquelle für die Direct Routing Call Schnittstelle oder PSTN Call Schnittstelle

1. Wählen Sie in der Datenaufnahme den Menüpunkt Telefonanlagen > Einstellen und anschließend den Punkt Neu. Wählen Sie nun die Microsoft Teams Datenquelle mit Graph-API
   

   

2. Folgen Sie dem Assistenten und geben Sie die entsprechenden Daten ein

3. Die Einstellungen der Datenquelle enthält eine Reihe von Registerkarten, wovon nur zwei spezifisch für Microsoft Teams sind:
   Verzeichnis Scannen: Hier wird das Verzeichnis angegeben, in dem die von Microsoft heruntergeladenen Gespräche zwischengespeichert werden, bevor sie verarbeitet werden. In der Regel können die Werte so belassen werden, wie sie sind.
   Microsoft Teams: Hier sind die Teams-Daten einzutragen

4. Wählen Sie die Registerkarte Microsoft Teams. Wählen Sie dort als API Direct routing calls bzw. PSTN Calls
   

   

   
   Die Werte für Mandanten ID, Anwendungs ID und Geheimer Wert entnehmen Sie aus den Einstellungen im Microsoft Azure-Portal, wie oben beschrieben.

5. Wählen Sie anschließend Test um die Einstellungen zu überprüfen.

6. Nach erfolgreichem Test kann die Datenquelle für den Abruf von Daten verwendet werden.

...