officedev / microsoft-teams-apps-hrsupport

HR support app template

HR Support App Template

Documentation	Deployment guide	Architecture

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

HR Support bot is a friendly Q&A bot that brings a support professional/expert from the HR team in the loop when it is unable to help. One can ask the bot a question and the bot responds with an answer if it is contained in the knowledge base. If not, the bot allows the user to submit a query which then gets posted in a pre-configured team of experts who are help to provide support by acting upon the notifications from within their team itself. Additionally, the bot suggests links to recommended HR policies/questions by searching for pre-configured tags in the question. These tiles can also be found in the associated tab as a quick reference. HR Support works well for light weight QnA and to provide quick support when launching new projects/initiatives in the organization.

An end-user interacting with HR Support:

Experts team using HR Support:

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 HR Support, or to use it in your own organization, follow the steps in the Deployment guide.

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 [email protected] with any additional questions or comments.

microsoft-teams-apps-hrsupport's Issues

..

My bot now working with thread.skype , it working on thread.tacv2

Unable to reach app. Please try again.

Hi,
I followed the deployment document, the issue what I am getting now is when user tries to send a question to Expert is gives below error to the user "Unable to reach app. Please try again.". See attached screenshot for the same.

Deployment docu: Confusion about authentication token

I have some confusion about this wiki page:
https://github.com/OfficeDev/microsoft-teams-hrsupport-app/wiki/Deployment-Guide

In step 1, number 9, there is this sentence:

Now go to your app registrations, then go to Authentication and check the checkbox ID tokens and Access tokens for Bot App and Only ID tokens for Configurator App.

But without adding a platform "Web" with URI, there is no implicit grant and so no checkboxes.

Otherwise, later in the deployment guide, there is the step 3 which correctly describes the process of configuring authentication.

Bot code does not deploy from template

Hi there,

When deploying the template there seems to be a library version issue. I can capture more information if need be. Tried to fix this manually and then get presented with an error around XML.

D:\home\site\repository\Source\Microsoft.Teams.Apps.AskHR.Common\Microsoft.Teams.Apps.AskHR.Common.csproj(1,1): error MSB4041: The default XML namespace of the project must be the MSBuild XML namespace. If the project is authored in the MSBuild 2003 format, please add xmlns="http://schemas.microsoft.com/developer/msbuild/2003" to the <Project> element. If the project has been authored in the old 1.0 or 1.2 format, please convert it to MSBuild 2003 format. Failed exitCode=1, command="D:\Program Files (x86)\MSBuild\14.0\Bin\MSBuild.exe" "D:\home\site\repository\Source\Microsoft.Teams.Apps.AskHR.Configuration\Microsoft.Teams.Apps.AskHR.Configuration.csproj" /nologo /verbosity:m /t:Build /t:pipelinePreDeployCopyAllFilesToOneFolder /p:_PackageTempDir="D:\local\Temp\8d80c642ef03e83";AutoParameterizationWebConfigConnectionStrings=false;Configuration=Release;UseSharedCompilation=false /p:SolutionDir="D:\home\site\repository\Source\\" An error has occurred during web site deployment.

Deployment docu: Confusion with team and channel

Another one from:
https://github.com/OfficeDev/microsoft-teams-hrsupport-app/wiki/Deployment-Guide

The screenshot in step 5, number 4 is unprecise:
It shows the context menu of a channel, while the text says to get the team link. The latter proves to be correct, as the configuration app does not accept a channel link.

The config app will not accept a Teams ID with "thread.tacv2" in it

For the Experts Team, in the config app, if the link to the Team contains "thread.tacv2" then it will not accept the Team ID (seems to be the case for newer Teams), but if it is thread.skype (seems to be the case for older Teams) it will accept it.

The subscription does not have QuotaId/Feature required by SKU 'S0' from kind 'QnAMaker' . (Code: SpecialFeatureOrQuotaIdRequired)

@v-smahaj I try to implement this solution and get this error:

The subscription does not have QuotaId/Feature required by SKU 'S0' from kind 'QnAMaker' . (Code: SpecialFeatureOrQuotaIdRequired)

It looks like the Classic QnA Maker become retired from 1 october 2022. There is a new QnA Maker functionality with the name "Question Answering" . How to make the deployment work with the new the new Question Answering?

See this picture:
https://learn-attachment.microsoft.com/api/attachments/7a5c38b3-2e03-478a-8df0-4b5b72d1be47?platform=QnA

https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/create-test-deploy

Getting Error "There was a problem reaching this app"

Even though I see that error, the bot is working and responding.
The interesting thing is not everyone sees that error. Test with 10 people and only myself and one other person saw that message.

Also, if I click on Apps and select to open the App from the list of apps, the error goes away for that time.
But if I try clicking the App again from the navigation bar, the error comes back.
If I go to Teams in a Web Browser the error does not show.

I have tried uninstalling the app from my client and re-adding, same issue.
Deleted all cache files from Teams, same issue.
Restarted the services in Azure - same issue.

Any idea how to resolve this?

Hi I always get conflict when deployment step web/site source control anybody know how to fix it?

HR App Template does not work with multiturn QnA

When my Knowledge Base is configured for multi-turn QnA, the bot template does not return the additional prompts.

(Manifest parsing has failed/There is no manifest file in your package) while uploading App in MS Teams

Below is my manifest.json script!
{
"$schema":"https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
"manifestVersion":"1.5",
"version":"1.0.0",
"id":"98fc546e-ef74-42cb-8a16-9e7df8c9851f",
"packageName":"com.microsoft.teams.hrsupport",
"developer":{
"name":"Proven",
"websiteUrl":"https://contoso.com",
"privacyUrl":"https://contoso.com",
"termsOfUseUrl":"https://contoso.com"
},
"icons":{
"color":"color.png",
"outline":"outline.png"
},
"name":{
"short":"HR Support"
},
"description":{
"short":"A friendly HR Support bot that answers questions and connects you to experts.",
"full":"A friendly Q&A bot. If it can't find an answer, it'll offer to put you in touch with an expert from human resources."
},
"accentColor":"#64A2CC",
"bots":[
{
"botId":"fe2cb26a-b786-4b0f-859d-889e76e351a0",
"scopes":[
"personal",
"team"
],
"commandLists":[
{
"scopes":[
"personal"
],
"commands":[
{
"title":"Take a tour",
"description":"Tour of key features"
},
{
"title":"Ask an expert",
"description":"Connect with an expert"
},
{
"title":"Share feedback",
"description":"Send feedback"
}
]
}
],
"supportsFiles":false,
"isNotificationOnly":false
}
],
"staticTabs":[
{
"entityId":"HR Support",
"name":"HR Support",
"contentUrl":"https://xyz.azurewebsites.net/help?theme={theme}",
"scopes":[
"personal"
]
}
],
"permissions":[
"identity",
"messageTeamMembers"
],
"validDomains":[
"xyz.azurewebsites.net"
]
}

Error when delpoy the web resource

I have tried to deploy this app, however, the error always show up, I have no idea about this.

{"code":"DeploymentFailed","message":"At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/DeployOperations for usage details.","details":[{"code":"Conflict","message":"{\r\n "status": "Failed",\r\n "error": {\r\n "code": "ResourceDeploymentFailure",\r\n "message": "The resource operation completed with terminal provisioning state 'Failed'."\r\n }\r\n}"}]}

Could you help me check this?

Deployment of Bot App. Hitting unhandled exception

There appears to be an issue with the Bot app deploying properly. It also will not sync.

Excerpt
'' at Microsoft.Build.CommandLine.MSBuildApp.Main(String[] args)
Failed exitCode=-532462766, command=dotnet restore "D:\home\site\repository\Source\Microsoft.Teams.Apps.AskHR.sln"
An error has occurred during web site deployment.
Unhandled exception. System.ComponentModel.Win32Exception (5): Access is denied.\r\n at System.Diagnostics.Process.set_PriorityClassCore(ProcessPriorityClass value)\r\n at System.Diagnostics.Process.set_PriorityClass(ProcessPriorityClass value)\r\n at Microsoft.Build.CommandLine.MSBuildApp.Execute(String[] commandLine)\r\n at Microsoft.Build.CommandLine.MSBuildApp.Main(String[] args)\r\nD:\Program Files (x86)\SiteExtensions\Kudu\87.20522.4610\bin\Scripts\starter.cmd deploy.cmd
''

creating hrsupport app with azure policies in place for west europe

Hi,

I have tried to create the hr support app, but due to our policies we are only allowed to deploy to West Europe. In the template
line 179 the qnaMakerLocation is hardcoded to westus.
"qnaMakerLocation": "westus",
That will fail in our deployment due to the policies in place. When I change it to WestEurope it fails with error message
{"code":"InvalidTemplateDeployment","details":[{"code":"InvalidApiSetId","message":"The account type 'QnAMaker' is either invalid or unavailable in given region."}]....

The only explanation I have found while searching is via here but has been some time since then.

Therefore I was wondering what you inputs are upon it.
Thanks in advance

Idea for new Teams app Template app

This feature would make an awesome teams app-template since lots of companies might want to integrate the API of their internal URL shortener.

https://microsoftteams.uservoice.com/forums/555103-public/suggestions/33010897-url-shortener-for-teams