Configure Microsoft Teams chat in Customer Service

You can configure the ability for agents to chat in Microsoft Teams from within Customer Service Hub, Customer Service workspace, and your custom apps. Teams chat is also available in other customer engagement apps such as Dynamics 365 Field Service and Dynamics 365 Sales.

When the feature is enabled for an app, agents who work on customer records can start a new chat or connect an existing chat to a record. They can collaborate efficiently without switching context or leaving the application. Connecting the associated chats to a record can help agents maintain all the chats related to the record in one place. You can also configure an optional introduction note that agents can use to provide further context when collaborating in Teams.

Enable or disable Teams chat

If you’re using the Customer Service workspace or Customer Service Hub apps, Teams chat is automatically enabled. If you want to use Teams chat in other customer engagement apps, you must manually enable it. Teams chat also requires certain permissions to access Teams data.

Permissions required

When Teams chat is enabled, the app has the following permissions:

In order to use Teams chat in multisession environments, users must have the same permissions as the Productivity tools user role.

Users need read permission for the following entities to access the productivity pane for custom roles:

• App profile
• Application tab template
• Notification field
• Notification template
• Pane tab configuration
• Pane tool configuration
• Productivity pane configuration

Data security and privacy

The following data security and privacy considerations apply for Teams chat functionality in Dynamics 365:

• Dynamics 365 doesn't store any Teams data except for the mapping between the record ID and the connected chat ID. No data from Teams is duplicated in Dynamics 365 unless the user manually adds it to the record notes or tasks.

• The communication between the applications is secured through TLS.

• The integration honors policies that apply both to Teams and Dynamics 365. For example, confidential files shared in a connected chat are only accessible to permitted users. Similarly, a record shared in a Teams chat in Dynamics 365 can only be accessed if the user has permission to view it.

• The app requires certain permissions to start a chat, display suggested contacts, show presence, and so on. For more information, review Permissions required.

Add the Teams collaboration and chat settings page to the sitemap of your app

1. Sign in to Power Apps.

2. Select the environment, and then select Apps.

3. Select your custom app, and then select Edit.

4. In the App Designer, edit the Sitemap.

5. To add the Teams Chat and collaborate settings page, add a subarea component, and then for the Type, select URL.

6. Copy the following value and paste it into URL field:
   /main.aspx?pagetype=control&controlName=MscrmControls.TeamsCollaborationAdmin.TeamsCollaborationAdmin

7. Save and publish the changes.

Access the Teams settings

1. In the site map of Customer Service admin app, in Agent experience, select Collaboration.

2. In Embedded chat using Teams, select Manage.

3. On the Microsoft Teams collaboration and chat page, turn on the toggle for Turn on Microsoft Teams chats inside Dynamics 365.

4. Select one of the following options:

   • Turn on for all Dynamics 365 apps – Enables Teams chat for all supported Dynamics 365 apps in your organization, including any that you add in the future.
   • Turn on for selected Dynamics 365 apps – Enables Teams chat for the apps you choose. If your organization already uses Teams, the selection you made previously remains. If you didn't previously set up Teams, it's on by default for the Customer Service workspace and Customer Service Hub apps.

5. Save the changes.
   Teams settings are now enabled for Dynamics 365 Customer Service Hub, Customer Service workspace, and your custom apps (and also Field Service and Sales customer engagement apps, if you're using them). You can open a record and verify if you’re able to view the chats and channels related to the record.

Add the Teams chat settings page for specific multisession users

If you're using the default profile, once you complete the steps in Add the Teams chat settings page to the sitemap of your app, Teams chat is enabled.

If you want Teams chat to work for specific users, you must enable the feature for your custom profile. For more information about creating custom profiles, see Agent experience profiles.

To enable Teams chat settings for a custom multisession user, complete the following steps:

1. Create the custom profile from the default profile. More info: Create and use agent experience profiles

2. In the site map, in Agent experience, select Collaboration.

3. In Embedded chat using Teams, select Manage.

4. Ensure that the toggle for Turn on Microsoft Teams chats inside Dynamics 365 is set to Yes, and then in Turn on for specific multisession users, select Manage. The Agent experiences profiles page is displayed.

5. Select the profile to open it.

6. On the profile page, you can take the following actions:

   • Add users More information: Assign profiles to users
   • Add an entity session template More information: Manage session templates
   • Enable the inbox More information: Configure the inbox for agents
   • Enable productivity pane features More information:
   • Set up channel providers More information: Overview of productivity tools

Configure the ability to connect chats to Dynamics 365 records

After you enable Teams chats, you can connect the chats to different record types. Standard record types, including case, account, contacts, knowledge article, and email, are available out-of-the-box, or you can add your desired record type.

1. In the site map of the admin app, in Agent experience, select Collaboration.

2. In Embedded chat using Teams, select Manage.

3. Under Connect chats to Dynamics 365 records, select the record type you want to configure.
   If you want to add a record type, see Add record types

4. Select Save.

Add record types

To add a record type to connect chats to in Dynamics 365 records:

1. In the site map, in Agent experience, select Collaboration.

2. In Embedded chat using Teams, select Manage.

3. Under Connect chats to Dynamics 365 records, select Add record types.

4. In the Allow chats to be connected to this record type pane, in Choose record type, type the name of the record type you want to use.

5. (Optional): If you want to display content for new connected chats, toggle Include a note to On, and then use the existing views functionality to define the fields that represent the context card or create a custom view in Power Apps. You can choose up to five fields you want to include as a context card.

6. Select Save.

For any view selected, keep in mind the following details:

• The first five fields of any view are used as the context card details (in addition to a connection to the record).

• If a field isn't supported, it's skipped and the display includes the first four fields that are supported. You're able to see from the configuration experience that the specific field isn't supported.

  

• Because the data fields are static, field-level permissions aren't checked for collaborators. Therefore, if the agent has the field-level permissions to view data fields, collaborators can also see those fields.

• If you don't select a view for the Case record type, agents see the default, out-of-box Case introduction message view.

  

• For other out-of-box standard record types, including account, contacts, knowledge article, and email, the default view is the Quick find view.

Assign permissions to disconnect chats for specific user and user roles

Agents can create Teams chats directly from Dynamics 365 apps and then connect them to records. They can also connect existing chats to Dynamics 365 records from the Teams embedded chat experience.

As an admin, you can control which user or role can disconnect chats that are connected. These user permissions help give you the flexibility to adapt the Teams embedded chat experience to match your business processes.

You can choose from the following options for assigning permissions to agents:

• Assign disconnect chat rights to specific users
• Assign disconnect chat rights for security roles

Assign disconnect chat rights to specific users

You can assign the ability to disconnect chats to record owners or users who connected a chat to a record. For new organizations, by default, these settings are enabled.

• Record owner can disconnect chats: When enabled, record owners can disconnect any chats that are connected to a record. As an admin, you can assign this permission at a record-type level (for example, a case, contact, and so forth).
• Chat connector can disconnect chat: When enabled, users who connected a chat to the Dynamics 365 record can disconnect that connected chat. This permission can also be assigned at the record level.

To enable or disable user-specific rights to disconnect chats:

1. In the site map of the admin app, in Agent experience, select Collaboration.

2. In Embedded chat using Teams, select Manage.

3. Select the record type (for example, Case), and then in the settings pane, in Disconnecting chats, toggle on or off Record owner can disconnect chats and/or Chat connector can disconnect chat, depending on your preferences.

4. Select Save.

Assign disconnect chat rights for security roles

When you assign disconnect chat rights to a security role, all users with that role can disconnect chats that are connected to any record type. Certain role types have disconnect chats rights by default.

The following table details the apps and security roles where the disconnect chats feature is configured:

To edit disconnect chat rights to security roles:

1. In the site map of the admin app, in Agent experience, select Collaboration.

2. In Embedded chat using Teams, select Manage.

3. On the Microsoft Teams collaboration and chat page, scroll down to More settings.

4. In Set who can disconnect chats, select Edit in security roles settings. The Power Platform admin center app is opened.

5. In Security roles, select the role that you want to assign the rights to, and then select Edit.

   

6. For the specific security role, go to Business management > Miscellaneous Privileges > Disconnect Teams chat from Dynamics 365 record.

   

How user rights work together for disconnecting chats

The following table summarizes whether a user can disconnect a connected chat based on the rights assigned to them. You can use the table as a guide for how to use these chat rights to help you configure a secure and effective collaboration experience for your business and users.

Configure the ability for users to join chats

As an admin, you can enable users to view and easily join chats that are connected to records they have write access to, even if they weren't originally part of those chats. You can configure the ability for users to join connected chats at a record-type level. This functionality can help you tailor the user experience for your business processes.

The ability for users to join existing chats related to cases is especially useful for the following scenarios:

• Case transfers: If an agent onboards to a case that another agent previously handled, they can join existing connected chats to better understand the context of the case. They can see the steps the previous agent took, and then continue to collaborate with their relevant colleagues.
• Case escalations: If a case needs attention from someone with specific knowledge, the subject-matter expert who reviews it can participate in the relevant conversations.

To turn on or off the join chat capability for a record type:

1. In the site map, in Agent experience, select Collaboration.

2. In Embedded chat using Teams, select Manage.

3. On the Microsoft Teams collaboration and chat page, in Connect chats to Dynamics 365 records, select the specific record type (for example, Case), and then in the settings pane, toggle Join chat on or off.

4. Select Save.

Keep chat participants informed when fields are updated

You can reduce the overhead on your agents by automatically updating all participants in a chat when an essential field on a connected record is updated. This time-saving feature helps keep everyone informed without manual effort and allows agents to focus on important matters. It also helps experts in the chat be aware of important updates.

Limitations for automatic event updates

This section describes the limitations of the automatic event functionality.

Entities and attribute type limitations

The following entities aren’t configurable for automatic event updates:

• Virtual entities
• Entities that don’t have the Update SDKMessageFilter defined

The following attribute types aren’t supported for automatic event updates:

• PartyList
• Image
• Integer
• File

Inline image limitations

Automatic event updates can’t fully render inline images in rich text fields.

Configure chat update when a field is changed

1. In Customer Service admin center, select Collaboration, and then set the toggle to On for Turn on Microsoft Teams chats inside Dynamics 365.

2. Next to Embed chat using Teams, select Manage.

3. On the Microsoft Teams collaboration and chat page under Connect chats to Dynamics 365 records, select the entity for which you want to enable automatic event updates, or create a new one if needed. The record settings pane for that entity is opened on the right side of the page.

   

4. Set the Receive notification on key updates toggle to On.

5. View the Suggested attributes list by placing your cursor in the field below the toggle, and then select up to five attributes for which you want to send notifications.

   Note

   For the Case entity, the following settings are preconfigured:

   • Priority
   • Status
   • Status Reason

   

6. Save your changes. Now, automatic notifications are sent whenever the attributes you defined for the entities are updated.

Configure the ability for agents to view Teams chats on a connected record’s timeline (preview)

You can configure the ability to sync data from Teams to Dataverse so that agents can see chat entries in the timeline when they start a connected chat or connect an existing chat to a record. Agents see the chat appear as a new activity on the timeline. It shows details about who connected the chat and when they connected, as well as the last person to send a message in the chat and the time they sent it.

Additionally, if the agent assigned to the record changes, the new agent (who might not have participated in the original chat), can see the chat on the timeline. If the Join chat setting is turned on, the new agent can directly join the chat (and be added as a chat participant) to see the full chat exchange.

Prerequisites

• Only global administrators can configure Teams chat data to sync with Dynamics 365 records.
• For multisession users, you must enable Teams integration in the productivity pane for the app profile assigned to the signed-in user in order for them to be able to select Open chat on the timeline.

Enable agents to view Teams chats on a connected record’s timeline:

1. In the site map, in Agent experience, select Collaboration.

2. In Embedded chat using Teams, select Manage.

3. Set the toggle to Yes for Turn on Microsoft Teams chats inside Dynamics 365.

4. Set the toggle to Yes for Sync Teams chats with records (Preview).

See also

Use Teams chat
FAQ about Teams chat
Install and set up Microsoft Teams integration
Microsoft Teams integration FAQ
Configure AI suggestions for contacts in Microsoft Teams
Collaborate with AI-suggested agents in Microsoft Teams