# Integrate Cloud Voice with Microsoft Teams

The Teams integration is set up per person: each user adds the Cloud Voice App to their own Microsoft Teams client and signs in with either a Cloud Voice extension or a Microsoft account. Once connected, you can make, answer, and control calls straight from Teams. The steps below walk a single user through the whole process.

## Before you begin

Have the domain name of your Cloud Voice web app on hand. Your administrator can provide it if you don't already know it, and you enter it partway through setup.

## Step 1: Add the Cloud Voice App to Teams

1. Sign in to Microsoft Teams.
2. In the left sidebar, select **Apps** and search for **Cloud Voice App**.

   
   ![Cloud Voice, the Teams Apps panel with the Cloud Voice App in the search results](/images/pbx/search-for-yeatsar-linkus-in-teams.jpg)

3. In the results, select **Cloud Voice App** and click **Add**. Teams opens a new tab where you can reach the Cloud Voice web app and sign in.

## Step 2: Open Cloud Voice inside Teams

![Cloud Voice, the Phone Extension tab where you enter your web app domain](/images/pbx/access-pbx-in-teams-pce.jpg)

1. On the **Phone Extension** tab, type the domain name of your Cloud Voice web app.
2. Click **Access the PBX**. The sign-in page opens.

## Step 3: Sign in

Choose one of the two sign-in methods below.

### Sign in with a Cloud Voice extension

1. Enter your extension credentials, then click **LOG IN**:
   - **Username**: the email address tied to your extension.
   - **Password**: your extension password.

   
   ![Cloud Voice, the sign-in page with the username and password fields](/images/pbx/log-in-to-teams-pce.jpg)

2. If two-factor authentication is enabled on your extension, supply a verification code.

   
   ![Cloud Voice, the two-factor authentication prompt with a Trusted Device option](/images/pbx/2-factor-authentication.jpg)

   1. Enter the code from your authenticator app or email.
   2. (Optional) Select **Trusted Device**.

      :::note
      On the device you sign in from most often, marking it as a trusted device lets you skip the verification code on that device for the next 180 days.
      :::

   3. Click **LOG IN**.

3. When the prompt appears, decide whether to let Cloud Voice notify you of incoming chat messages and calls.

   
   ![Cloud Voice, the prompt asking whether to allow call and chat notifications](/images/pbx/teams-notification-prompt.jpg)

### Sign in with a Microsoft account

:::caution
This method is available only when both of these are true:

- Your Cloud Voice web app is hosted on a supported cloud domain.
- Your administrator has [integrated Cloud Voice with Microsoft Entra ID](/pbx/integrations/azure-ad/integrate-cloud-voice-cloud-voice-with-azure-active-directory/) and [enabled Single Sign-on](/pbx/integrations/azure-ad/allow-users-to-log-in-to-cloud-voice-app-uc-clients-with-sso/) for Microsoft accounts.
:::

1. On the sign-in page, click **Sign in with Microsoft**.

   
   ![Cloud Voice, the sign-in page with the Sign in with Microsoft button](/images/pbx/sso-pce-teams.jpg)

2. In the pop-up window, sign in with your Microsoft account.
3. When the prompt appears, decide whether to let Cloud Voice notify you of incoming chat messages and calls.

   
   ![Cloud Voice, the prompt asking whether to allow call and chat notifications](/images/pbx/teams-notification-prompt.jpg)

## Step 4: Choose a calling endpoint

You control calls from within Teams, but the call audio runs through an endpoint you enable for CTI (Computer Telephony Integration, the link that lets Teams drive calls placed and answered on another device). Pick the endpoint that suits how you work: the Cloud Voice App (Web), the Cloud Voice App (Desktop), or a desk phone.

:::note
Only the endpoint you enable handles the call audio. Teams stays the place where you start, answer, and control the call, while the ringing and talking happen on the endpoint you pick here.
:::

### Cloud Voice App (Web)

In the top-right corner, click the open control ![Open web app](/images/pbx/open-web-client.png) to launch the Cloud Voice web app.

![The open-web control in the top-right corner of the Teams panel](/images/pbx/teams-open-web.png)

The call-status indicator then changes to show that CTI control is active, meaning the web app now handles your calls.

![The Teams panel confirming CTI control is active for the web app](/images/pbx/teams-cti-web.png)

### Cloud Voice App (Desktop)

1. Update the Cloud Voice App (Desktop) to version 1.5.4 or later.

   :::caution
   CTI control needs Cloud Voice App (Desktop) version 1.5.4 or later. On an older version the desktop app will not respond to call control from Teams, so update it before signing in.
   :::

2. Sign in to the desktop app with your extension. The call-status indicator changes to the CTI icon, confirming the desktop app now handles your calls.

   ![The Teams panel confirming CTI control is active for the desktop app](/images/pbx/teams-cti-pc.png)

### Desk phone

1. Use a Yealink, Fanvil, or Snom IP phone whose model and firmware version meet the CTI supported-device requirements.
2. Register your extension on the phone. The call-status indicator changes to the phone icon, confirming the desk phone now handles your calls.

   ![The Teams panel confirming CTI control is active for a desk phone](/images/pbx/teams-cti-phone.png)

## Step 5 (optional): Pin Cloud Voice to the Teams sidebar

Pin the app to keep it one click away in Teams.

1. In the left sidebar, right-click **Cloud Voice App**.
2. Click **Pin**. The app stays fixed to your Teams sidebar.

   ![The right-click menu with the Pin option for the Cloud Voice App in Teams](/images/pbx/pin-linkus-for-teams.jpg)

## What you can do now

The integration is live. You can place and answer internal and external calls through your phone system without leaving Microsoft Teams.