kingsonn / covid19healthcarebotquickstart

Describes a a quickstart for the Azure healthcare bot

#COVID-19 Healthcare bot #About This script uses the Microsoft healthcarebot framework to quickly deploy a COVID19 triage bot. This bto can be later customized.

Sample bot: https://healthbotcontainersamplee67f.azurewebsites.net

1. Go to portal and click + and create (subscribe) "Microsoft Healthcare Bot"

2. You'll get a link to a config portal via email (From "Microsoft Marketplace")- click on the link in your email

3. You'll need to name your bot. This name will display to users. Ex: Vivi

4. Chose the location for the bot. (ex: USA) Elapsed time: 5 mins

5. Find covid-19 response template (there are other tempaltes here)

6. Click on that template and give it a "Specify main scenario name" ex: SameerCOVID-19

7. You'll see the visual designer. Click save. Read more below. This view allows you to edit the scenario using either the visual interface or a javascript code editor. You can get back to this at anypoint by coming back to the config portal and clicking manage.

8. If you're in the editor click the Exit button (on top right)

9. On the side menu pane click the button with two arrows collapsing labele integration. Then click secrets

10. Grab web chat secret and app secret.

11. Go to: https://github.com/microsoft/HealthBotContainerSample

12. Click Deploy to Azure

13. Fill in the form (chose sub, RG, location)

14. Once deployed go back to Azure Portal

15. Find and click on the app service it created.

16. Click App Configuration and under app settings you'll add two new settings.

17. Add "APP_SECRET" with value from above

18. Add "WEBCHAT_SECRET" with value from above

19. Click save to save changes.

20. Go to app service editor

21. Edit wwwroot\public\index.js

22. Replace contents of liens 55 and 72 with a space

23. Change value on line 87 to "covid19" (or whatever the id of the scenario template)

24. Remove args lines It should look like:

    botConnection.postActivity({
        type: "invoke",
        value: {
            trigger: "covid19",
        },
        from: user,
        name: "TriggerScenario"
    }).subscribe(function(id) {});

24. Find website url on overview page of app service and Visit website. (no restart required) ##Style Customization
25. Notice the text entry box at the bottom of your app? If you don't like that then please add the following lines to index.js add the following to styleOptions hashtable on line 29.

  hideSendBox: true,
  hideUploadButton: true

Final block will ook like:

  const styleOptions = {
        hideSendBox: true,
        hideUploadButton: true
        botAvatarImage: 'https://docs.microsoft.com/en-us/azure/bot-service/v4sdk/media/logo_bot.svg?view=azure-bot-service-4.0',
        // botAvatarInitials: '',
        // userAvatarImage: '',
        userAvatarInitials: 'You'
    }

You can find additional style options here

Move this to another site

26. Add the bot to your webstite using the steps here 26a. a way you can do this is by dropping

<iframe src="<APP SERVICE URL>" height="height" width="width" />

27. Now customize the template

Production Checklist

Before you go prod , some suggestions: 1 Add resource locks to prod RGs 2 Crete dev environment and transition RBAC 3 Crete dev bot and transition editors to dev bot 4 Setup auto-scale rules 5 Setup monitoring and alerting rules 6 Enable backup 7 (Ideal) Setup TM profile infront of app service or scale set 8 Obtain SSL cert for TM CNAME

Passing Username to bot

If you secured your bot webchat using App Service Authentication you may want to pass that auth to the bot as a secario Arg. No problem!

Edit server.js

Find the following function:

app.post('/chatBot',  function(req, res) {

Edit 1: change:

var userid = req.query.userId || req.cookies.userid;

to

var userid = req.query.userId || req.headers['x-ms-client-principal-name']

Edit 2: Change:

response['userName'] = req.query.userName;

to

response['userName'] = userid;

Edit index.js

Now pass the username to the bot

triggeredScenario: {
    trigger: "asfd",
    args: {
        username: user.name
    }
}

Update the scenario tempalte

To use this scenario argument use a statement block like:

scenario.scenarioArgs.username ?
"I think your name is " + scenario.scenarioArgs.username + " but what do you want to call you?" :
"What's your firstname?"

The above block of code is equivalent to:

if(scenario.scenarioArgs.username){
    "I think your name is " + scenario.scenarioArgs.username + " but what do you want to call you?" 
}else{
    "What's your firstname?")
}

NOTES THIS CODE-SAMPLE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE. This sample is not supported under any Microsoft standard support program or service. The script is provided AS IS without warranty of any kind. Microsoft further disclaims all implied warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or performance of the sample and documentation remains with you. In no event shall Microsoft, its authors, or anyone else involved in the creation, production, or delivery of the script be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the sample or documentation, even if Microsoft has been advised of the possibility of such damages, rising out of the use of or inability to use the sample script, even if Microsoft has been advised of the possibility of such damages.