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.

   

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

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.

   

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

   

   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.

   

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 and enabled Single Sign-on for Microsoft accounts.

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

   

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.

   

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 to launch the Cloud Voice web app.

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

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.

   

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.

   

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.

   

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.