Versionen im Vergleich

Version Alte Version 3 Neue Version 4
Änderungen wurden vorgenommen von

h.elholm

h.elholm

Gespeichert am

Schlüssel

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

Inhalt

Einleitung

Mit dem Feature DynamicTeams den DynamicTeams der UC-Analytics lassen sich Sammelgruppen dynamisch und zentral erweitern , wie auch und es kann für die Sammelgruppenmitglieder den Mitglieder einer Gruppe der Präsenz-Status eingesehen werden. Dieses Dokument beschreibt wie die Innovaphone und die relevanten UC-Analytics Komponenten eingerichtet werden müssen, damit das Feature genutzt werden kann. Bitte beachten Sie, dass die DynamicTeams ein Leistungsmerkmal ist, welches in der UC-Analytics freigeschaltet sein muss. Steht das Feature bei Ihrer Installation nicht zur Verfügung, muss es nachlizenziert werden. 

Begriffsdefinitionen

  • User
    Ein User entspricht einem Teilnehmer und hat unter anderem eine Rufnummer und eine Zuordnung zu einer Gruppe (bzw. auch zu mehreren).
  • Gruppe
    Eine Gruppe in der Innovaphone ist erst mal nur ein "Name" (ohne Funktionalität). Diese Gruppe kann nun einem "User" zugeordnet werden. Weiterhin kann eine Gruppe einer "Waiting Queue" (siehe nächster Punkt) zugeordnet werden.
    ACHTUNG: Eine Gruppe kann mehreren "Waiting Queues" zugeordnet werden (siehe auch weiter unten).
  • Waiting Queue
    Hinter einer "Waiting Queue" verbirgt sich nun die eigentliche Funktionalität der "Sammelgruppe". Z.B.: wird hier festgelegt ob Rufe zyklisch oder parallel verteilt.
    ACHTUNG: Einer "Waiting Queue" können auch mehrere "Gruppen" 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.

Details für die Entwicklung

Gruppen/Agenten abfragen

Die Innovaphone bietet eine SOAP-Schnittstelle, mittels welcher Informationen abgefragt werden können (bzw. auch Änderungen vorgenommen werden können).

Zur Abfrage der Agenten und Gruppen wird die SOAP-Funktion "FindUser" verwendet.
Bei der Nutzung sind einige Besonderheiten zu beachten:

  • Es können nicht beliebig viele Einträge abgefragt werden. Vielmehr muss in einer Schleife hier Packetweise abgefragt werden (wir rufen immer 100 ab).
  • Es muss mit einem Start "cn" angefangen werden (wir verwenden hier " " - d.h. ein Leerzeichen) und die Anzahl der abzufragenden Einträge.
  • Bei nachfolgenden Abfragen muss dann mit dem jeweils letzten "cn" fortgesetzt werden und zusätzlich die Kennung "next" gesetzt werden.

Agent ein-/ausbuchen

Dies erfolgt ebenfalls über die SOAP-Schnittstelle.

Zuerst wird der "User" über dessen "cn" abgefragt und die "grp" Liste geändert (d.h. entweder die entsprechende Gruppe zugefügt, ober entfernt).

Presence-Status

Für den Presence-Status bietet die Innovaphone die Möglichkeit, eine "Session" aufzubauen und sich über Status-Änderung informieren zu lassen.
Der Ablauf ist so:

  • Es wird eine Session aufgebaut (WICHTIG: die HTTP-Verbindung muss offen gehalten werdenüber die ganze Session hinweg).
  • Für jede zu überwachende Nebenstelle wird nun "UserInitialize" aufgerufen.
  • Nun wir in einer Schleife die SOAP-Funktion "Poll" aufgerufen. Diese kommt zurück, wenn sich eine Statusänderung ergeben hat und liefert die entsprechende Infos (ggf. auch von mehreren Nebenstellen gleichzeitig).

WebSocket-Schnittstelle

ACHTUNG: Die bisher verwendete SOAP-Schnittstelle gibt es zwar noch, jedoch wird diese im Prinzip nicht mehr weiterentwicklet und es sollte die neue WebSocket-Schnittstelle verwendet werden!

Es gibt eine neue Schnittstelle zum Zugriff auf die Innovaphone. Diese funktioniert mittels WebSocket. Damit kann man im alles machen (laut Aussage), was man auch mit der SOAP-Schnittstelle machen konnte und noch mehr. Dies ist die bevorzugte Schnittstelle und sollte für zukünftige Entwicklungen verwendet werden.

Für den Zugriff auf die Innovaphone-PBX ist das folgende Protokoll interesssant: "http://sdk.innovaphone.com/doc/appwebsocket/myApps.htm".

MyApp Client

Der MyApp Client cached ggf. Dateien, was es bei der Entwicklung schwierig macht. Den Cache kann man leeren, wenn man die Dateien in folgenden Verzeichnissen löscht (vorher natürlich MyApp Client beenden):

  • "C:\Users\Support\AppData\Roaming\innovaphone\myApps\chromium"
  • "C:\Users\Support\AppData\Roaming\innovaphone\myApps\appproxy\ext\172.16.1.196\PBX0"
    → Hier kommt es etwas auf die Konfiguration an: "172.16.1.196" ist die IP der App Plattform; "PBX0" ist die Domain
    → Darunter dann den Ordner löschen, welcher so heisst, wie die APP.