3CX Tapi Kurzanleitung

1. Serverinstallation unter Windows

Bitte führen Sie zunächst dotnet-runtime-5.0.11-win-x64.exe aus.

Führen Sie anschließend den Installer 3cxTapiServer.exe auf Ihrem 3CX Windows-
Host aus.

2. Serverinstallation unter Linux

Für die Installation auf einer Linux 3CX führen Sie "dpkg -i 3cxtapiserver.deb" mit
root-Rechten aus.

3. Konfiguration

Die Konfiguration wird in der Datei 3cxtapisrv.xml vorgenommen. Diese befindet

sich bei einer Windows-Installation im Installationsverzeichnis und bei einer Linux-
Installation im Verzeichnis "/usr/lib/3cxtapiserver". Damit die Änderungen
übernommen werden, muss der Dienst neu gestartet werden. Führen Sie dazu
unter Windows folgende Kommandos aus:
"net stop 3CXTapiSrv"
"net start 3CXTapisrv"

Unter Linux lautet das Kommando:

"service 3cxtapiserver restart"

Bitte geben Sie in der Firewall des 3CX-Hosts die verwendeten TCP-Ports frei.
Die Default-Ports sind 8888, 9998 und 9999.
Die entsprechenden Kommandos lauten für ein Linux-System:

nft add rule inet filter input tcp dport 8888 accept
nft add rule inet filter input tcp dport 9998 accept
nft add rule inet filter input tcp dport 9999 accept
nft list ruleset > /etc/nftables.conf

In der Demoversion ist der Server auf eine Nebenstelle begrenzt und die
Rufnummer für eingehende Anrufe ist statisch "12345678".

3.1 Nebenstellen hinzufügen

<tapisrv>
...
<extensions>
<extension>000</extension>
...
</extensions>
</tapisrv>

3.2 Über ein Hardphone wählen

Um über ein Hardphone direkt ohne Makecall zu wählen fügen Sie bitte den
entsprechenden Nebenstellen das Attribut device="1" hinzu.
Zum Beispiel:
<extension device="1">000</extension>
Mit dieser Einstellung ist es nun nur noch möglich ausgehende Anrufe über das
Hardphone zu initiieren. Diese Funktion unterstützt auch Hotdesking.
Es werden Geräte von Snom, Fanvil und Yealink unterstützt.

3.3 Über den 3CX Webclient V18 wählen

Die Chrome-Exentension "3CX Webclient auto dial" aus dem Chrome Web Store
muss installiert werden.
Wenn alle Voraussetzungen erfüllt sind, kann mittels des Konfigurationseintrags
<extension device="2">000</extension>
der Webclient fernbedient werden.
Diese Funktionalität steht nur in Verbindung mit einer 3CX V18 zur Verfügung.
Bitte stellen Sie sicher, dass der verwendete WSS-Port auf dem 3CX Host
freigegeben ist. Dieser ist 4997 + HTTPS-Port der 3CX. Z.B. 4997 + 5001 = 9998
(Default).

Hinweis: Dieses Feature funktioniert nur in Verbindung mit einem Chrome oder
Edge Browser.

3.4 Über die 3CXDesktopApp V18 wählen

Um diese Funktionalität nutzen zu können, führen Sie bitte

"3cxdesktopapppatch.exe" aus. Dieses Modul überprüft bei jeder
Benutzeranmeldung ob die 3CXDesktopApp bereits den Patch enthält und
installiert diesen gegebenenfalls.". Die 3CXDesktopApp kommuniziert nun
abhängig davon ob die 3CX local oder in der Cloud ist über WS bzw. WSS.
Der WSS-Port entspricht dem aus dem Abschnitt "Über den 3CX Webclient V18
wählen". Der WS-Port ist 4998 + HTTPS-Port der 3CX. Z.B. 4998 + 5001 = 9999
(Default). Sollte keine automatische Ermittlung der Verbindungsparameter möglich
sein, Können diese manuell über die systemweite Umgebungsvariable
"PBX_IP=IP_3CX[:Port]" gesetzt werden. Verwenden Sie hier wie beim Webclient
den Konfigurationseintrag <extension device="2">000</extension>.
Bitte stellen Sie sicher, dass der TCP Port 9999 auf dem 3CX Host freigegeben ist.

3.5 Client-Benachrichtigungen

Um die Netzwerklast zu reduzieren können Client-Benachrichtigungen aktiviert

werden. Erstellen Sie dazu folgenden Eintrag in der 3cxtapisrv.xml:

<tapisrv>
<notify act="1" />

Beachten Sie bitte, dass für die korrekte Funktion der TCP-Port 8889 clientseitig
eingehend freigeschaltet werden muss.

3.6 Client-Authentifizierung

Diese Funktion wird durch den Einttrag

<tapisrv>
 <authenticate act="1" />
aktiviert.
Ab jetzt sind nur noch Client-Verbindungen erlaubt bei denen der Konfigurierte
Schlüssel dem Systemschlüssel des Servers entspricht.

3.7 Einstellung der Verbindungsparameter

Die Verbindungsparameter sind wie folgt einzustellen:

<tapisrv>
<http port="8888" ssl="0"/>
<ws port="9999"/>
<wss port ="9998"/>

Hier sind die Default-Werte dargestellt. Diese können an die entsprechende

Umgebung angepasst werden.
Bitte beachten Sie, dass für ssl="1" auch bei TSP SSL aktiviert werden muss.

4. ClientInstallation

Führen Sie den Installer 3cxTsp.exe auf Ihrem Clientrechner aus.

Nach der erfolgreichen Installation öffnen Sie bitte die "Telefon und Modem"
Konfiguration. Wechseln Sie anschließend auf den Reiter "Erweitert" und betätigen
Sie "Hinzufügen". Wählen Sie hier "3CX Tapi Service Provider". Nun öffnet sich ein
Konfigurationsdialog über den Sie Tapi-Leitungen hinzufügen können.
Konfigurieren Sie hier die gewünschte Nebenstelle und die IP-Adresse des
Servers.
5. Statussynchronisation mit MS Teams

Damit Teams mit der 3CX kommunizieren kann ist es notwendig zusätzlich den
TCP-Port 9997 auf dem 3CX Host freizugeben.
Wenn Sie die Teams Webapplikation verwenden, installieren Sie bitte die Chrome-
Erweiterung "3CX Teams Presence". Geben Sie anschließend in den Optionen der
Erweiterung den FQDN der 3CX und Ihre Nebenstelle an.
Bei Verwendung der Teams Windows-Applikation installieren Sie bitte
"3cxteamspatch.msi". Während der Installation werden Sie aufgefordert den FQDN
der 3CX und Ihre Nebenstelle anzugeben. Geben Sie hier Ihre Daten ein.

Bei der nächsten Windowsanmeldung wird Teams für die Kommunikation mit der
3CX vorbereitet.