Configure promoted topics for Conversational Integration with Microsoft Teams

Configure promoted topics to push out important, common topics for users' quick consumption during a conversation with the Microsoft Teams bot. You can configure up to six different promoted topics to be displayed on the Microsoft Teams channel greeting message.

Before you begin

Role required: admin or va_admin

Procedure

1. Navigate to All > Conversational Interfaces > Settings > Virtual Agent.
2. In Virtual Agent settings under Custom greetings and setup, select View All.
   The promoted topics that you have previously configured will reside in the default chat experience. For more information, see Configure a Virtual Agent chat experience. If default chat experience is the only row that you have on your instance, then you observe that the promoted topics will be applied to chat widget, Microsoft Teams, and Slack (unless you configure something unique for Microsoft Teams as instructed below.)

   If you want to set up unique promoted topics for Microsoft Teams that have to be different from the chat widget, follow the procedure below.

3. In the Custom Greetings & Setup page, select New.
4. On the form, fill in the fields.

   Table 1. Create New Custom Greetings and Setup

   Field	Description
   Name	Name of the chat experience. For example, Microsoft Teams chat experience.
   Description	Description of the chat experience.
   Active	Enable or disable the chat experience.
   Order	Order for the promoted topics to appear on the chat.
   Domain	Application scope of the chat experience.
   Condition Mode	Situation where your user gets this chat experience. Available Conditions Modes: Advanced Simple
   Condition	Condition that defines the condition mode for the chat experience. Set up a simple condition with [devicetype] [is] [teams]. Note: If you set up [devicetype] [is] [teams] in the Condition pop up with a higher order than the default chat experience, then Microsoft Teams picks up the setup topics and promoted topics defined in this experience. This change will not affect chat widget, which is still going to inherit the setup topics and promoted topics defined in the default chat experience.

5. Select Create custom experience.
6. Add promoted topics in the Microsoft Teams chat experience form that you created.
   1. On the Microsoft Teams form, select the Promoted Topics tab, and select Add topic.
   2. On the form, fill in the fields.

      Table 2. Create New Promoted Topics

      Field	Description
      Topic	Name of the topic being chosen. Use the Search icon to choose a topic.
      Order	Provide the order for the topic chosen.

      Note:

      Similar to chat widget, you can configure a maximum of six promoted topics for the Microsoft Teams channel.
   3. Selecto Save.

What to do next

Start a conversation with the Microsoft Teams bot and you should be able to see the promoted topics after the greeting message that you have setup for the Microsoft Teams channel.

In you have not configured the promoted topics for Microsoft Teams, then the promoted topics from the default chat experience are displayed.