Adoption Bot is a user care chat bot built with Power Virtual Agents for Microsoft Teams (PVA) and the Employee FAQ Template. Out of the box, Adoption Bot answers 100+ common questions about Microsoft Teams and Microsoft 365. You can edit the included topics, add your own topics, or ingest your existing FAQs in bulk. If users need additional help, Adoption Bot can connect them to experts or be extended to open service tickets in ITSM with Premium Power Automate connectors.

New with Adoption Bot 2022:

• Numerous improvements forked from Employee FAQ Bot Template
• Dataverse for Teams stores Ask an Expert request status and captures resolved requests
• Status Flow for users to check the status of their requests
• Adoption Bot Canvas app to allow experts to review request status and feedback from users
• 103 updated Teams and M365 QnA pairs in English

Benefits:

• No code Bots have quick time to value and net quick win for M365 project team
• Capabilities available in the Power Virtual Agents app in Microsoft Teams are available as part of select Microsoft 365 subscriptions
• Bots can drive down support costs with fewer service desk tickets*

*Use of bots to handle employee questions reduces the number of IT and HR support tickets by 10% to 15%. Source: Forrester Consulting Total Economic Impact™ Of using Microsoft Teams as a platform and Teams with Power Platform

Adoption Bot 2022 is free for most Enterprise customers for use in Teams. Adoption Bot 2022 and Power Virtual Agents app in Microsoft Teams are available as part of most Microsoft 365 subscriptions and use standard connectors.

• Subscription that includes Power Virtual Agents for Teams. Most plans except A1, F1 and SUB SKUs. note for full details see Get access to Power Virtual Agents - Power Virtual Agents | Microsoft Docs
• Access to Power Virtual Agents for Teams App to deploy and customize the Bot
• Microsoft Teams Team to host the Bot/Dataverse and Ask an Expert and Submit Feedback escalations to land (Team Owner)
• Required network access to PVA service endpoints listed here

First, add the required apps to Teams, and create your Power Apps app:

1. Download the Adoption Bot 2022 solution Zip file.
2. Add the Power Apps app in Microsoft Teams, and open it.
3. It will open the app in Home tab and select Start now.
4. Select the team you want to use, and Create an application. If this is the first time you are creating an app in the team, it will take a few seconds to setup a Dataverse database before you are prompted to name the application. When prompted, name the application Demo and select Save.D

Next, import the template solution:

1. In the Power Apps app, select the Build tab to see your list of teams on the side panel.

2. Select the team you choose in the previous step from the list. The app you just created will appear in the main section of the window, this may take a few minutes to update.
3. Select See all.

4. On the top menu bar, select Import, then select Browse in the pane that appears.

5. Select the template solution you downloaded, and then Next.
6. When you see the items to choose to import, make sure everything is selected and click Next.

8. If you have connections, select them, if you do not, then add them. You will need to add Microsoft Teams, Office and Dataverse connection.

8. Select Import. Note: the import will take a few minutes

You have now imported the solution and your can go to the Build tab in Power Apps to see all of your items. To use the bot, you will need to go through some additional set up steps.

Set up and validate Adoption Bot

We need to update Power Automate Flows, validate the Adoption Bot is working and add our Adoption Bot Admin application to a teams channel. Once this section is completed, the Adoption Bot bot's escalation flow will be up and running and ready to be added with your organization's content.

Setting up Power Automate flows

1. In the Power Apps app, select the Build tab to see your list of teams on the side panel.

2. Select the team you choose in the previous step from the list, then select See all to view the solution overview.

3. Select Cloud flows on the side panel.

4. Select the Adoption Bot – Ask an Expert flow to open it. This flow takes employee's escalation request and notify human expert in a team channel.
5. Select Edit
6. Open the action Convert time zone - Select Your Timezone and set the destination time zone to your timezone.

7. Open the action Post adaptive card in a chat or channel - Select Team and Channel. Note: this is at the bottom of the Post Action
8. Change the Team and Channel to your desired team and channel for the feedback information adaptive card to be posted to. Note: you may want to create a new channel in yout team to host Ask an Expert Requests

9. Expand the condition action.
10. Open the action Convert time zone - Select Your Timezone - Resolved and set the destination time zone to your timezone.

11. Select Save.

12. Select the back arrow ←.

13. Select the Adoption Bot - Feedback flow to open it. This flow takes employee's feedback and post into a team channel for human expert to review

14. Select Edit.

15. Open the action Convert time zone - Select Your Timezone and set the destination time zone to your timezone.

16. Open the action Post adaptive card in a chat or channel - Select Team and Channel.
17. Change the Team and Channel to your desired team and channel for the feedback information adaptive card to be posted to.

18. Select Save.

Bot Validation

1. Add the Power Virtual Agents app in Microsoft Teams, you can search for it directly in Microsoft Teams app store.
2. Open the Power Virtual Agents Teams application.
3. Select Chatbots.

4. Select your team.
5. Select your chat bot.
6. Select Publish on the left menu, Select Publish button and Publish again .

7. Select Turn on Teams.

8. Select Open the bot.

9. Select Add to add the bot into Microsoft Teams for yourself

10. You will now be taken to a chat window with your bot. Here you can try trigger phrases to ensure that the bot is functioning correctly. We have listed several phases you should consider trying below:

• Hello
• Ask an expert
• What is the status of my request
• Submit feedback

11. For Ask an expert and Submit feedback, make sure to check the bot posts request and feedback to the team and channel you configured earlier. Note that you won't be able to deep link to yourself from the request adaptive card if you are the same person requesting it.

Set up Power App Teams tab

You can review the bot's performance in Power Virtual Agents built-in analytics dashboard. In addition to the dashboard, Adoption Bot also comes with a Canvas app to allow experts to review the verbal feedback from employees.

1. Open the Power Apps for Teams app and the Build Tab.
2. Select your team
3. Select See All.

4. Select the three dots next to the Adoption Bot Admin App (...).
5. Select Edit.

6. Select Publish to Teams on the upper right.

7. Select Next.

8. Select your team and channel where you want to pin the Adoption Bot Admin App.

9. Select + Add app as a Tab.

10. Select Save and close.
11. Open your team
12. Select the Adoption Bot Admin tab

13. Once selected you will see the Adoption Bot Admin Canvas App. You will be able to view requests and feedback.

Next steps

You have now fully set up the Adoption Bot template. The next step is to go to Power Virtual Agents Teams application to add FAQ content for the bot to answer your organization's questions. Extension documentation

Adding bot content in Power Virtual Agents

The Adoption Bot template can easily be extended in Power Virtual Agents Teams application by adding new topics, messages, questions, actions and more.

As a starting point, we suggest looking at the greeting system topic, customizing it to provide a personal greeting that represents your company and how you want your users to start using the bot. Yyou can freely edit the topics or simply create new topics to handle any additional areas you wish to include. You can also quickly and easily add new topics with the built-in topic suggestion feature.

Reach out to the Github Repro here or the PVA Community for help and ideas from our community members.

Making the bot available to employees

Once you are satisfied with the bot's content, it's time to make it available to employees. You can easily make the bot available in Microsoft Teams app store by following the steps to share the bot with your organization. We recommend to partner with your IT admin to also pre-pin the bot on the left rail so employees can easily discover the bot in Microsoft Teams without needing to manually install it. Learn more about best practice guidance to partner with admin to roll out bot in Microsoft Teams.

Alternatively, you can also directly share the bot's installation link with others in the organization without going through the admin approval process. Make sure you change the bot's access to fit your target audience so they have permission to install the bot.

Brand Adoption Bot for your organization

Optionally, you can give the bot a name that makes sense to your organization. To change the Bot name and icon, click Manage and Details. Click save at the top.

Special thanks to contributors Aditya Challapally, Michael Chow, Flow-Joe, Belinda Parker and Nidhi Shandilya who helped create and launch this app template.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.