This bot has been created using [Bot Framework](https://dev.botframework.com), it shows how to create a simple bot that accepts input from the user and echoes it back.

This sample is a Spring Boot app and uses the Azure CLI and azure-webapp Maven plugin to deploy to Azure.

- Java 1.8+

- Install [Maven](https://maven.apache.org/)

- An account on [Azure](https://azure.microsoft.com) if you want to deploy to Azure.

- From the root of this project folder:

- Build the sample using `mvn package`

- Run it by using `java -jar .\target\<%= artifact %>-1.0.0.jar`

- Test the bot using Bot Framework Emulator

[Bot Framework Emulator](https://github.com/microsoft/botframework-emulator) is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel.

- Install the Bot Framework Emulator version 4.3.0 or greater from [here](https://github.com/Microsoft/BotFramework-Emulator/releases)

- Connect to the bot using Bot Framework Emulator

- Launch Bot Framework Emulator

- File -> Open Bot

- Enter a Bot URL of `http://localhost:3978/api/messages`

As described on [Deploy your bot](https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-deploy-az-cli), you will perform the first 4 steps to setup the Azure app, then deploy the code using the azure-webapp Maven plugin.

From a command (or PowerShell) prompt in the root of the bot folder, execute:

If you aren't sure which subscription to use for deploying the bot, you can view the list of subscriptions for your account by using `az account list` command.

Replace `<botname>` and `<appsecret>` with your own values.

`<botname>` is the unique name of your bot.

`<appsecret>` is a minimum 16 character password for your bot.

Record the `appid` from the returned JSON

Replace the values for `<appid>`, `<appsecret>`, `<botname>`, and `<groupname>` in the following commands:

In src/main/resources/application.properties update

- `MicrosoftAppPassword` with the botsecret value

- `MicrosoftAppId` with the appid from the first step

- Execute `mvn clean package`

- Execute `mvn azure-webapp:deploy -Dgroupname="<groupname>" -Dbotname="<botname>"`

If the deployment is successful, you will be able to test it via "Test in Web Chat" from the Azure Portal using the "Bot Channel Registration" for the bot.

After the bot is deployed, you only need to execute #6 if you make changes to the bot.

- [Maven Plugin for Azure App Service](https://docs.microsoft.com/en-us/java/api/overview/azure/maven/azure-webapp-maven-plugin/readme?view=azure-java-stable)

- [Spring Boot](https://spring.io/projects/spring-boot)

- [Azure for Java cloud developers](https://docs.microsoft.com/en-us/azure/java/?view=azure-java-stable)

- [Bot Framework Documentation](https://docs.botframework.com)

- [Bot Basics](https://docs.microsoft.com/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0)

- [Activity processing](https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-concept-activity-processing?view=azure-bot-service-4.0)

- [Azure Bot Service Introduction](https://docs.microsoft.com/azure/bot-service/bot-service-overview-introduction?view=azure-bot-service-4.0)

- [Azure Bot Service Documentation](https://docs.microsoft.com/azure/bot-service/?view=azure-bot-service-4.0)

{

"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",

"contentVersion": "1.0.0.0",

"parameters": {

"groupLocation": {

"defaultValue": "",

"type": "string",

"metadata": {

"description": "Specifies the location of the Resource Group."

}

},

"groupName": {

"type": "string",

"metadata": {

"description": "Specifies the name of the Resource Group."

}

},

"appId": {

"type": "string",

"metadata": {

"description": "Active Directory App ID, set as MicrosoftAppId in the Web App's Application Settings."

}

},

"appSecret": {

"type": "string",

"metadata": {

"description": "Active Directory App Password, set as MicrosoftAppPassword in the Web App's Application Settings."

}

},

"botId": {

"type": "string",

"metadata": {

"description": "The globally unique and immutable bot ID. Also used to configure the displayName of the bot, which is mutable."

}

},

"botSku": {

"defaultValue": "S1",

"type": "string",

"metadata": {

"description": "The pricing tier of the Bot Service Registration. Acceptable values are F0 and S1."

}

},

"newAppServicePlanName": {

"defaultValue": "",

"type": "string",

"metadata": {

"description": "The name of the App Service Plan."

}

},

"newAppServicePlanSku": {

"type": "object",

"defaultValue": {

"name": "P1v2",

"tier": "PremiumV2",

"size": "P1v2",

"family": "Pv2",

"capacity": 1

},

"metadata": {

"description": "The SKU of the App Service Plan. Defaults to Standard values."

}

},

"newAppServicePlanLocation": {

"defaultValue": "",

"type": "string",

"metadata": {

"description": "The location of the App Service Plan. Defaults to \"westus\"."

}

},

"newWebAppName": {

"type": "string",

"defaultValue": "",

"metadata": {

"description": "The globally unique name of the Web App. Defaults to the value passed in for \"botId\"."

}

}

},

"variables": {

"appServicePlanName": "[parameters('newAppServicePlanName')]",

"resourcesLocation": "[parameters('newAppServicePlanLocation')]",

"webAppName": "[if(empty(parameters('newWebAppName')), parameters('botId'), parameters('newWebAppName'))]",

"siteHost": "[concat(variables('webAppName'), '.azurewebsites.net')]",

"botEndpoint": "[concat('https://', variables('siteHost'), '/api/messages')]",

"publishingUsername": "[concat('$', parameters('newWebAppName'))]",

"resourceGroupId": "[concat(subscription().id, '/resourceGroups/', parameters('groupName'))]"

},

"resources": [

{

"name": "[parameters('groupName')]",

"type": "Microsoft.Resources/resourceGroups",

"apiVersion": "2018-05-01",

"location": "[parameters('groupLocation')]",

"properties": {}

},

{

"type": "Microsoft.Resources/deployments",

"apiVersion": "2018-05-01",

"name": "storageDeployment",

"resourceGroup": "[parameters('groupName')]",

"dependsOn": [

"[resourceId('Microsoft.Resources/resourceGroups/', parameters('groupName'))]"

],

"properties": {

"mode": "Incremental",

"template": {

"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",

"contentVersion": "1.0.0.0",

"parameters": {},

"variables": {},

"resources": [

{

"comments": "Create a new Linux App Service Plan if no existing App Service Plan name was passed in.",

"type": "Microsoft.Web/serverfarms",

"name": "[variables('appServicePlanName')]",

"apiVersion": "2018-02-01",

"location": "[variables('resourcesLocation')]",

"sku": "[parameters('newAppServicePlanSku')]",

"kind": "linux",

"properties": {

"perSiteScaling": false,

"maximumElasticWorkerCount": 1,

"isSpot": false,

"reserved": true,

"isXenon": false,

"hyperV": false,

"targetWorkerCount": 0,

"targetWorkerSizeId": 0

}

},

{

"comments": "Create a Web App using a Linux App Service Plan",

"type": "Microsoft.Web/sites",

"apiVersion": "2018-11-01",

"location": "[variables('resourcesLocation')]",

"kind": "app,linux",

"dependsOn": [

"[concat(variables('resourceGroupId'), '/providers/Microsoft.Web/serverfarms/', variables('appServicePlanName'))]"

],

"name": "[variables('webAppName')]",

"properties": {

"name": "[variables('webAppName')]",

"hostNameSslStates": [

{

"name": "[concat(parameters('newWebAppName'), '.azurewebsites.net')]",

"sslState": "Disabled",

"hostType": "Standard"

},

{

"name": "[concat(parameters('newWebAppName'), '.scm.azurewebsites.net')]",

"sslState": "Disabled",

"hostType": "Repository"

}

],

"serverFarmId": "[variables('appServicePlanName')]",

"reserved": true,

"isXenon": false,

"hyperV": false,

"scmSiteAlsoStopped": false,

"clientAffinityEnabled": true,

"clientCertEnabled": false,

"hostNamesDisabled": false,

"containerSize": 0,

"dailyMemoryTimeQuota": 0,

"httpsOnly": false,

"redundancyMode": "None",

"siteConfig": {

"appSettings": [

{

"name": "JAVA_OPTS",

"value": "-Dserver.port=80"

},

{

"name": "MicrosoftAppId",

"value": "[parameters('appId')]"

},

{

"name": "MicrosoftAppPassword",

"value": "[parameters('appSecret')]"

}

],

"cors": {

"allowedOrigins": [

"https://botservice.hosting.portal.azure.net",

"https://hosting.onecloud.azure-test.net/"

]

}

}

}

},

{

"type": "Microsoft.Web/sites/config",

"apiVersion": "2018-11-01",

"name": "[concat(variables('webAppName'), '/web')]",

"location": "[variables('resourcesLocation')]",

"dependsOn": [

"[concat(variables('resourceGroupId'), '/providers/Microsoft.Web/sites/', variables('webAppName'))]"

],

"properties": {

"numberOfWorkers": 1,

"defaultDocuments": [

"Default.htm",

"Default.html",

"Default.asp",

"index.htm",

"index.html",

"iisstart.htm",

"default.aspx",

"index.php",

"hostingstart.html"

],

"netFrameworkVersion": "v4.0",

"linuxFxVersion": "JAVA|8-jre8",

"requestTracingEnabled": false,

"remoteDebuggingEnabled": false,

"httpLoggingEnabled": false,

"logsDirectorySizeLimit": 35,

"detailedErrorLoggingEnabled": false,

"publishingUsername": "[variables('publishingUsername')]",

"scmType": "None",

"use32BitWorkerProcess": true,

"webSocketsEnabled": false,

"alwaysOn": true,

"managedPipelineMode": "Integrated",

"virtualApplications": [

{

"virtualPath": "/",

"physicalPath": "site\\wwwroot",

"preloadEnabled": true

}

],

"loadBalancing": "LeastRequests",

"experiments": {

"rampUpRules": []

},

"autoHealEnabled": false,

"localMySqlEnabled": false,

"ipSecurityRestrictions": [

{

"ipAddress": "Any",

"action": "Allow",

"priority": 1,

"name": "Allow all",

"description": "Allow all access"

}

],

"scmIpSecurityRestrictions": [

{

"ipAddress": "Any",

"action": "Allow",

"priority": 1,

"name": "Allow all",

"description": "Allow all access"

}

],

"scmIpSecurityRestrictionsUseMain": false,

"http20Enabled": false,

"minTlsVersion": "1.2",

"ftpsState": "AllAllowed",

"reservedInstanceCount": 0

}

},

{

"apiVersion": "2021-03-01",

"type": "Microsoft.BotService/botServices",

"name": "[parameters('botId')]",

"location": "global",

"kind": "azurebot",

"sku": {

"name": "[parameters('botSku')]"

},

"properties": {

"name": "[parameters('botId')]",

"displayName": "[parameters('botId')]",

"iconUrl": "https://docs.botframework.com/static/devportal/client/images/bot-framework-default.png",

"endpoint": "[variables('botEndpoint')]",

"msaAppId": "[parameters('appId')]",

"luisAppIds": [],

"schemaTransformationVersion": "1.3",

"isCmekEnabled": false,

"isIsolated": false

},

"dependsOn": [

"[concat(variables('resourceGroupId'), '/providers/Microsoft.Web/sites/', variables('webAppName'))]"

]

}

],

"outputs": {}

}

}

}

]

}