# Desktop-App über TAPI integrieren TAPI (Telephony Application Programming Interface) ist die Windows-Schnittstelle, über die Programme Telefonanrufe steuern können. Mit dem TAPI-Softwaretreiber verbinden Sie den Cloud Voice App Desktop-Client (Windows) mit TAPI-fähigen Anwendungen. So starten Sie Anrufe per Klick direkt aus Programmen wie Ihrem CRM (Customer Relationship Management) heraus, ohne Rufnummern von Hand einzugeben. Das spart Zeit, senkt die Fehlerquote und steigert die Produktivität. :::note Die TAPI-Integration steht ausschließlich für den **Cloud Voice App Desktop-Client (Windows Desktop)** zur Verfügung. ::: ## Voraussetzungen - **PBX-Server** (Private Branch Exchange, die Telefonanlage): Version 84.20.0.128 oder neuer - **Cloud Voice App Desktop-Client (Windows Desktop)**: Version 1.16.4 oder neuer - **Windows-Betriebssystem**: Windows 7, Windows 8, Windows 8.1, Windows 10 oder Windows 11 (jeweils 64-Bit) ## TAPI-Treiber installieren Laden Sie den TAPI-Treiber im Cloud Voice App Desktop-Client herunter und installieren Sie ihn auf Ihrem PC. :::caution Für die Installation des Treibers und für den späteren Neustart des Telefondienstes benötigen Sie auf dem PC lokale Windows-Administratorrechte. Ohne diese Rechte schlägt die Installation fehl. ::: 1. Melden Sie sich am Cloud Voice App Desktop-Client an und öffnen Sie **Preferences > Integration**. 2. Klicken Sie oben rechts im Bereich **TAPI Integration** auf **TAPI Driver Download**. ![Cloud Voice, Schaltfläche TAPI Driver Download im Integrationsbereich der Einstellungen](/images/pbx/tapi-driver-download.png) Die Datei **CloudVoiceTAPISetup.exe** wird auf Ihren PC heruntergeladen. 3. Öffnen Sie **CloudVoiceTAPISetup.exe** und wählen Sie die gewünschte Sprache aus. ![Sprachauswahl des TAPI-Installationsprogramms](/images/pbx/tapi-driver-lang.png) 4. Klicken Sie auf **Next**. ![Cloud Voice, Startseite des TAPI-Installationsprogramms mit der Schaltfläche Next](/images/pbx/tapi-start-install-1.png) 5. Tragen Sie eine oder mehrere Nebenstellen ein, die die TAPI-Integration nutzen dürfen, und klicken Sie anschließend auf **Install**. ![Eingabefelder für Nebenstellennummer und Name während der Installation](/images/pbx/multiple-lines-on-tapi.png) - **Extension Number**: Geben Sie die gewünschte Nebenstellennummer ein. - **Name**: Vergeben Sie einen Namen, der die Nebenstelle eindeutig kennzeichnet. Erlaubt sind nur Buchstaben, Zahlen und Leerzeichen. :::note Auf dieser Seite lassen sich standardmäßig bis zu 5 Nebenstellen eintragen. Benötigen Sie mehr Leitungen, ergänzen Sie diese nach der Installation in den Konfigurationsdateien des Treibers (siehe Abschnitt **Weitere TAPI-Leitungen hinzufügen** weiter unten). ::: 6. Klicken Sie nach Abschluss der Installation auf **Finish**, um das Installationsprogramm zu schließen. ![Cloud Voice, Abschlussseite des Installationsprogramms mit der Schaltfläche Finish](/images/pbx/tapi-finish-install.png) 7. Bestätigen Sie das eingeblendete Fenster mit **OK**. ![Cloud Voice, Bestätigungsdialog nach der Treiberinstallation](/images/pbx/tapi-confirm-1.png) ## Installation überprüfen So stellen Sie fest, ob der Cloud Voice TAPI-Treiber korrekt installiert wurde. 1. Drücken Sie **Win** + **R**, um das Ausführen-Fenster zu öffnen. 2. Geben Sie `telephon.cpl` ein und drücken Sie die Eingabetaste. Das Fenster **Phone and Modem** öffnet sich. Wechseln Sie auf den Tab **Advanced**. Erscheint dort der **Cloud Voice TAPI Service Provider** in der Anbieterliste, wurde der Treiber erfolgreich installiert. ![Cloud Voice, TAPI-Dienstanbieter in der Anbieterliste unter Phone and Modem](/images/pbx/tapi-driver-in-phone-and-modem.png) ## Weitere TAPI-Leitungen hinzufügen Sollen weitere Nebenstellenbenutzer die Integration nutzen, ergänzen Sie zusätzliche Leitungen in der Konfigurationsdatei des Treibers. 1. Markieren Sie im Fenster **Phone and Modem** den **Cloud Voice TAPI Service Provider** und klicken Sie auf **Configure**. ![Cloud Voice, Schaltfläche Configure zum Öffnen der Treiberkonfiguration](/images/pbx/configure-tapi-ini.png) Die Konfigurationsdatei `config.ini` des Treibers wird automatisch geöffnet. 2. Ergänzen Sie in der Datei so viele Leitungen wie nötig und orientieren Sie sich dabei an der Struktur der vorhandenen Einträge. Speichern Sie die Datei anschließend. :::note Für eine optimale Leistung empfehlen wir, über die Konfigurationsdatei höchstens **50** Leitungen hinzuzufügen. ::: ![Zusätzliche Leitungen in der Konfigurationsdatei config.ini](/images/pbx/add-more-tapi-line.png) 3. Starten Sie den Telefondienst neu, damit die Änderungen wirksam werden. :::caution Der Neustart des Windows-Telefondienstes (Telephony) kann laufende telefoniebasierte Anwendungen unterbrechen. Führen Sie ihn möglichst dann durch, wenn keine Anrufe aktiv sind. ::: 1. Drücken Sie **Win** + **R**, um das Ausführen-Fenster zu öffnen. 2. Geben Sie `services.msc` ein und drücken Sie die Eingabetaste, um das Fenster **Service** zu öffnen. Suchen Sie den Telefondienst (Telephony), klicken Sie mit der rechten Maustaste darauf und wählen Sie **Restart**. ## Testanruf durchführen Mit einem Testanruf prüfen Sie, ob der Cloud Voice TAPI-Treiber funktioniert. Im folgenden Beispiel löst die Windows-Wählhilfe (Phone Dialer) einen Anruf über den Treiber aus. **Voraussetzungen** - Sie sind am Cloud Voice App Desktop-Client angemeldet. - Die Option **Dial out immediately** ist im Desktop-Client aktiviert. ![Cloud Voice, aktivierte Option Dial out immediately im Desktop-Client](/images/pbx/enable-dial-out-immediately.png) - Ist auf Ihrem PC bereits eine andere Standard-Anruf-App oder ein anderer Treiber eingerichtet, legen Sie stattdessen die Cloud Voice App als Standard-Anruf-App fest. :::tip Ist einer dieser Punkte nicht erfüllt (Nebenstelle nicht angemeldet, **Dial out immediately** deaktiviert oder eine andere App als Standard), wird der Testanruf nicht über die Cloud Voice App aufgebaut. Prüfen Sie diese Punkte, bevor Sie wählen. ::: **Vorgehensweise** 1. Drücken Sie auf Ihrem PC **Win** + **R**, um das Ausführen-Fenster zu öffnen. 2. Geben Sie `dialer.exe` ein und drücken Sie die Eingabetaste, um das Fenster **Phone Dialer** zu öffnen. 3. Klicken Sie im oberen Menü auf **Tools** und wählen Sie **Connect Using…**. ![Menü Tools der Windows-Wählhilfe mit dem Eintrag Connect Using](/images/pbx/tapi-dialer-tool.png) 4. Wählen Sie im Dropdown-Menü **Line** die gewünschte Nebenstelle aus und klicken Sie auf **OK**. ![Auswahl der Leitung im Dropdown-Menü Line](/images/pbx/tapi-dialer-line-setting-1.png) Sobald die ausgewählte Nebenstelle am Cloud Voice App Desktop-Client angemeldet ist, wird die TAPI-Integration mit dem Status **Connected** angezeigt. Über diese Leitung gewählte Nummern werden dann über diese Nebenstelle angerufen. ![TAPI-Integration mit dem Status Connected](/images/pbx/pc-tapi-connected.png) 5. Geben Sie im Feld **Number to dial** eine Rufnummer ein und klicken Sie auf **Dial**. ![Rufnummer im Feld Number to dial der Windows-Wählhilfe](/images/pbx/tapi-dialer.png) Der Cloud Voice App Desktop-Client wird gestartet und baut den ausgehenden Anruf auf. ![Cloud Voice, ausgehender Anruf, der über den TAPI-Treiber gestartet wurde](/images/pbx/tapi-call.png)