====== TAPI ======
==== ====== Vorbereitungen ====== ====
Folgende Einstellungen müssen für **untermStrich TAPI** in der **untermStrich-Software** beachtet werden:

Bei den untermStrich-Benutzern muss eine Nebenstelle (DW) und ein Standort angegeben werden. Diese Eingaben können Sie im Modul **Team** in der Registerkarte **Grunddaten** tätigen.


Folgende globale Telefoneinstellungen sind im Modul **Konfiguration** im Bereich **System** - **Telefon** vorzunehmen bzw. zu überprüfen:

**Wählprefix:**
Für die Externwahl kann eine Amtsnummer erforderlich sein, wenn Sie keine automatische Amtsholung in der Telefonanlage eingestellt haben. Ist dies der Fall, können Sie hier die Amtsnummer eintragen.

**Prefix bei eingehenden Anrufen entfernen:**
Es kann vorkommen, dass die Amtsnummer (Prefix) am Beginn der Rufnummern bei externen Gesprächen in der Protokollierung zusätzlich angefügt wird. Mit Aktivierung dieser Option wird diese aus den Rufnummern entfernt.

**Beim Zugriff des TAPI-Clients auf den untermStrich REST-Service ungültige Zertifikate akzeptieren:**
Wird für die untermStrich-Software **SSL** verwendet, kann der Connector eine Verbindung zur REST-Schnittstelle nur dann erfolgreich herstellen, wenn das SSL-Zertifikat gültig ist. Sie können eine Verbindung aber auch mit ungültigem oder abgelaufenem Zertifikat herstellen, indem Sie diese Option aktivieren.


In der untermStrich-Software sollten folgende Butler installiert werden (im Modul **Konfiguration** - **Allgemein** - **Butler Aktualisierung / Installation**):

**CRM** (Anzeige der Anrufprotokollierung inklusive Kontakthistorie)
https://webservices.untermstrich.com/h2/de:basics:basics:butler:crm

**untermStrich Realtime Server** (für die Echtzeitanzeige der Anrufe).
Der Realtime Server wird ab der untermStrich-Version 12.10 nicht mehr benötigt.
https://webservices.untermstrich.com/h2/de:basics:basics:butler:realtime_server


=== Eingehenden Anruf in einem Popup-Fenster anzeigen: ===

Eingehende Anrufe können in einem Fenster angezeigt werden, auch wenn das Browser-Fenster im Hintergrund oder minimiert ist. Dazu müssen Sie auf jedem Rechner die **[[de:user:start#termin-_aufgabenerinnerung_und_mitteilungen|Desktop Notification]]** konfigurieren:
Modul **Benutzer** in der Registerkarte **Termin-, Aufgabenerinnerung und Mitteilungen**.
  * Beachten Sie unbedingt die [[de:faq:notification_chrome|Informationen zu Google Chrome, wenn Sie untermStrich ohne ''https:'' nutzen]].

Diese Funktionalität wird von Google Chrome, Firefox und Safari unterstützt.

Zusätzlich muss der **untermStrich Realtime Server** gestartet sein (wird ab der untermStrich-Version 12.10 nicht mehr benötigt).

=== TAPI-Leitung (TAPI-Line): ===
Auf den Arbeitsplätzen muss eine **TAPI-Leitung (TAPI-Line)** mit der entsprechenden Nebenstelle funktionsfähig eingerichtet sein.

:!: Es darf mit der entsprechenden Nebenstelle nur eine TAPI-Line existieren!

:!: Es ist nicht bei jeder auf dem Markt befindlichen Telefonanlage, die nach Angabe des Herstellers die TAPI-Schnittstelle unterstützt, sichergestellt, dass jede einzelne Funktion ordnungsgemäß läuft. Die untermStrich Software GmbH ist darauf angewiesen, dass die TAPI-Funktionen vom jeweiligen TK-Anlagen-Hersteller dem Standard entsprechend implementiert sind.

Mit der Windows-Wählhilfe (dialer.exe) kann überprüft werden, ob die TAPI-Line korrekt eingerichtet ist:
{{:de:tapi:tapi:waehlhilfe_01.png?nolink|}}


:!: Die Verwendung von **TLS 1.1** oder **TLS 1.2** erfordert **Microsoft .NET Framework 4.5** oder höher.

:!: Wenn ein **Proxyserver** eingesetzt wird, darf die untermStrich-URL diesen nicht verwenden. In diesem Fall muss die untermStrich-URL in den Proxy-Ausnahmen des Browsers und in Windows eingetragen werden.

:!: Der untermStrich Connector 4VX muss gestartet und aktiv sein.

:!: Wird der **untermStrich Connector 4VX** mit einem **Port** gestartet (wenn z.B. mehrere untermStrich-Datenbanken gleichzeitig verwendet werden), ist die TAPI-Funktionalität standardmäßig inaktiv. Wenn Sie untermStrich TAPI aktivieren möchten, müssen Sie in der Datei **TAPI.ini** (diese befindet sich im Ordner C:\ProgramData\untermStrich Software GmbH\TAPI) für den entsprechenden Connector-Port (im Screenshot blau markiert) einen beliebigen, freien **Dialer-Port** angeben.

{{:de:tapi:tapi:tapi_13.png?nolink|}}

Der **Dialer-Port** kann auch automatisch vergeben werden, indem Sie den Wert für **Dialer_Port** auf 0 setzen und einen Wert für **IncrementPortValue** angeben. Der **Dialer-Port** ist dann die Summe aus **Connector-Port** und **IncrementPortValue**.
Jeder Port (Connector- und Dialer-Port) darf nur einmal vergeben werden. Deshalb sollte, wenn der Dialer-Port automatisch generiert wird, für **IncrementPortValue** ein hoher Wert (z.B. 500) angegeben werden, damit sich die Ports nicht überschneiden und eindeutig sind.


:!: untermStrich TAPI mittels Connector 4VX kann nicht gleichzeitig mit der **untermStrich TAPI Server-Version** verwendet werden. Wird untermStrich TAPI Server bereits eingesetzt, und Sie möchten stattdessen die Telefonie-Funktionalität des Connectors (also lokal auf den Arbeitsplätzen) nutzen, müssen Sie untermStrich TAPI Server deinstallieren und die Option **TAPI Server** beim entsprechenden Firmenstandort (in der untermStrich-Software im Modul **Konfiguration** im Bereich **Team** - **Firmenstandorte**) deaktivieren.