Skip to content

Commit 66d1095

Browse files
committed
Clarity improvements to quickstart
1 parent 07e7790 commit 66d1095

File tree

1 file changed

+15
-11
lines changed

1 file changed

+15
-11
lines changed

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

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -27,34 +27,38 @@ In this quickstart, you learn how to:
2727
## Prerequisites
2828

2929
- An Azure account and an active subscription. Create an [account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
30-
- [Visual Studio 2019 or later](https://visualstudio.microsoft.com/vs/).
31-
- The latest version of .NET Core. In this quickstart, we use [.NET Core 3.1](https://dotnet.microsoft.com/download/dotnet-core/3.1). Be sure to install the version that corresponds with your instance of Visual Studio, 32-bit or 64-bit.
30+
- [Visual Studio 2019 or later](https://visualstudio.microsoft.com/vs/). // TODO: Should this be visual studio 2022? Or VS Code?
31+
- The latest version of .NET Core. In this quickstart, we use [.NET Core 8.0](https://dotnet.microsoft.com/download/dotnet/8.0).
3232
- Bot framework [SDK](https://github.com/microsoft/botframework-sdk/#readme)
3333

3434
## Create and deploy a bot in Azure
3535

3636
To use Azure Communication Services chat as a channel in Azure Bot Service, first deploy a bot. To deploy a bot, you complete these steps:
3737

38-
- Create an Azure Bot Service resource
39-
- Get the bot's app ID and password
40-
- Create a web app to hold the bot logic
41-
- Create a messaging endpoint for the bot
38+
- [Create an Azure Bot Service resource](#create-an-azure-bot-service-resource)
39+
- [Get the bot's app ID and password](#get-the-bots-app-id-and-app-password)
40+
- [Create a web app to hold the bot logic](#create-a-web-app-to-hold-the-bot-logic)
41+
- [Create a messaging endpoint for the bot](#create-a-messaging-endpoint-for-the-bot)
4242

4343
### Create an Azure Bot Service resource
4444

45-
First, [use the Azure portal to create an Azure Bot Service resource](/azure/bot-service/abs-quickstart?tabs=userassigned). Communication Services Chat channel supports single-tenant bots, managed identity bots, and multi-tenant bots. For the purposes of this quickstart we will use a *multi-tenant* bot.
45+
First, [use the Azure portal to create an Azure Bot Service resource](/azure/bot-service/abs-quickstart?tabs=userassigned). Communication Services Chat channel supports single-tenant bots, managed identity bots, and multi-tenant bots.
4646

47-
To set up a single-tenant or managed identity bot, review [Bot identity information](/azure/bot-service/bot-builder-authentication?tabs=userassigned%2Caadv2%2Ccsharp#bot-identity-information).
48-
49-
For a managed identity bot, you might have to [update the bot service identity](/azure/bot-service/bot-builder-authentication?tabs=userassigned%2Caadv2%2Ccsharp#to-update-your-app-service).
47+
- For the purposes of this quickstart we will use a `multi-tenant` bot.
48+
- To set up a `single-tenant` or `managed identity` bot, review [Bot identity information](/azure/bot-service/bot-builder-authentication?tabs=userassigned%2Caadv2%2Ccsharp#bot-identity-information).
49+
- For a `managed identity` bot, you might have to [update the bot service identity](/azure/bot-service/bot-builder-authentication?tabs=userassigned%2Caadv2%2Ccsharp#to-update-your-app-service).
5050

5151
### Get the bot's app ID and app password
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

5555
### Create a web app to hold the bot logic
5656

57-
To create a web app for your bot, you can revise [Bot Builder samples](https://github.com/Microsoft/BotBuilder-Samples) for your scenario or use the [Bot Builder SDK](/composer/introduction) to create a web app. One of the simplest samples is [Echo Bot](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/02.echo-bot).
57+
To create a web app for your bot, you can do one of the following:
58+
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).
61+
- Use the [Bot Builder SDK](/composer/introduction) to create and publish a bot to a web app.
5862

5963
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.
6064

0 commit comments

Comments
 (0)