Skip to content

SankarMicrosoft/microsoft-teams-apps-faqplus

 
 

Repository files navigation

page_type languages products description urlFragment
sample
csharp
office-teams
FAQ Plus bot is one of the best friendly Q&A bots that bring a human in the loop when it is unable to help with an answer from the knowledge base.
microsoft-teams-apps-faqplus

FAQ Plus App Template

Documentation Deployment guide Architecture

Chatbots on Microsoft Teams are an easy way to provide answers to frequently asked questions by users. However, most chatbots fail to engage with users in a meaningful way because there is no human in the loop when the chatbot fails to answer a question well.

FAQ Plus bot is a friendly Q&A bot that brings a human in the loop when it is unable to help. A user can ask the bot a question and the bot responds with an answer if it's in the knowledge base. If not, the bot offers the user an option to "Ask an expert", which posts the question to a pre-configured team of experts to provide support. An expert can assign the question to themself, chat with the user to gain more context and add the question to the knowledge base from using a messaging extention so that the next user to ask that same question will get an answer from the chatbot!

The July 2020 (version 3) release of FAQ Plus includes a multi-turn feature to the end user experience. With the multi-turn feature, users will be presented with follow-up options along with an answer to their question. This enables the FAQ Plus bot to answer the user's question with more relevance. Multi-turn follow-up options are programmed directly into the QnA Maker when the tenant admin uploads the Q&A pairs into the knowledge base.

FAQ Plus provides features to the expert team such as:

  • Adding/editing/deleting/previewing QnA
  • Viewing update history of QnA
  • View all the existing QnA
  • View the original version of the edited QnA
  • View details of manually added QnA

Here are some screenshots showing FAQ Plus in action:

  • A user interacting with FAQ Plus through chat:

FAQ Plus in action (user view)

  • Expert using FAQ Plus:

FAQ Plus in action (experts view)

  • Expert invoking the task module to add QnA pair:

Invoking_taskmodule1

More screenshots and tips on how to use the app are in the Wiki of this repository.

Legal Notice

This app template is provided under the MIT License terms. In addition to these terms, by using this app template you agree to the following:

  • You, not Microsoft, will license the use of your app to users or organization.

  • This app template is not intended to substitute your own regulatory due diligence or make you or your app compliant with respect to any applicable regulations, including but not limited to privacy, healthcare, employment, or financial regulations.

  • You are responsible for complying with all applicable privacy and security regulations including those related to use, collection and handling of any personal data by your app. This includes complying with all internal privacy and security policies of your organization if your app is developed to be sideloaded internally within your organization. Where applicable, you may be responsible for data related incidents or data subject requests for data collected through your app.

  • Any trademarks or registered trademarks of Microsoft in the United States and/or other countries and logos included in this repository are the property of Microsoft, and the license for this project does not grant you rights to use any Microsoft names, logos or trademarks outside of this repository. Microsoft’s general trademark guidelines can be found here.

  • If the app template enables access to any Microsoft Internet-based services (e.g., Office365), use of those services will be subject to the separately-provided terms of use. In such cases, Microsoft may collect telemetry data related to app template usage and operation. Use and handling of telemetry data will be performed in accordance with such terms of use.

  • Use of this template does not guarantee acceptance of your app to the Teams app store. To make this app available in the Teams app store, you will have to comply with the submission and validation process, and all associated requirements such as including your own privacy statement and terms of use for your app.

Getting Started

Begin with the Solution overview to read about what the app does and how it works.

When you're ready to try out FAQ Plus, or to use it in your own organization, you can choose to follow one of the below guides.

  • Deployment guide powershell.
    • Recommended Use this option to deploy the FAQ Plus v4.0 using powershell script. The entire set-up is done by the powershell script.
  • Deployment guide.
    • Use this option to deploy the FAQ+ v4.0 manually.

Migration

If you already have older version of FAQ Plus installed, then please use this v4 migration guide. Please note that deploying the major version update, like FAQ Plus version 4.0 involves more than syncing the App Service and Azure Functions, so plan to review the migration guide before migrating to latest.

Feedback

Thoughts? Questions? Ideas? Share them with us on Teams UserVoice!

Please report bugs and other code issues here.

Contributing

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.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., label, 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 opencode@microsoft.com with any additional questions or comments.

About

FAQ Plus is a friendly Q&A bot that brings a human in the loop when it is unable to help with an answer from the knowledge base.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 83.2%
  • HTML 8.9%
  • PowerShell 5.6%
  • Batchfile 1.7%
  • Other 0.6%