Telefonie Integration für DATEV STARFACE Modul

Dokumentation für Modulversion 4.2.2 ab STARFACE 10.0.0.0

Produktbeschreibung

Mit der "Telefonie Integration für DATEV" können Telefongespräche minutengenau abgerechnet und zu jedem Gespräch persönliche Notizen hinzugefügt werden. Mit wenigen Mausklicks werden die gesammelten Informationen voll automatisiert an DATEV übertragen. Außerdem werden die Mandanten ganz einfach mit dem Adressbuch der STARFACE synchronisiert. Die Integration sorgt dafür, dass jeder Anrufer mit Namen angezeigt wird. Ein Anruf bei einem Mandanten erfolgt ebenfalls über einen Klick aus der DATEV Arbeitsoberfläche.

Technische Voraussetzungen

• Diese Modulversion verfügt über eingeschränkte Kompatibilität mit Active Directory und DATEVasp.
• ab STARFACE 10.0.0.0
• Für dieses Modul stehen Legacy-Versionen ab STARFACE 7.0.0.2 zur Verfügung.
• uneingeschränkt Cloud-ready.
• Kompatibel mit App Version ab 4.2.12 und Addressbuch-Exporter ab 2.5.3.

Die "Telefonie Integration für DATEV" ist mit einer lokalen Installation von DATEV Arbeitsplatz, einer Installation von DATEV Arbeitsplatz auf einem Terminalserver sowie mit DATEVasp kompatibel. Die Erweiterung DATEV Telefonie Basis muss installiert und lizenziert sein. Diese ist bei Ihrem DATEV Partner oder DATEV direkt erhältlich. Die "Telefonie Integration für DATEV" ist mit Windows 10 oder neueren Versionen kompatibel.

Erforderliche Ports

Die STARFACE muss unter folgenden Ports vom Host der "Telefonie Integration für DATEV" erreichbar sein.

• 443 TCP (HTTPS)
• 5222 TCP (XMPP)

Weitere Informationen zur Portnutzung der STARFACE finden sich in der STARFACE Knowledge Base.

Kompatibilität

MIGRATION-TODO: AsciiDoc-Attributblock manuell pruefen: [%autowidth]

MIGRATION-TODO: AsciiDoc-Tabelle manuell pruefen

|===
| | DATEV Lokal / TS | DATEVasp | DATEV PARTNERasp
| STARFACE Appliance
| ja
| ja
| ja
| STARFACE VM-Edition
| ja
| ja
| ja
| STARFACE Cloud
| ja
| ja*
| ja
|===

UCI Proxy für DATEVasp von o-byte.com erforderlich

Der DATEV-UCI-Proxy ist eine lokal installierte Hardware, die eine Verbindung zwischen DATEVasp und einer STARFACE Cloud mit fester IP-Adresse herstellt. Es wird ein gesicherter Kommunikationsweg aus DATEVasp in Richtung STARFACE Cloud hergestellt.

Lizenz

Die "Telefonie Integration für DATEV" wird in zwei unterschiedlichen Varianten vertrieben, als Full-Version und Light-Version. Die folgende Tabelle erläutert die Unterschiede im Funktionsumfang. Es ist nicht möglich, die unterschiedlichen Varianten für eine Installation zu mischen.

MIGRATION-TODO: AsciiDoc-Attributblock manuell pruefen: [%autowidth]

MIGRATION-TODO: AsciiDoc-Tabelle manuell pruefen

|===
| | Telefonie Integration für DATEV Full-Version | Telefonie Integration für DATEV Light-Version
| Minutengenaue Abrechnung der Telefongespräche
| ja
| nein
| Gesprächsnotizen zu jedem Gespräch erfassen
| ja
| nein
| Mandanten direkt aus DATEV anwählen
| ja
| ja
| Namensauflösung der Mandanten am Telefon
| ja
| ja
|===

Zusätzliche Komponente

Informationen zum UCI Proxy für DATEVasp befinden sich auf der folgenden Unterseite:

UCI Proxy für DATEVasp

STARFACE-Konfiguration

• Es muss vorab keine Konfiguration in der STARFACE vorgenommen werden.

Modulkonfiguration

Allgemein

• Name:
• Wähle hier den Namen der Modulinstanz. Dieser Name sollte möglichst beschreibend vergeben werden, ein guter Ausgangspunkt ist der Name des Moduls. Sollen mehrere Instanzen des selben Moduls aktiv sein, muss für jede Instanz ein einmaliger Name vergeben werden.

• Beschreibung:
• Dieses Feld bietet Raum für eine detailliertere Dokumentation der Instanz. Hier kann beispielsweise dokumentiert werden, auf welche Nutzer oder Gruppen das Modul zugreift.

• Logdatei:
• Jedes Modul informiert in den Levels ERROR, WARN, INFO, DEBUG und TRACE über Prozesse, die im Modulbetrieb ablaufen. Falls ein Fehler auftritt, kann die Logdatei gespeichert werden. Standardeinstellung ist das Level INFO.

Hinweis: Das Log aktualisiert sich nicht automatisch, sondern nur, wenn die entsprechende Schaltfläche betätigt wird.

Konfiguration

Adressaten

Adressaten können nach Kanzleinamen getrennt in unterschiedliche STARFACE-Adressbücher importiert werden. Der Vorgabename lautet "Standard" und wird in das öffentliche Adressbuch (0) importiert. Diese Einstellungen brauchen nur angepasst zu werden, wenn mehrere Kanzleien eine gemeinsame STARFACE verwenden. Weitere Adressbücher werden im STARFACE-Adminbereich unter "Adressbuch" mit der entsprechenden Bezeichnung und Ordnerzuweisung angelegt.

Institutionen

Die Institutionen werden nur von einer Kanzlei importiert, da diese Datensätze von DATEV einheitlich gepflegt werden.

Im Feld Kanzlei ist die entsprechende Bezeichnung der Kanzlei anzugeben, die im Adressbuch Exporter hinterlegt wurde und die Institutionen in die STARFACE importieren soll.

Warnung: Das Importieren der DATEV-Institutionen resultiert in über 15.000 zusätzlichen Einträgen im STARFACE-Adressbuch. Das können für kleinere Anlagen zu viele Einträge sein; die Funktion der Telefonie kann dadurch beeinträchtigt werden.

Rufnummernfelder

Über die Notiz in den Stammdaten der Mandanten kann eine Rufnummer einem speziellen Feld im STARFACE-Telefonbuch zugewiesen werden.

Hier kann die gewünschte Zuweisung der festgelegten Aliase vorgenommen werden.

Beispiel: Alle Rufnummern, die im Notizfeld in DATEV mit "Mobil" eingetragen sind, werden in der STARFACE in das Adressfeld "MOBILE" importiert.

Transkription

Transkription

• Aktiviere die Checkbox, um die Transkriptionsfunktion zu aktivieren. Sobald ein Anruf aufgezeichnet wird, wird die Transkription über den FLEXbyte-Server initiiert.

• FLEXbyte Server URL:
• Trage hier die URL des FLEXbyte-Servers ein, über den die Transkription abgewickelt wird. Diese Funktion befindet sich derzeit in der Closed-Beta für ausgewählte Partner und Kunden.

• FLEXbyte Token:
• Trage hier den Token ein, der für die Authentifizierung am FLEXbyte-Server benötigt wird.

Benutzerauswahl

In diesem Abschnitt kann ausgewählt werden, welche Benutzer für die Transkription ausgewählt werden können. Es können entweder alle Benutzer, eine bestimmte Gruppe oder einzelne Benutzer ausgewählt werden.

Anrufaufzeichnung

Gebe hier an, welche Anrufe aufgezeichnet und transkribiert werden sollen. Aktiviere die entsprechenden Checkboxen für eingehende, ausgehende, Gruppen und interne Anrufe.

Zwischengespeicherte Transkriptionen

Um die API-Abfragen an FLEXbyte zu reduzieren, werden die Transkripte zwischengespeichert. Um zwischengespeicherte Transkriptionen periodisch zu löschen, aktiviere die Checkbox und definiere das maximale Alter der Transkriptionen.

Cache Timer

Gebe einen Zeitintervall an, wie lange die Transkripte zwischengespeichert werden sollen, bevor sie automatisch gelöscht werden.

Bekannte Probleme

1. Provisionierung der Endgeräte funktioniert nicht

• Situation:
• Telefone sind im DATEV-Netz, die TK-Anlage ist im allgemeinen Netz, beide Netze sind über den UCI Proxy verbunden.

• Voraussetzung:
• DNS-Server im DATEV-Netz, in dem man Overrides beziehungsweise eigene Einträge setzen kann.

• Lösung:
• Die STARFACE bekommt einen DNS-Namen, zum Beispiel starface.o-byte.dev. Dieser muss unter Server -> Netzwerk -> Hostname eingetragen werden.
• Unter Telefone -> Einstellungen muss unter "Verwendete Server-Adresse" der DNS-Name ausgewählt werden.
• Im DNS-Server im DATEV-Netz muss ein A-Record gesetzt werden, wobei der DNS-Name auf die IP-Adresse des UCI Proxy zeigen muss.

2. Inkompatibilität mit Active Directory und DATEVasp

• Situation:
• Die Integration ist derzeit nicht mit Active Directory oder DATEVasp kompatibel.

• Lösung:
• Werden diese Funktionen benötigt, raten wir vom Update auf STARFACE 10 ab, bis die Kompatibilität hergestellt ist.

Versionshinweis

• 4.2.2
• Known Issue: Nicht kompatibel mit Active Directory und DATEVasp.
• Portiert auf STARFACE 10.0.0.0.
• Anpassung an die Transkriptions-Bibliothek, die Transkriptionen ausschließlich über FLEXbyte-Server abfragt.
• Kompatibel mit DATEV-Client 4.2.7.

Download

Bitte achte beim Download auf die Kompatibilität zur STARFACE-Version.

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

Modul testen

• Nach dem Kauf oder Update: Mit E-Mail-Adresse verifizieren. Für die Inbetriebnahme oder das Update ist kein Lizenzschlüssel nötig.
• Wir stellen das Modul als .sfm-Datei zur Verfügung.

Zum Download

—

UCI Proxy für DATEVasp

Beschreibung

Der o-byte UCI Proxy ermöglicht die Verwendung von UCI-Anwendungen, wie zum Beispiel dem STARFACE UCC Client oder DATEV Client, in einer DATEVasp Umgebung mit einer Cloud oder sonstigen extern gehosteten Telefonanlage. Dies ist standardmäßig nicht möglich, da DATEVasp Instanzen ausschließlich Verbindungen über die benötigten Ports in das Kundennetzwerk erlauben. Somit können DATEVasp Kunden diverse UCI-Anwendungen nutzen und dabei von Funktionen wie Click2Dial profitieren, auch wenn die STARFACE nicht im eigenen Netzwerk gehostet ist.

Dieses Produkt umfasst die Hardware mit vorinstallierten Software durch die o-byte.com GmbH & Co. KG

Vorraussetzung

Das Produkt wendet sich an Kunden, die DATEVasp sowie eine nicht im eigenen Netzwerk gehostete STARFACE, oder andere kompatible Telefonanlage nutzen, zum Beispiel STARFACE Cloud (zwingend “Dedizierte IP-Adresse” benötigt). Aus dem Kundennetzwerk muss die STARFACE Cloud über dem XMPP-Dienst (Port 5222) und HTTPS-Dienst (Port 443) erreichbar sein. Zudem muss die IP-Adresse des UCI Proxy im eigenen Netzwerk von DATEVasp entsprechend freigeschaltet sein.

Funktionsweise

Die UCI Anwendungen in der DATEVasp Umgebung können netzwerktechnisch die benötigten Ports, aufgrund von Restriktionen seitens DATEVasp, nur Ziele im Netzwerk des Kunden erreichen. Der Traffic der UCI Anwendungen wird aus diesem Grund über den UCI Proxy im Kundennetzwerk an das entsprechende Ziel, zum Beispiel eine STARFACE Cloud, weitergeleitet. Die STARFACE Cloud kommuniziert entsprechend auf dem gleichen Weg zurück. In der gewünschten UCI Anwendung muss als STARFACE Host entsprechend die IP-Adresse/DNS-Name des UCI Proxy konfiguriert werden.

Einrichtung

Verbinde den UCI Proxy über Port 1 mit dem lokalen Netzwerk. Der UCI Proxy bezieht anschließend eine IP-Adresse über DHCP. Rufe die Webkonfiguration des UCI Proxy über folgende URL auf:

https://[IP-Adresse des UCI Proxy]:4444

• Es öffnet sich der Einrichtungsassistent. Beginne die Konfiguration mit einem Klick auf Weiter

Netzwerk einrichten

Wan Einstellungen (Port 1)

• Aktiviere den Port 1 als WAN-Port, wenn sich das Internet-Gateway in einem anderen Subnetz befindet.

• Aktiviere wahlweise DHCP, wenn der UCI-Proxy seine IP-Adresse automatisch beziehen soll. Alternativ kann eine statische IP-Adresse konfiguriert werden.

Lan Einstellungen Port 2-4

• Konfiguriere hier die IP-Adresse und die Subnetzmaske für dieses Gerät.

DATEV Einstellungen

• Konfiguriere hier die Netzwerkdaten für DATEVasp. Diese werden von DATEV zur Verfügung gestellt.

Wartungsport (Port 5)

• Treten Probleme auf, so kann man den UCI-Proxy immer über LAN-Port 5 unter folgender IP-Adresse erreichen:

https://10.0.0.1:4444

PBX-Einstellungen

PBX Einstellungen

• Wähle bei PBX-Typ aus, mit welcher Telefonanlage kommuniziert werden soll. Alternativ kann auch eine benutzerdefinierte Konfiguration vorgenommen werden.

• Gebe bei Hostname oder IP-Adresse den Hostnamen oder die IP-Adresse der entsprechenden Telefonanlage ein. Der UCI Proxy wird mit einem Klick auf "Weiter" eine zugehörige IP-Adresse aufzulösen, falls vorher ein DNS-Name eingegeben wurde.

Benutzerdefinierte Portkonfiguration

• Gebe bei TCP-Port die Port(s) ein, die vom UCI Proxy weitergeleitet werden sollen. Um Portbereiche zu verwenden, trenne die Portangaben mit einem Bindestrich (z.B. 5000-6000). Mehrere Ports oder Portbereiche können mit einem Komma getrennt angegeben werden (z.B. 5000-6000,7000,8000-8100).

Passwort setzen

• Vergebe ein Passwort für die Anmeldung im Webinterface des UCI-Proxy. Beachte hierbei unbedingt die Komplexitätsanforderungen. (Mindestens 10 Zeichen, sowohl Groß- als auch Kleinbuchstaben)

Known Issues

MIGRATION-TODO: AsciiDoc-Attributblock manuell pruefen: [qanda]

STARFACE App registriert sich erfolgreich, aber bei der Telefonie fehlen die RTP-Daten.:: Die Clients, die aus dem DATEV Netz via Softphone telefonieren sollen, benötigen eine Route zur STARFACE Cloud über den UCI Proxy PowerShell Befehl:

route ADD <IP Adresse der STARFACE>  <IP Adresse UCI Proxy>

MIGRATION-TODO: Automatisch markierte Pruefpunkte:

– AsciiDoc-Attributblock manuell pruefen: [%autowidth]

– AsciiDoc-Tabelle manuell pruefen

– AsciiDoc-Attributblock manuell pruefen: [qanda]