Microsoft Teams

You can set up Microsoft Teams users within the Contact Center AI Platform platform to accept calls specifically in the MS Teams platform (instead of Contact Center AI Platform) and to have calls either routed to them directly or through transfers. The MS Teams integration is specifically designed for phone transfers; chat transfers are not supported.

To fully integrate MS Teams with CCAI Platform you need to perform steps in both MS Teams and CCAI Platform. This guide walks you through the necessary steps on both platforms.


In order to correctly link the CCAI Platform Portal to MS Teams, you must have an an account with Global Administrative Permission. The account cannot be a personal MS account.

  • MS Teams Essentials with AAD, E1/E3, A1/A3, F1/F3, or G1/G3 plan.
  • Teams Phone standard licenses.
  • A Microsoft standalone calling plan or third-party PSTN carrier.

SIP Trunking setup

The current iteration of MS Teams integration uses an SIP protocol to connect MS Teams agents to CCAI Platform. SIP ID/URIs are required for integration. You can use the SIP Trunking provider of your choice, but you must follow these basic steps before you can enable the connection to CCAI Platform:

  • Purchase a phone number from the SIP Trunking provider.
  • Add an SIP connection.
  • Assign the purchased phone number to the created SIP connection.
  • Set Outbound Voice Profile.
  • Create Inbound SIP Subdomain (ujet.provider_domain).

User license setup (Microsoft 365)

Complete the following tasks to connect the SIP IDs to Microsoft:

  • Users in Microsoft must be set up with E5 licenses or equivalent.
  • Register the subdomain auto-generated from your SIP Trunking provider.
  • Activate the domain by creating a sub-account.

MS Teams license setup

The following table lists available MS Teams licenses and the add-ons required for integration. You can set up your license in the Microsoft 365 Admin Portal

  1. In the Admin Portal, go to User > Active User.
  2. Select a user to assign a license to. Click the 3 vertical dots next to the user's email address, then click Manage product licenses.
  3. In the User Detail popup, go to Licenses and assign the correct license.
Base plan Add-on required for direct routing
Microsoft Business Basic/Standard/Premium Microsoft 365 Business Voice without Calling Plan
Microsoft Office 365 Enterprise E1/E3/F3/A1/A3 Phone System
Microsoft Office 365 Enterprise E5 No add on required

MS Teams direct routing setup

After SIP is set up and the domain is registered on Microsoft 365, you must now add the SIP Trunking SBC in Direct Routing. You can complete this setup in the Microsoft Teams admin portal, with the alternative option of using PowerShell. These instructions only cover setup using the Teams portal. For a comprehensive reference about configuring Direct Routing in Microsoft Teams, or if you prefer to perform these actions in PowerShell, see the Microsoft Help Center documentation.

Add Direct Routing

  1. Using the left-hand navigation menu, go to Voice > Direct Routing > SBCs and click Add.
  2. Enter a qualified domain name (FQDN) for the Session Border Controller (SBC) and configure appropriate settings for the SBC based on your needs.
  3. Click Save.

Create voice routes and enroll SBC

  1. In the left-hand navigation menu, go to Voice > Direct Routing > Voice routes.
  2. Click Add, then enter a name and description for the voice route.
  3. Set the priority and specify the dialed number pattern.
  4. To enroll an SBC with the voice route, click Add SBCs under SBCs enrolled (optional). Select the SBCs you want to enroll, then click Apply.
  5. (Optional). You can add PSTN (Public Switched Telephone Network) usage records at this point if you want, or you can wait until you have configured the voice routing policy in the following section. To add usage records click Add PSTN usage under PSTN usage records (optional), select the PSTN records you want to add, then click Apply.
  6. Click Save.

Configure voice routing policy and add PSTN Usage Records

  1. In the left-hand navigation menu, go to Voice > Voice routing policies and click Add.
  2. Enter a name and description for the policy.
  3. Go to PSTN usage records > Add PSTN usage, then select the records that you want to add. To create a new PSTN usage record, click Add.
  4. Arrange them in your preferred order, if multiple PSTN records are present.
  5. Click Apply, then Save.

Assign dial plan and voice routing policy

Dial plans are assigned the same way as policies. Policies are assigned either directly to users (individually or at scale through a batch assignment), or to a group that the users are members of.

To create a new dial plan:

  1. In the left-hand navigation menu, go to Voice > Dial plan > Add.
  2. Enter a name and description for the dial plan.
  3. (Optional). Under Dial plan details, specify an external dialing prefix. This is only required if users need to dial one or more additional leading digits (for example, 9) to get an external line. To do this:
    1. In the External dialing prefix box, enter an external dialing prefix. The prefix can be up to four characters (#,*, and 0-9).
    2. Turn on Optimized device dialing. You must turn on this setting in order to make calls outside your organization if you specify an external dialing prefix.
  4. Configure and associate one or more normalization rules for the dial plan under Normalization rules. Each dial plan must have at least one normalization rule associated with it. To do this, do one or more of the following:
    1. To create a new normalization rule and associate it with the dial plan, click Add and then define the rule.
    2. To edit a normalization rule that's already associated with the dial plan, select the rule and then click Edit. Make your desired changes, hen click Save.
    3. To remove a normalization rule from the dial plan, select the rule and click Remove.
  5. Arrange the normalization rules in your preferred order. Click Move up or Move down to change the position of rules in the list.

After setting up a dial plan, you should be able to see the SBCs. The screen might show error messages, but these errors are typically not blocking. If you would like to resolve the error messages, or troubleshoot any errors that might be blocking, reach out to Microsoft Support or your SIP Trunking provider for additional assistance.

Set up SIP for a user

If you do not have a direct SIP URI for each MS Teams Phone System User, you can follow the steps in this section to create one. Be aware that these steps will change the login information for your users when they log into Microsoft 365 and their email.

After Direct Routing is set up, you can create or update a user using the Microsoft 365 portal. Microsoft Calling Plan and Operator Connect phone numbers can be managed only in the Microsoft 365 portal. Direct Routing phone numbers can be managed either in the on-premises Active Directory or in the Microsoft Teams portal. These instructions only demonstrate how to make these edits in the Microsoft 365 and Teams portals.

Change subdomain of the user

  1. Navigate to User > Active User. Select the user, then select Manage username and email.
  2. Set up or change the domain to the domain created from your SIP Trunking provider.

Add a number

  1. Navigate to the Microsoft Teams Admin Portal.
  2. Navigate to Users > Manage Users, then select the specific user.
  3. Under General Information, click Edit.
  4. To assign a phone number, set number type to Direct Routing and enter the phone number you set up with the SIP Trunking Provider.

Set up SIP URI

To make a call to a MS Teams user, the SIP URI on CCAI Platform must be set up with the following configurations:

  1. If the subdomain is changed: {username}@{sip_subdomain}.
  2. If the MS Account is unchanged, and Direct Routing is set up through Teams: {phone_number}@{subdomain}.

Microsoft Azure setup

Set up an Application in MS Azure. This application will allow CCAI Platform to use MS Graph in order to fetch important information such as user info, user presence info, and so on.

Application registration

  1. Log in to MS Azure and search for Azure Active Directory.
  2. On the left-hand side, click on App registration.
  3. Click New registration. Fill out the names and set the Supported account types (accounts in any organizational directory).
  4. Configure the Redirect URI in the following format: {project_domain}/v1/ucaas/ms_teams/oauth_callback.
  5. After the app has been registered, you will be able to see the Application (client) ID by clicking on the Application in App registrations. Make a note of this ID value.

Client secret

  1. After you have registered an application, go to Manage > Certificates > Secrets in the left-hand navigation menu.
  2. Click on the Client secrets tab and click New client secret.
  3. Fill out the description and expiration date. The max expiration date for the client secret is 24 months. This value reflects when the client secret will expire from Azure. This value must be the same in CCAI Platform for the integration to function properly.
  4. After the secret has been generated, you will be ableo to see the value of the secret. Save this value in a secure location for later; it is only available temporarily, and if you lose the value you will need to generate another client secret.

Contact Center AI Platform setup

Configurations are done under the label of UCaaS rather than MS Teams specifically. UCaaS integration is similar to setting up a CRM. MS Teams does not support transfers for groups or teams, so you will need to configure each user individually.


In order to make a call to a MS Teams user, the SIP URI on CCAI Platform must be set up with the following configurations:

  • If the subdomain is changed: {username}@{sip_subdomain}.
  • If the MS Account is unchanged, and Direct Routing is set up through Teams: {phone_number}@{subdomain}.
  1. In the CCAI Platform Portal, go to Developer Settings > UcaaS.
  2. Use the dropdown menu to select your UcaaS platform (Microsoft Teams).
  3. Click Save. This will expose the other fields you need to fill out.
  4. Set Connected App ID and Connected App Secret to the App (client) ID value and client secret value you created in Azure.
  5. Click the Link button to connect the platforms. If you try to click Save before clicking the Link button, you will get an error message.
    1. If the link is successful, you will see a confirmation banner.
    2. If the link is unsuccessful, you will see a warning banner. The most likely reason for a failed link is incorrect credentials. Check for typos, or copy/paste if possible to ensure accuracy.
    3. Once the link is created, the button will change to an Unlink button. If you need to unlink the token, click the Unlink button.
  6. Set your multicast limit. The current limit is 100 external agents.
  7. Click Save.

Configure MS Teams users in CCAI Platform User Settings

MS Team users can be configured as an external UCaaS users in the Add User or Bulk User Management settings. You can add users individually by following the steps below or you can import them in bulk.

When a user is added, they will need to activate their account using an email link to complete the process. For more detailed information on adding users, see the Add and view users and Bulk user management documentation.

Add a user

  1. To add a user and enable them in UCaaS, go to Settings > Users > Teams > +Add a User.
  2. Enter the required fields.
  3. Check the External UCaaS user box, which will expose two required fields.
  4. Enter the SIP URI/ID and UCaaS username for the user.
  5. Click Add.

Edit a user

  1. To enable UCaaS for an existing user, click the pencil icon next to the user's name in Settings > Users > Teams.
  2. Check the External UCaaS user box, which will expose two required fields.
  3. Enter the SIP URI/ID and UCaaS username for the user.
  4. Click Update.

Bulk User Management

The template for configuring your spreadsheet for import to CCAI Platform as a .csv file can be found in the bulk user management documentation. Three fields (External User, External SIP URI, and UCaaS username) are available for UCaaS settings. There is also a field for restricting international calling. If you are updating an existing spreadsheet, be sure to account for these changes when you add new users.

Agent status inheritance

A change required to permit status changes in the Teams environment is found under Settings > Developer Settings > Agent Status Inheritance. A UCaaS option is available to allow the relevant CCAI Platform agent statuses to be reflected correctly in the Teams environment, and allow you to configure your preferences regarding how the statuses are prioritized between the two platforms.

Status inheritance at login

It is typically expected that MS Teams agents will not be logged into both CCAI Platform and MS Teams simultaneously, therefore it is expected that the agent will skip wrap-up altogether and go to the next status (Available). However, there are some instances where being logged into both platforms might be necessary. In those instances, the agent will go through wrap-up as they normally do. In the event the agent must be logged into CCAI Platform exclusively (such as during a Teams outage), their wrap-up and available statuses are handled as if they are a normal CCAI Platform agent.

Option Expected Behavior
Do not inherit status at login The CCAI Platform status is prioritized over the Teams agent status.
Apply UCaaS agent status at login When agents login to CCAI Platform, they will start off in the CCAI Platform status that their current UCaaS status is mapped to.
UCaaS always overrides agent's next status Even if the agent sets their next status in CCAI Platform, their UCaaS status will override the CCAI Platform next status.

Configure agent availability

Teams users can optionally be added to queues. CCAI Platform users will have the ability to transfer these calls to Teams users as an External transfer type. External agents don't have to be added to queues to be available for transfers. The transferred call receiver who is using MS Teams will not be linked with the CRM, so if they need to make additions to a case, they will need to take ownership of the case (if required by your process or CRM) and make notes within the case manually.

Add Teams users to queues

When you make changes to existing queues or creating new ones, you can identify your Teams users by the Teams icon next to their name. For detailed information about creating or editing existing queues see the queue and menu setup documentation.

Test outputs

Agents should see the option to transfer to queues and individuals with MS Teams profiles after you have made your configurations. If an external agent is assigned to a queue, then they will receive a call when it comes to that queue or when another agent transfers a call to that queue. There will be an indication in the transfer UI if the agent is external or if the queue contains external agents. External agents will be available for transfer regardless of whether they are assigned to a queue or not.

When you monitor agents' statuses, it is expected behavior to see the Teams users' statuses alongside the CCAI Platform users' statuses. There is no distinguishing indicator between which platform they are using, though you might be able to use the email field to make that distinction depending on the choices you make during configuration.

In MS Teams, users will be able to receive transfers as long as they are configured to receive CCAI Platform transfers and are in an Available status. Incoming calls from CCAI Platform look like other incoming calls to Teams and are handled normally. The only thing a user should keep in mind is that the call is no longer connected to the CRM once it's transferred to Teams, so case handling within the CRM needs to be handled manually. Your company's case handling guidelines should determine whether a new case should be created or whether the user should manually take over the case to add notes, rather than the functionality of the tool.