# Integrate the Cloud Voice App Desktop Client with TAPI

TAPI (Telephony Application Programming Interface) lets Windows programs place calls through a phone system. Cloud Voice provides a TAPI driver you install on your PC and pair with the Cloud Voice App. Once it is in place, you can click a phone number in a TAPI-enabled application, such as your CRM, and the call is dialed for you through the Cloud Voice App, so there is no need to key numbers in by hand.

:::note
TAPI integration works only with the **Cloud Voice App Desktop Client for Windows**.
:::

## Before you begin

Confirm the following are in place:

- **Cloud Voice platform**: Version `84.20.0.128` or later. IZT keeps the hosted platform current, so most accounts already meet this.
- **Cloud Voice App (Windows Desktop)**: Version `1.16.4` or later.
- **Windows operating system** (all 64-bit): Windows 7, Windows 8, Windows 8.1, Windows 10, Windows 11, Windows Server 2008 R2, Windows Server 2012 R2, Windows Server 2016, or Windows Server 2019.

## Install the TAPI driver

First download the driver from the Cloud Voice App, then run its installer on your PC.

1. Sign in to the Cloud Voice App and open **Preferences > Integration**.
2. In the top-right corner of the **TAPI Integration** section, select **TAPI Driver Download**. The driver's setup file is saved to your PC.

   
   ![Cloud Voice, the TAPI Driver Download control in the Integration preferences](/images/pbx/tapi-driver-download.png)

3. Open the setup file you downloaded and work through the installer:

   1. Choose your language.

      ![Language selection prompt shown when the TAPI driver installer starts](/images/pbx/tapi-driver-lang.png)

   2. Select **Next**.

      
      ![Cloud Voice, the opening screen of the TAPI driver installer](/images/pbx/tapi-start-install-1.png)

   3. List one or more extensions that are allowed to use the TAPI integration, then select **Install**.

      :::note
      This setup page accepts up to **5** extensions. To allow more lines, edit the driver's configuration files after installation, as described in [(Optional) Add more TAPI lines](#optional-add-more-tapi-lines).
      :::

      ![Table for entering the extensions permitted to use the TAPI integration](/images/pbx/multiple-lines-on-tapi.png)

      - **Extension Number**: Enter the extension number.
      - **Name**: Enter a label that helps you recognize the extension. Only letters, numbers, and spaces are permitted.

   4. When the installer finishes, select **Finish** to close it.

      
      ![Cloud Voice, the final screen of the TAPI driver installer](/images/pbx/tapi-prompt.png)

   5. Select **OK** in the confirmation window.

      
      ![Cloud Voice, confirmation dialog shown after the driver installs](/images/pbx/tapi-confirm-1.png)

4. Restart the Cloud Voice App.

## Verify the installation

Use the Windows Phone and Modem settings to confirm the driver registered correctly.

1. Press **Win** + **R** to open the Run window.
2. Type `telephon.cpl` and press **Enter** to open the **Phone and Modem** window. On the **Advanced** tab, look at the **Providers** list. If **Cloud Voice TAPI Service Provider** appears there, the driver installed successfully.

   
   ![Cloud Voice, the Providers list on the Advanced tab of Phone and Modem](/images/pbx/tapi-driver-in-phone-and-modem.png)

## (Optional) Add more TAPI lines

To let additional extension users take advantage of the integration, add lines to the driver's configuration file.

1. In the **Phone and Modem** window, select **Cloud Voice TAPI Service Provider**, then select **Configure**. The driver's `config.ini` file opens automatically.

   
   ![Cloud Voice, the Configure button for the TAPI service provider](/images/pbx/configure-tapi-ini.png)

2. Copy the structure of the existing entries to add as many lines as you need, then save the file.

   :::note
   For the best performance, keep the total to no more than **50** lines in the configuration file.
   :::

   ![The config.ini file with additional TAPI line entries](/images/pbx/add-more-tapi-line.png)

3. Restart the Telephony service so the changes take effect:

   1. Press **Win** + **R** to open the Run window.
   2. Type `services.msc` and press **Enter** to open the **Services** window.
   3. Right-click the **Telephony** service and select **Restart**.

## Make a test call

Place a test call to confirm the driver is working. The steps below use the built-in Windows **Phone Dialer** as the calling application.

**Prerequisites**

- You are signed in to the Cloud Voice App.
- The **Dial out immediately** option is turned on in the Cloud Voice App.

  
  ![Cloud Voice, the Dial out immediately setting enabled](/images/pbx/enable-dial-out-immediately.png)

  :::note
  With **Dial out immediately** turned on, a number handed to the app from Phone Dialer (or your CRM) is placed straight away instead of only filling in the dial pad. Leave it off and each click-to-call waits for you to confirm before it rings.
  :::

- If another driver or app is currently set as the default calling app on your PC, change it to the Cloud Voice App.

  :::caution
  If a different program stays set as the default calling app, a click-to-call opens that program instead of the Cloud Voice App and the call will not go out through your extension. Set the Cloud Voice App as the default before you test.
  :::

**Procedure**

1. Press **Win** + **R** to open the Run window.
2. Type `dialer.exe` and press **Enter** to open the **Phone Dialer** window.
3. On the top menu, select **Tools > Connect Using...**.

   ![The Connect Using command under the Tools menu in Phone Dialer](/images/pbx/tapi-dialer-tool.png)

4. From the **Line** drop-down list, select the extension you want to use, then select **OK**.

   ![The Line drop-down list in the Phone Dialer connection settings](/images/pbx/tapi-dialer-line-setting-1.png)

   When that extension is signed in to the Cloud Voice App, the TAPI integration status shows **Connected** (in **Preferences > Integration > TAPI Integration**), and numbers entered in the Dialer are placed through this line.

   ![The TAPI integration status showing as Connected](/images/pbx/pc-tapi-connected.png)

5. In the **Number to dial** field, enter a phone number and select **Dial**.

   ![Entering a number in the Phone Dialer and selecting Dial](/images/pbx/tapi-dialer.png)

   The Cloud Voice App opens and starts the outgoing call.

   
   ![Cloud Voice, an outgoing call placed through the TAPI driver](/images/pbx/tapi-call.png)