Virtual Agent feature support in Microsoft Teams conversations
The Microsoft Teams app supports Virtual Agent features, such as Assistant Designer controls for creating conversations, notifications, AI Search results, and more.
Emojis and text
Starting with Version 4.0.1, when a user chats with a live agent and sends a message that contains emojis, the text gets delivered and the emoji is displayed on the agent workspace.
Note: Due to the difference in the platforms (app or web browser) used by the end user and the live agent, there's a difference between the emojis that are sent by the end user and the emojis that are received by the live agent.
A user can understand how emojis look like in a chat conversation and in the Agent Workspace from the following examples.
Emojis appear in line with text as the user selects them.
Live agents may see slightly different emojis in Agent Workspace.
Message pagination
Microsoft Teams has a limit on the maximum message size before paginating the message. You can adjust the number of characters allowed in a message before paginating by going to the system properties [sys_properties] table and setting the number in the system property sn_va_teams.picker_char_limit.
AI Search results
Now Assist in Virtual Agent can generate AI Search results that are displayed as Genius result cards and multi-link outputs in conversations. For details on how Virtual Agent generates AI Search results, see Improving the user experience with AI Search. The default AI Search configuration for Virtual Agent enables search results for Q&A (Knowledge Base and catalog items). The user has the option to like or dislike the information presented in the card. For more information, see Genius Results.
URL navigation for chat links
In the Virtual Agent and Live Agent conversations on the Microsoft Teams app, the links to ServiceNow records open automatically in base system portals, including the links that are displayed in the output cards, Virtual Agent notifications, and AI Search results. If needed, as the administrator, you can change the portals where these links are opened in. For configuration details, see Configure URL navigation for chat links.
Masking of sensitive user data
Starting with Version 2.0.0, passwords that are entered by users and confirmed in bot responses are masked during the password reset conversations in the Microsoft Teams app.
A user can understand how a password is masked in Microsoft Teams from the following example.
When the user enters their password in a Microsoft Teams conversation, the characters are hidden by dots.
Support for file uploads
Starting with Version 2.0.0, users can upload their file attachments with the paper clip icon
Paper clip icon. in the Microsoft Teams conversations.
A user can learn to attach an icon in the Microsoft Teams chat window from the following example.
User selects the paper clip icon in the chat window to upload a file.
Trusted domains
The values that are specified in the Trusted media domains field of the Provider Channel Identities table [sys_cs_provider_application] take precedence over the Connections table [sys_cs_provider] and overrides its values.
Catalog opening experience in Microsoft Teams conversations
Starting with Version 4.1.0, users can request a catalog item from the Microsoft Teams app during a conversation.
A user can select the Request this item button in a conversation with Microsoft Teams that opens the catalog item in a pop-up window, the Task Module, where the user can view the information of the item and submit the request within Microsoft Teams.
The following examples show how a user can request and then view a catalog item.
Catalog item displays on a card in the conversation. Users can select "Request this item" to open the pop-up window where they can complete the request.
Catalog item displays in a pop-over window, where the user can view details and make the request.
Custom branding in the Microsoft Teams application
Microsoft Teams supports app customization, which enables you, as the administrator, to customize the branding of the Now Virtual Agent bot in the Conversational Integration with Microsoft Teams. To learn more about app customization, see these resources:
- Customize apps in Microsoft Teams in the Microsoft Teams documentation.
- MS Teams branding for the conversational integration in the ServiceNow Community.
HTML rendering in Microsoft Teams
When a Virtual Agent sends a message in Microsoft Teams with HTML tags, only those HTML tags supported by Microsoft Teams are rendered as normal tags.
For more information about the Microsoft Teams supported HTML tags for bot messages, see Formatting bot messages.
Custom controls in Microsoft Teams
Using the Custom Control utility will cause failure in Microsoft Teams conversations with the message channel is not supported. See Custom control utility for more information on the utility.
- Virtual Agent Designer user input and bot response controls in Microsoft Teams
The Virtual Agent Designer user input and bot response controls for creating conversation topics are supported in Microsoft Teams conversations, including the table bot response, the card control that can display images, and the image bot response controls. - Virtual Agent notifications supported in Microsoft Teams
Microsoft Teams app supports Virtual Agent notifications during conversations. - Unsupported Virtual Agent features in Microsoft Teams
Refer to the unsupported features of Virtual Agent in Conversational Integration with Microsoft Teams. - Capture common errors and provide resolution steps for Microsoft Teams using the Conversational Interfaces Diagnostic Tool
The Conversational Interfaces Diagnostic Tool runs a health report to define and capture information for different categories of the Conversational Integration with Microsoft Teams app, such as plugin details, configuration settings, system properties, integration failures, and so on, and lets the user validate and review these settings to start a bot-conversation.
Parent Topic:Conversational Integration with Microsoft Teams