{"id":19561511,"url":"https://github.com/leestott/learnambassadorshealthbot","last_synced_at":"2026-02-18T13:33:04.167Z","repository":{"id":50063461,"uuid":"296579855","full_name":"leestott/LearnAmbassadorsHealthbot","owner":"leestott","description":"Microsoft Learn Student Ambassadors introduction to Microsoft Healthbot","archived":false,"fork":false,"pushed_at":"2021-06-09T10:00:44.000Z","size":3208,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-25T05:24:04.245Z","etag":null,"topics":["bot","bot-framework","health","healthbot","healthcare"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leestott.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-09-18T09:45:23.000Z","updated_at":"2020-09-21T14:59:39.000Z","dependencies_parsed_at":"2022-09-19T13:41:16.815Z","dependency_job_id":null,"html_url":"https://github.com/leestott/LearnAmbassadorsHealthbot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/leestott/LearnAmbassadorsHealthbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leestott%2FLearnAmbassadorsHealthbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leestott%2FLearnAmbassadorsHealthbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leestott%2FLearnAmbassadorsHealthbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leestott%2FLearnAmbassadorsHealthbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leestott","download_url":"https://codeload.github.com/leestott/LearnAmbassadorsHealthbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leestott%2FLearnAmbassadorsHealthbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29580808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T08:38:15.585Z","status":"ssl_error","status_checked_at":"2026-02-18T08:38:14.917Z","response_time":162,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","bot-framework","health","healthbot","healthcare"],"created_at":"2024-11-11T05:11:43.741Z","updated_at":"2026-02-18T13:32:59.156Z","avatar_url":"https://github.com/leestott.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Microsoft Learn Student Ambassadors introduction to Microsoft Healthbot\n\nThe Microsoft Healthcare Bot service empowers healthcare organizations to build and deploy an AI-powered, compliant, conversational healthcare experience at scale. The service combines built-in medical intelligence with natural language capabilities, extensibility tools and compliance constructs, allowing healthcare organizations such as Providers, Payers, Pharma, HMOs, Telehealth to give people access to trusted and relevant healthcare services and information.\n\n![Microsoft HealthBot](/images/healthbotwelcome.png)\n\nThe aim of this module is to understand the different functionalities and show what capabilities that the health bot has.\n\nThis framework is the ideal starting point for you developing your first (Health) Bot project.\n\nTo start your Health Bot project, you can create the service via the Azure portal. You first need to create your Azure Subscription. So if your a student simply head over to [Azure for Student](http://aka.ms/azure4students)\n\n![MicrosoftHealthBotAzure](/images/healthbotazure.png)\n\n## Setting up your Health Bot \n\nCreate a new Health Bot Service via the Azure Portal\n\nJust fill in the required properties, such as Name, Subscription, Resource group, Location and Plans.\nWhen the services has been created, you should see a similar screen\n\n![service details](/images/belongingbot.png)\n\nThe Health Bot Service details screen after creation. \n\nTo start using the Health Bot Service, you will need to click on Configure Account , this will redirect you to the Admin portal, where you can start configuring your bot.\n\n## Scenario Editor\n\nThe initial screen invites you to create new scenario’s. The Health Bot has great functionality to create, debug, test and manage scenarios.\n\n![Microsoft HealthBot](/images/healthbotwelcome.png)\n\nStart screen Health Bot Dashboard\n\nLet’s try creating a new scenario, by clicking on Open scenario template catalog \n\nThe Health Bot Service has different templates available that can kickstart your bot project. The templates contains pre defined scenario’s, where you can start from.\n\n![Bot Template Catalog](/images/bottemplatecatalog.png)\n\nHealthbot Template Catalog\n\nFor this demo, let’s create the File a claim template.\n\n![file a claim template](images/fileaclaimtemplate.png)\n\nWhen selecting this option, you will need to enter a scenario name.\n\n![Bot Import a claim](images/botimportaclaim.png)\n\n## Select the new claim template from the catalog. \n\nAfter importing the scenario, you will be redirected to the Scenario Editor. The Scenario Editor is a very strong feature of the Health Bot, It has a number of visual capabilities to create, test and run chatbot scenario’s in the browser.\n\nHere is a high-level overview of the Scenario Editor.\n\nWe have amazing docs at Microsoft Doc, more information on the Healthbot can be found [here](https://docs.microsoft.com/HealthBot/scenario-authoring/scenario-elements)\n\n1.\tThe upper bar contains functionality to Save your scenario, but also to Run the scenario in the browser, this can be done with arguments and a snapshot of the scenario can also be created\n2.\tThe Author has a broad range of scenario elements that can be used to create your scenario.\n3.\tEvery scenario element is visualized and connected with each other. When you click on an element, you can view and edit the behavior of that element.\n4.\tWhen you Run the scenario in the portal, you can test the scenario and interact with the bot via the Chat window\n5.\tThe Info window can be seen as a small debugger when running the scenario, it has also a Watch and Immediate window.\n6.\tThe Designer contains relevant information when running the scenario.\n\n![bot scenario editor](images/botscenarioeditor.png)\n\nWhen clicking on different elements you will see the details, with the possibility to change the properties such as display text, variable name, coded choices, backend communication.\n\nThese properties are different per type or dialog element.\n\n![bot statement](images/botstatement.png)\n\nStatement details, with support for rich cards\n\n![Bot prompt](images/botprompt.png)\n\nSupport for prompts with variable input\n\n![Bot data connection call](images/botdataconnectioncall.png)\n\nConnect to your own backend systems\n\nWhen combining these building blocks, any functional user can create their own dialog scenarios without having to code. When interaction of backend systems is needed, some minor programming knowledge is needed.\n\n![bot built in language support](images/botbuildinlanguage.png)\n\n## Built in Language Models\n\nThe Health Bot Service has several built in language models, to support out of the box scenario’s, such as medical complaints, privacy issues.\n\nThe built-in language models are backed by LUIS, the Natural Language Processing NLP service from Microsoft. It is also possible to create your own language models with LUIS, Regex or even QnA maker. \n\nTo create your new NLP Language model, you can link a LUIS model to the bot by providing the needed keys and secrets. Otherwise you can create a simple regex model.\n\n![bot new model](images/botnewmodel.png)\n\n## Link your own Language Model to the bot\n\nAnother very important language feature, is the possibility to translate your scenario’s. These translations can be exported and imported for translation purposes.\n\n![bot localisation](images/botlocalisation.png)\n\n## Configuration\n\nThe Health Bot Service can be easily configured, these options are divided in 3 logical parts, Medical – Compliance – Conversation.\n\n![bot config privacy](images/botconfig1.png)\n\n![bot config interactions](images/botconfig2.png)\n\n![bot config symptoms](images/botconfig3.png)\n\nI will not go through all the different configuration options, as this could easily be a module its own. But to give you an idea of the extensibility.\n\n## Human Hand off\n\nThe following screenshots shows how you can enable Human Handoff or Interrupting Scenarios\n\n![Human hand off interactions](images/humanhandoff.png)\n\nWith the Human Handoff option, you have the possibility to redirect the bot conversation to a live agent. This could be triggered by a sentiment analysis. When redirecting the conversation, the person will have an overview of what has been said to the bot, to understand the context and respond in the best way possible.\n\nThe Health bot Service also contains different interrupting scenarios, these can be enabled for certain conversation subjects and are an easy way to step in, if needed.\n\n![Medical Information](images/medicalinfo.png)\n\n## Integration\n\nThe Health Bot Service can interact with your backend systems. With the Data connections configuration, the bot can easily fetch or store data via REST APIs. These connections can be easily secured with the help of standard authentication protocols such as oAuth..\n\n![bot data connections](images/botdataconnections.png)\n\nAn overview of the available data connections of the bot\n\n![Bot Authentication provider](images/botauthprovider.png)\n\nYou can easily link your bot to a backend system\n\nThe Health Bot Service can also communicate with FHIR compliant API’s. When you add a new data connection, you will have the possibility to add a FHIR supported API. With this option your bot can fetch or store FHIR entities.\n\n![creating new bot data connector](images/botdataconnectornew.png)\n\nWhen adding a data connection, there is also support for FHIR\nThe Health Bot Service also has Secrets and Keys, to support your bot, or create secrets to connect with your backend system.\n\n![Bot Secret keys config](images/botsecrets.png)\n\nAn overview of your secrets and keys\n\n## Analytics\n\nWhen you create bot scenario’s, you will notice that sometimes your bot does not understand what the intent of the user is. To constantly make your bot smarter and richer, you can rely on the Unrecognized utterances view.\nThis view contains all the questions that could not be answered by the bot. By monitoring and anticipating on these unrecognized utterances, you can create or extend your scenarios with the information you get by this view.\n\n![Unrecongised utterences](images/unrecongizedutterances.png)\n\nAn overview of all the unrecognized utterances\n\nThe Health bot Service also has an extensive report section, that gives you different insights on the usage of the bot. This varies from the unique users, messages to unrecognized utterances.\n\n## Reporting \n![reporting and insights](images/reporting.png)\n\nUnique Users and message report\n\n![Triage Example Report](images/triagereport.png)\n\nTriage analytics\n\n![Built in scenario report examples](images/builtinscenarios.png)\n\nBuilt in scenario’s reporting examples\n\n![Utterances examples](images/utterances.png)\n\nUnrecognized \u0026 unhandled utterances\n\n## Users\n\nThe Healthbot Service has a User Mangement Portal, where you can manage the users that can access the portal.\n\n![User Management](images/usermanagement.png)\nUser Management portal\n\n## User Management Auditing \n\nWe are working with potential patient data, the service provides an extensive audit trail of who is using the service.\n\n![User Management Auditing](images/usermanagementaudit.png)\n\n## Resources\n\nYou can upload your own images or use your own variables in the Health Bot Service. You can then extend your messages with images to make it more interactive.\n\n![Bot Resources](images/botresources.png)\n\n## Custom Resources\n\nI hope that you now have a better understanding on how the Health Bot Service could be a perfect starting point for your bot journey. If you want to give this a spin, I suggest to create a free version of the Health Bot Service via the Azure Portal.\n\n## Documentation \u0026 Additional Resources\n\nhttps://docs.microsoft.com/HealthBot\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleestott%2Flearnambassadorshealthbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleestott%2Flearnambassadorshealthbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleestott%2Flearnambassadorshealthbot/lists"}