Connect Dynamics 365 Contact Center using Teams Phone extensibility

Teams Phone extensibility connects a Microsoft Dynamics 365 Contact Center voice channel to Live Hub through your Microsoft Teams tenant. Calls to your contact center phone number travel through Live Hub to Microsoft Teams, and Teams delivers them to the Dynamics 365 voice channel. For Microsoft's description of the capability, refer to Microsoft's Teams Phone extensibility overview.

Teams Phone extensibility is the recommended method for new deployments. Existing users of Azure Communication Services may continue to use it until Microsoft retire the service. See Microsoft Dynamics 365.

An inbound call follows this path:

  1. A customer dials your contact center phone number.
  2. Live Hub receives the call and routes the call to your Teams tenant over Direct Routing.
  3. Microsoft Teams delivers the call to the resource account that the phone number is assigned to.
  4. Dynamics 365 Contact Center, which is linked to that resource account, presents the call to an agent through the voice channel.

Complete the following steps in order. Each step depends on the one before it.

Then verify the configuration.

Prerequisites

Prepare the following before you start. Having them ready avoids delays partway through the configuration.

Administrator roles

Product Role Needed to
Microsoft Teams Teams Administrator or Teams Telephony Administrator Create the resource account and sync the resource account to Dynamics 365
Microsoft 365 User Administrator or higher Assign licenses
Live Hub Administrator access to your Live Hub account Connect the tenant and create the routing rule
Dynamics 365 Contact Center Administrator access, with the voice channel already configured Connect the resource account to the voice channel

Licenses

Two Microsoft licenses are needed:

Do not assign a license that includes Teams Phone Standard (service plan MCOEV) to the resource account. The resource account needs only the Microsoft Teams Phone Resource Account license.

Phone number

The phone number is the number your customers call to reach the Dynamics 365 voice channel. Use either of the following:

The number must be in E.164 format, for example +12505550123.

Create the Teams resource account

A resource account is a non-user account in Microsoft Teams that represents a phone number used by a service rather than by a person. Dynamics 365 Contact Center needs one resource account for each phone number it uses, so create the resource account first: every later step refers to it.

To create a resource account in the Microsoft Teams admin center:

  1. Sign in to the Microsoft Teams admin center.
  2. In the navigation pane, expand Voice.
  3. Select Resource accounts.
  4. Click Add.

    The Add resource account pane opens.

  5. In the 'Display name' field, enter a descriptive name, for example Contact Center Main Line.

  6. In the 'Unique Username' field, enter the username. The username becomes the first part of the account's user principal name (UPN).
  7. From the 'Domain name' list, select your organization's own domain. The domain becomes the part of the UPN after the @ sign. Do not select the domain that ends in livehub.audiocodes.io, which Live Hub adds to your tenant.
  8. From the 'Resource account type' list, select Auto attendant.
  9. Click Save.

    The resource account is created and appears under Voice > Resource accounts. Note the full username, for example contactcenter@contoso.com. You need the username to find the resource account in Live Hub and in Dynamics 365.

For more information about resource accounts, refer to Microsoft's Manage resource accounts article.

Assign the resource account license

A new resource account has no license, and the resource account cannot receive calls until one is assigned. Assign the license as soon as the resource account exists.

To assign the Microsoft Teams Phone Resource Account license:

  1. Sign in to the Microsoft 365 admin center.
  2. In the navigation pane, select Users > Active users.
  3. Select the resource account.

    The account details pane opens.

  4. Select the Licenses and apps tab.

  5. Check that 'Select location' is set to the country of the phone number that you assign to this resource account.
  6. Under Licenses, select Microsoft Teams Phone Resource Account.
  7. Click Save changes.

Connect your Teams tenant to Live Hub

Connecting your tenant makes Live Hub the Direct Routing SBC for your Teams tenant. The procedure is the same as for any Teams tenant, so work through the following pages in order. One choice is specific to Dynamics 365: the 'Number of users' value.

  1. Verify license availability.
  2. Create an app registration in Azure, and assign it the roles listed in Required roles for the app registration.
  3. Connect a Teams tenant in Live Hub. In the 'Number of users' field, enter 1. The resource account represents the voice channel rather than an end user, and Dynamics 365 uses a single phone number and resource account in this scenario.
  4. Create a Teams connection.

After you create the Teams connection, wait about 1 hour before you continue. Microsoft needs this time to replicate your tenant information, including the new resource account, into Live Hub, and the time is approximate because Microsoft controls it. If you continue earlier, the resource account may not yet appear in Live Hub.

Assign the phone number to the resource account

The resource account receives calls only once the phone number is assigned to the resource account in the Teams Management portal. The assignment works as it does for a Teams user, which Assign phone numbers describes in full.

To assign the phone number to the resource account:

  1. In the Navigation pane, expand Voice channels, and select Microsoft Teams.
  2. Under Configure Teams tenant, click Manage.

    The Teams Management portal opens in a new browser tab.

  3. Select Users, and then find the resource account by its username.

  4. Assign the phone number as described in Assign phone numbers, and leave 'Online Voice Routing Policy' at its default.

Connect the resource account to Dynamics 365

Linking the resource account to the voice channel lets Dynamics 365 present calls to that number to your agents. The main steps follow. Microsoft determines the feature's availability, functionality and support, so for the full instructions and the current status, refer to Microsoft's Configure Teams Phone in voice channel article.

To sync phone numbers from Teams, the signed-in administrator needs the Teams Administrator or Teams Telephony Administrator role, and the TeamsResourceAccount.Read.All Microsoft Graph permission must be granted.

To connect the resource account to the Dynamics 365 voice channel:

  1. Sign in to Dynamics 365 as an administrator.
  2. Open the Copilot Service admin center.
  3. In the site map, under Customer support, select Channels.
  4. Next to Phone numbers, click Manage.
  5. On the Phone numbers page, click Advanced.

    The Manage telephony page opens.

  6. Select the Teams phone system tab.

    The tab shows the 'Azure Communication Services resource ID' and the 'Dynamics App ID'.

  7. Click Sync from Teams.

    Dynamics 365 creates a phone number record for the number assigned to the resource account.

  8. Create a workstream. Refer to Microsoft's Create and manage workstreams article.

  9. Add a voice channel to the workstream for the synced phone number. Refer to Microsoft's Set up inbound calling article.

Route calls from the phone number to Teams

A routing rule sends calls to the phone number on to Teams, and from Teams to Dynamics 365. Without the rule, Live Hub does not deliver the calls. A Teams connection behaves like a SIP connection on the Routing screen, so add a routing rule that joins your SIP connection or Live Hub phone number with the Teams connection. See Add a routing rule.

Verify the configuration

The configuration is complete when Dynamics 365 Contact Center uses the phone number assigned to your resource account, Microsoft Teams connects to Live Hub through Direct Routing, and Live Hub routes calls from your SIP connection or phone number to Teams.

To confirm, call your contact center number from an external phone, and check that the call reaches an available agent in Dynamics 365. To test the Teams connection on its own, see Test your Teams connectivity.

Troubleshooting

If the test call does not reach an agent, check the following:

If the problem persists, contact support.