Versionen im Vergleich

Version Alte Version 12 Neue Version Aktuell
Änderungen wurden vorgenommen von

Ralf Kloth

Philipp Schäfer

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Die DynamicTeams manipulieren im Grunde genommen Sammelgruppen indem User hinzugefügt werden oder entfernt werden. Da es das Konstrukt "Sammelgruppe" so direkt in der Innovaphone nicht existiert müssen einige "Vorbedingungen" festgelegt werden:

  • Das Zertifikat der aurenz WebSuite muss gültig, vertrauenswürdig sein und die URL müss dem Zertifikat entsprechend korrekt aufgerufen werden. Ansonsten funktioniert die Integration in die Innovaphone App nicht!
  • Die Sammelgruppen wurden in UC-Analytics entsprechend konfiguriert (Siehe Anschlussbeschreibung Innovaphone)
  • Eine "Gruppe" darf nur einer einzigen "Waiting Queue" zugeordnet sein.
  • Eine "Waiting Queue" darf nur eine einzige "Gruppe" enthalten
  • Für die Agenten gilt aktuell noch: bei den PBX-Objekte muss der "Long Name" gleich dem "Display Name" sein
  • Bei Nutzung des Innovaphone Netlogon-Dienstes (Authentifizierung der Benutzer per NTLM) kann sich der User ausschließlich innerhalb der MyApps Anwendung an DynamicTeams anmelden.


Hinweis
Für die Kommunikation  von MyApps mit der WebSuite wird der HTTP-Header "Access-Control-Allow-Origin" benötigt. Hier muss sichergestellt sein, dass dieser Header NICHT von einer Firewall/Proxy entfernt wird!

...

Warnung
WICHTIG: Leerzeichen machen bei der Innovaphone Probleme! Daher bitte vermeiden!


  • Ein "APP-Object" (User) muss angelegt werden (z.B.: "Aurenz-DynamicTeams").
    Dieser muss im Reiter "App" die Einstellungen "Websocket", "Admin" und "PbxApi" aktiv haben.

    Image Added

    Tipp
    Hinweis: Bei "Long Name" wird der Name eingetragen wie dieser in "My Apps" erscheint. Hier können auch Leerzeichen verwendet werden!

    Bei der URL muss folgendes eingetragen werden:
    https://172.16.1.196/PBX0/Aurenz-DynamicTeams/aurenz-dynamicteams?serverUrl=http%3A%2F%2F172https%3A%2F%2F172.16.61.21%3A808121%3A8443

    Hierbei haben die einzelnen Werte folgende Bedeutung (bzw. müssen zur Konfiguration passen:
    https://<My Apps IP>/<Domain>/<Name>/aurenz-dynamicteams?serverUrl=<WebSuite URL>
    - <My Apps IP>: IP-Adresse der MyApp Plattform (siehe 3.2 MyApp Plattform - App Instanz anlegen)
    - <Domain>: Domäne (siehe 3.2 MyApp Plattform - App Instanz anlegen)
    - <Name>: Name der App Instanz (siehe 3.2 MyApp Plattform - App Instanz anlegen)
    - <WebSuite URL>: URL der WebSuite. Diese besteht aus "<Protokoll>%3A%2F%2F<IP-Adresse>%3A<Port>
    - aurenz-dynamicteams: WICHTIG: Dies muss genau so geschrieben sein!

    Hinweis

    HTTPS ist eine zwingende Einstellung für die Kommunikation mit der WebSuite:

    • Der HTTPS-Zugang für die WebSuite muss aktiviert werden: In der Administrations-Oberfläche in den Grundeinstellungen: "WebServer Webserver → Web Suite Einstellungen → HTTP Server".
    • WICHTIG: Der HTTP-Zugang muss daktiviert werden (d.h. es ist dann kein Zugriff mehr über HTTP möglich)!
    • Unter "Webserver → Web Suite Einstellungen → Sicherheit" muss die Option "WebSuite nicht als Bestandteil ener anderen Seite anzeigen" deaktiviert sein.
    • Nach der Änderung sind die Dienste neu zu starten!
    • Das Zertifikat eingerichtet werden: In der WebSuite unter "Datei → Einstellungen → HTTPS Konfiguration (SSL/TLS)".
    • Bei der APP-URL muss dann die "serverUrl" entsprechend angepasst werden (die entsprechenden Punkte sind "fett" markiert). Z.B.: https://172.16.1.196/PBX0/Aurenz-DynamicTeams/aurenz-dynamicteams?serverUrl=https%3A%2F%2F172.16.61.21%3A8443



    Image Removed

  • Den zu überwachenden Agenten muss nun bei der "Visibility" dieser APP-User zugeordnet werden.
    Hintergrund: Wird dies nicht gemacht, so erscheint beim Agenten ein Dialog, wo dieser hingewiesen wird, dass ein anderer User bestimmte Infos sehen möchte und ob der User zustimmt. Solange der User noch nicht zugestimmt hat (bzw. wenn dieser dies ablehnt), werden keine Presence-Informationen übermittelt!



...

Um die "Aurenz DynamicTeams" App verwenden zu können, muss diese in der MyApp Plattform eingetragen werden. Dazu wird so vorgegangen:

  • App installieren ("App Store" oder "App Upload")
    Die "DynamicTeams" App ist mittlerweile im innovaphone App Store gelistet und kann von dort installiert werden. Dazu den Punkt "App Store" awählen und dort die App "DynamicTeams" (von "aurenz GmbH") selektieren und dann "Installieren" drücken.

    Hinweis
    titleApp Upload

    Sollte die App nicht im App Store erscheinen, so kann die App auch manuell über den App Upload installiert werden.

    Dazu den Button "App Upload" drücken und im Dialog die Eingaben machen (siehe Screenshot). Unter "Binary file" die App-Datei auswählen (die App-Datei ist zu finden in dem Download der aurenz Software ("aurenz_Installation_XXXXX.zip") unter "UC-Analytics\Anbindung an Telefonanlagen\de\Innovaphone\myApp").

    Sollte der Button "App-upload" nicht sichtbar sein, so kann dieser unter "Settings→ General" aktiviert werden, indem der Punkt "Enable developer mode" aktiviert wird.

    Nach drücke auf "Save" muss die App schon als "Started" erscheinen (

    falls nicht - siehe Warnung).
    Warnung

    WICHTIG: die "App ID" darf KEINE Leerzeichen enthalten!).

    Image Modified

    Image Removed


    Image Added

  • App Instanz anlegen
    Nachdem die App installiert wurde, muss jetzt noch eine Instanz angelegt werden. Dazu auf "Add" drücken und den Dialog ausfüllen.
    Die App Instanz erscheint als "Stopped" und muss mittels "Start" aktiviert werden.

    Tipp
    In "All URLs ..." wird die URL angezeigt, welche aufgerufen werden muss. Diese ist in der Innovaphone PBX beim Anlegen des APP-User anzugeben (siehe 3.1 Innovaphone - Ein APP-User muss angelegt werden (z.B.: "Aurenz-DynamicTeams").



    Image Removed
    Image Added

UC-Analytics

In UC-Analytics muss sowohl die SOAP- als auch die WebSocket-Schnittstelle eingerichtet werden. Dazu muss folgendes gemacht werden:

  • Im Menü "DynamicTeams" muss die Innovaphone-Datenquelle ausgewählt werden. Dort sind die folgenden Einstellungen zu treffen:
    Image Removed
    Image Added

    • SOAP-Zugangsdaten
      Dies sind die Zugangsdaten für den Zugriff mittels SOAP auf die Innovaphone.
      IP-Adresse des SOAP-Service: Dies ist die IP-Adresse/DNS der Innovaphone.
      Username: Dies muss ein Administrator in der Innovaphone sein! (in der Innovaphone können unter "Admin → General" ggf. weitere Administratoren angelegt werden)!

      Hinweis
      titleinnovaphone Administrator Account - Passwortlänge

      Das Passwort darf maximal 15 Zeichen lang sein!


    • WebSocket-Zugangsdaten
      IP-Adresse des WebSocket-Service: Dies ist die IP-Adresse/DNS der Innovaphone.
      Username: Hier werden die Zugangsdaten für den Zugriff mittels WebSocket festgelegt (hier müssen die Zugangsdaten rein, welche oben festgelegt wurden. Im Beispiel die Zugangsdaten für "Aurenz DynamicTeams".
    • Konfigurieren zur Nutzung von myApps
      Hier muss das "Shared Secret" hinterlegt werden. Dieses muss mit "Passwort" übereinstimmen, welches in der "MyApp Plattform" beim Anlegen der App-Instance im Feld "Password" eingetragen wurde.


  • In den "Grundeinstellungen" müssen bestimmte Konfigurationen vorgenommen werden.
    Deaktivieren von HTTP. Dazu MUSS die Option "http Zugang aktivieren" deaktiviert werden.

    Image Added


    Die Option "WebSuite nicht als Bestandteil ener anderen Seite anzeigen" MUSS deaktiviert sein.
    Image Added

  • In den "Grundeinstellung" muss der Zugang zum WebServer konfiguriert werden.
    Dazu ist unter "Webserver\Benutzer Authentifizierung\Innovaphone Authentifizierung" der Punkt "Anmeldung über Innovaphone-Authentifizierung freigeben" zu aktivieren.
    Zuvor muss jedoch aktiviert werden, dass sich Anwender automatisch anmelden dürfen. Dazu ist unter "Webserver\Benutzer Authentifizierung\Automatischer Zugang bereitstellen" die 2. Option zu aktivieren.






    Mittels "Test der Zugangseinstellungen" kann geprüft werden, ob die Authentifizierung funktioniert.


  • Neustart der Dienste
    Nachdem die Grundeinstellungen geändetr wurden, müssen die UC-Analytics Dienste neu gestartet werden!

MyApps Client

Nachdem die Konfiguration soweit eingerichtet ist, kann die APP den einzelnen Usern zugeordnet werden:

  • Innovaphone
    Hier muss der APP-User (in diesem Beispiel "Aurenz-DynamicTeams") den Usern zugeordnet werden.

  • MyApp Client
    Im MyApp Client kann nun die APP verwendet werden.



    Durch drücken auf die APP wird der Anwender automatisch angemeldet und kann die DynamicTeams verwenden.
    Sollte die Meldung "Ihre Rechte reichen nicht aus. Bitte melden Sie sich mit einem anderen Benutzer an." kommen, so liegt dies ggf. daran, dass der User nicht als "DynamicTeams" User verwendet wird.


Sammelgruppen / Anrufliste

Für die korrekte Funktionsweise der "Anrufliste" müssen die Sammelgruppen konfiguriert werden.

Dazu müssen in der WebSuite unter "Datei → Einstellungen → Sammelgruppen Konfiguration" die Sammelgruppen eingetragen werden. Wichtig hierbei ist, dass unter der "Gruppen-Kennung" die Rufnummer eingetragen wird, welche auch im "DynamicTeams Management" als Rufnummer der Sammelgruppe angezeigt wird. Dies ist speziell interessant, wenn verschiedene PBXen (mit Prefixen) verwendet werden. Die Rufnummer mit Prefix muss dann als zusätzliche Kennung eingetragen werden.

Beispiel:

  • Sammelgruppe Rufnummer: 992
  • Rufnummer mit PBX-Prefix: 82992

In der Sammelgruppen Konfiguration ist dann die Sammelgruppe so zu konfigurieren:

  • Gruppen-Kennung: 992
  • Zusätzliche Kennungen: 82992

Fehleranalyse

Im myApps-Client kann mittels rechter Maustaste und dann "Untersuchen" können die Entwickler-Tools geöffnet werden. Dies erleichtern ggf. die Analyse von Problemen. Im Folgenden werden einige der möglichen Fehlerquellen dargestellt.

Anmerkung: Da in UC-Analytics die Passwörter/... zwischengespeichert werden kann es nötig sein, nach Änderung den "UC-Analytics Abrechnungsmoduls" Dienst neu zu starten!

Aktualisierung der Dynamic Teams User und Gruppen

Die Gruppen/User werden täglich um 0 Uhr „synchronisiert“ (d.h. es werden die Gruppen/User aus der Anlage ausgelesen).

Um sofort Gruppen/User in DynamicTeams zu sehen, kann die Synchronisation in der Administration über den Menüpunkt DynamicTeams erzwungen werden. Hier kann man diese konfigurieren – in der WebSuite/DynamicTeams kann es dann noch 5 Minuten dauern, bis die Gruppe/User sichtbar ist.

Zertifikat-Problem

Wird z.B. im Client das verwendete Zertifikat nicht eingespielt oder nicht gültig ist, dann kann die App nicht starten und es erscheint "Aurenz DynamicTeams wird gestartet..." - es passiert jedoch nichts.

Zur Analyse sollten die Entwickler-Tools im myApps-Client geöffnet werden und dort auf den Reiter "Network". Erscheint dort "UCA_Innovaphone.js" in rot und mit Status "(canceled)" (siehe Screenshot), so lässt dies darauf schließen, dass das Zertifikat nicht korrekt bzw. im Client nicht bekannt ist.

Hinweis: Ob das verwendete Zertifikat gültig/korrekt ist, sollte mit dem Google Chrome Browser getestet werden. Da der myApps-Client auf dem Google Chrome Browser basiert, lässt sich nur damit sicher feststellen, ob das Zertifikat vom myApps-Client als gültig/korrekt erkannt wird. Andere Browser (Firefox, Edge, ...) können hier ein anderes Verhalten zeigen.

Image Added

Passwort / Shared Secret stimmt nicht überein

Bei der Einrichtung/Konfiguration muss ein Passwort/Shared Secret vergeben werden. Stimmt dies nicht in allen Stellen überein, so kommt es zu einer Fehlermeldung "InternalServerException" - im myApps-Client erscheint ein Dialog mit der Fehlermeldung "InternalServerException" (siehe Screenshot).

Zur Analyse sollten die Entwickler-Tools im myApps-Client geöffnet werden und dort auf den Reiter "Console". Erscheint dort bei "GET https://<ip-adresse ggf. port>/service/alwin/extsys/credentials?digestArgs..." die Meldung in rot "500 (Internal Server Error)", so lässt dies daraus schließen, dass das Passwort/Shared Secret nicht übereinstimmt.

Das Passwort/Shared Secret muss an folgenden Stellen gleich sein:

  • UC-Analytics Administration: "DynamicTeams → Agentenberechtigungen verwalten... → Innovaphone Zugangsdaten konfigurieren" - hier muss Feld "Shared Secret".
  • In der Innovaphone PBX: Das Objekt "Aurenz DynamicTeams" - hier das Feld "Password".
  • In der Innovaphone myApps-Plattform: In der App "Aurenz-DynamicTeams" - hier das Feld "Password".

Image Added

Grundeinstellungen sind nicht korrekt

Erscheint beim öffnen der DynamicTeams App in myApps die Meldung "Error ActionRightLoadError ..." (siehe SCreenshot), so kann dies an eine "falschen" Konfiguration liegen.

Dies lässt sich noch genauer analysieren, indem man sich die DevTools (im Browser F12 - bzw. im Client rechte Maustaste und dann Inspect/Untersuchen) öffnet und unter "Netzwerk" sich den Eintrag "loginAlwin" anschaut. Erscheint in den Response-Headern (könnte auch in einem extra Reiter "Cookies" erscheinen) der Eintrag "SameSite=STRICT", so ist die Konfiguration in den Grundseinstellungen nicht korrekt und muss korrigiert werden (Anmerkung: Es muss der Wert "SameSite=NONE" kommen).

In den Grundeinstellungen "Datei → Programm einrichten → Grundeinstellungen..." müssen die Punkte korrekt konfiguriert sein:

  • Webserver → WebSuite Einstellungen → HTTP Server: Der Punkt "http Zugang aktivieren" MUSS deaktiviert sein!
  • Webserver → WebSuite Einstellungen → Sicherheit: Der Punkt "WebSuite nicht als Bestandteil ener anderen Seite anzeigen" MUSS deaktiviert sein!

Zusätzlich sollten die folgenden beiden Dienste neu gestartet werden:

  • UC-Analytics Abrechnungsmodul
  • UC-Analytics Web Suite

Image Added