Skip to content

Commit 2ef7f91

Browse files
committed
Clarity improvements around bot app
1 parent 66d1095 commit 2ef7f91

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

articles/communication-services/quickstarts/chat/quickstart-botframework-integration.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -52,17 +52,20 @@ First, [use the Azure portal to create an Azure Bot Service resource](/azure/bot
5252

5353
Next, [get the Microsoft app ID and password](/azure/bot-service/abs-quickstart?tabs=userassigned#to-get-your-app-or-tenant-id) that are assigned to your bot when it's deployed. You use these values for later configurations.
5454

55-
### Create a web app to hold the bot logic
55+
### Create a bot app and publish it to a web app
5656

57-
To create a web app for your bot, you can do one of the following:
57+
To create a bot you can do one of the following:
5858

59-
- Revise [Bot Builder samples](https://github.com/Microsoft/BotBuilder-Samples) for your scenario and deploy the bot to a web app.
60-
- One of the simplest samples is [Echo Bot](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/02.echo-bot).
59+
- Revise [Bot Builder samples](https://github.com/Microsoft/BotBuilder-Samples) for your scenario, create a web app, and then deploy your bot sample to it.
6160
- Use the [Bot Builder SDK](/composer/introduction) to create and publish a bot to a web app.
6261

62+
For this quickstart we will use the [Echo Bot](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/02.echo-bot) sample from the Bot Builder samples.
63+
64+
#### Create a web app to hold the bot app
65+
6366
Azure Bot Service typically expects the Bot Application Web App Controller to expose an endpoint in the form `/api/messages`. The endpoint handles all messages that are sent to the bot.
6467

65-
To create the bot app, either use the Azure CLI to [create an Azure App Service resource](/azure/bot-service/provision-app-service?tabs=singletenant%2Cexistingplan) or create the app in the Azure portal.
68+
To create the web app, either use the Azure CLI to [create an Azure App Service resource](/azure/bot-service/provision-app-service?tabs=singletenant%2Cexistingplan) or create the app in the Azure portal.
6669

6770
To create a bot web app by using the Azure portal:
6871

@@ -80,7 +83,7 @@ To create a bot web app by using the Azure portal:
8083

8184
:::image type="content" source="./media/web-app-endpoint.png" alt-text="Screenshot that shows how to copy the web app endpoint URL.":::
8285

83-
### Create a messaging endpoint for the bot
86+
#### Create a messaging endpoint for the bot
8487

8588
Next, in the bot resource, create a web app messaging endpoint:
8689

@@ -92,9 +95,9 @@ Next, in the bot resource, create a web app messaging endpoint:
9295

9396
:::image type="content" source="./media/smaller-bot-configure-with-endpoint.png" alt-text="Screenshot that shows how to create a bot messaging endpoint by using the web app hostname." lightbox="./media/bot-configure-with-endpoint.png":::
9497

95-
### Deploy the web app
98+
#### Deploy the web app
9699

97-
The final step to create a bot is to deploy the web app. For this quickstart, use the Echo Bot sample. The Echo Bot functionality is limited to echoing the user input. Here's how you deploy it to your web app in Azure:
100+
The final step to create a bot is to deploy the web app. For this quickstart, use the [Echo Bot](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/02.echo-bot) sample. The Echo Bot functionality is limited to echoing the user input. Here's how you deploy it to your web app in Azure:
98101

99102
1. Use Git to clone this GitHub repository:
100103

0 commit comments

Comments
 (0)