You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cognitive-services/Speech-Service/tutorial-voice-enable-your-bot-speech-sdk.md
+27-24Lines changed: 27 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -231,66 +231,69 @@ You'll need to make a small configuration change so that your bot can communicat
231
231
232
232
## Create a channel registration
233
233
234
-
Now that you've created an Azure App Service to host your bot, the next step is to create a**Bot Channels Registration**. Creating a channel registration is a prerequisite for registering your bot with Bot Framework channels, including Direct Line Speech channel. If you'd like to learn more about how bots use channels, see [Connect a bot to channels](/azure/bot-service/bot-service-manage-channels).
234
+
Now that you've created an Azure App Service to host your bot, the next step is to create an**Azure Bot**. Creating a channel registration is a prerequisite for registering your bot with Bot Framework channels, including Direct Line Speech channel. If you'd like to learn more about how bots use channels, see [Connect a bot to channels](/azure/bot-service/bot-service-manage-channels).
235
235
236
-
1. <ahref="https://ms.portal.azure.com/#create/Microsoft.BotServiceConnectivityGalleryPackage"target="_blank">Create an Azure Bot Channels Registration </a>
237
-
2. You'll be prompted to provide some information:
236
+
1. <ahref="https://ms.portal.azure.com/#create/Microsoft.AzureBot"target="_blank">Create an Azure Bot</a>
237
+
1. You'll be prompted to provide some information:
238
238
* For **Bot handle**, enter **SpeechEchoBotTutorial-BotRegistration-####** and replace **####** with your a number of your choice. Note that Bot handle must be globally unique. If you enter a Bot handle but get the error message _The requested bot ID is not available_, then pick a different number. In the examples below we used 8726
239
239
* For **Subscription**, select **Free Trial**.
240
240
* For **Resource group**, select **SpeechEchoBotTutorial-ResourceGroup**.
241
-
* For **Location**, select **West US**.
242
-
* For **Pricing tier**, select **F0**.
243
-
* For **Messaging endpoint**, enter the URL for your web app with the `/api/messages` path appended at the end. For example: if your globally unique App Name was **EchoBot20190805125647**, your messaging endpoint would be: `https://EchoBot20190805125647.azurewebsites.net/api/messages/`.
244
-
* For **Application insights**, you can set this to **Off**. For more information, see [Bot analytics](/azure/bot-service/bot-service-manage-analytics).
245
-
* Ignore **Auto create App ID and password**.
246
-
5. At the bottom of the **Bot Channels Registration** blade, click **Create**.
241
+
* For **Location**, select **West US**.
242
+
* For **Pricing tier**, select **F0**.
243
+
* Ignore **Auto create App ID and password**.
244
+
1. At the bottom of the **Azure Bot** blade, select **Create**.
245
+
1. After you create the resource, open your **SpeechEchoBotTutorial-BotRegistration-####** resource in the Azure portal.
246
+
1. From the **Settings** navigation, select **Configuration**.
247
+
1. For **Messaging endpoint**, enter the URL for your web app with the `/api/messages` path appended. For example, if your globally unique app name was **EchoBot20190805125647**, your messaging endpoint would be `https://EchoBot20190805125647.azurewebsites.net/api/messages/`.
247
248
248
249
At this point, check your Resource Group **SpeechEchoBotTutorial-ResourceGroup** in the Azure portal. It should now show at least four resources:
249
250
250
251
| Name | Type | Location |
251
252
|------|-------|----------|
252
253
| EchoBot20190805125647 | App Service | West US |
253
254
| SpeechEchoBotTutorial-AppServicePlan | App Service plan | West US |
254
-
| SpeechEchoBotTutorial-BotRegistration-8726 |Bot Channels Registration| Global |
255
+
| SpeechEchoBotTutorial-BotRegistration-8726 |Azure Bot| Global |
255
256
| SpeechEchoBotTutorial-Speech | Cognitive Services | West US |
256
257
257
258
> [!IMPORTANT]
258
-
> The Bot Channels Registration resource will show the Global region even though you selected West US. This is expected.
259
+
> The Azure Bot resource will show the Global region, even though you selected West US. This is expected.
259
260
260
261
## Optional: Test in web chat
261
262
262
-
The Azure Bot Channels Registration page has a **Test in Web Chat** option under **Bot Management**. It will not work by default with your bot, since web chat needs to authenticate against your bot. If you would like to test your deployed bot with text input, follow the steps below. Note that these steps are optional, and are not required in order to continue with the next steps of the tutorial.
263
+
The Azure Bot page has a **Test in Web Chat** option under **Settings**. It will not work by default with your bot because web chat needs to authenticate against your bot. If you would like to test your deployed bot with text input, follow the steps below. Note that these steps are optional and are not required for you to continue with the next steps of the tutorial.
263
264
264
265
1. Locate and open your **EchoBotTutorial-BotRegistration-####** resource in the [Azure portal](https://portal.azure.com)
265
-
1. From the **Bot management** navigation, select **Settings**. Copy the value under **Microsoft App ID**
266
+
1. From the **Settings** navigation, select **Configuration**. Copy the value under **Microsoft App ID**
266
267
1. Open the Visual Studio EchoBot solution. In the solution explorer, locate and double click on **appsettings.json**
267
268
1. Replace the empty string next to **MicrosoftAppId** in the JSON file with the copied ID value
268
-
1. Got back to the Azure portal, in **Bot management** navigation, select **Settings**, and click on **(Manage)** next to **Microsoft App ID**
269
+
1. Got back to the Azure portal, in **Settings** navigation, select **Configuration**, and click on **(Manage)** next to **Microsoft App ID**
269
270
1. Click on **New client secret**. Add a description (e.g. "web chat") and click **Add**. Copy the new secret
270
271
1. Replace the empty string next to **MicrosoftAppPassword** in the JSON file with the copied secret value
271
272
1. Save the JSON file. It should look something like this:
9. Re-publish the app (right-click on **EchoBot** project in Visual Studio solution explorer, select **Publish...** and click on the **Publish** button)
279
-
10. Now you are ready to test the bot in web chat!
1. Republish the app (right-click on **EchoBot** project in Visual Studio Solution Explorer, select **Publish...** and click on the **Publish** button)
282
+
1. Now you are ready to test the bot in web chat!
280
283
281
284
## Register the Direct Line Speech channel
282
285
283
286
Now it's time to register your bot with the Direct Line Speech channel. This channel creates a connection between your bot and a client app compiled with the Speech SDK.
284
287
285
288
1. Locate and open your **SpeechEchoBotTutorial-BotRegistration-####** resource in the [Azure portal](https://portal.azure.com).
286
-
1. From the **Bot management** navigation, select **Channels**.
289
+
1. From the **Settings** navigation, select **Channels**.
287
290
* Under **More channels**, click **Direct Line Speech**.
288
291
* Review the text on the page titled **Configure Direct line Speech**, then expand the **Cognitive service account** drop-down menu.
289
292
* Select the speech resource you created earlier (e.g., **SpeechEchoBotTutorial-Speech**) from the menu to associate your bot to your speech subscription key.
290
293
* Ignore the rest of the optional fields.
291
294
* Click **Save**.
292
295
293
-
1. From the **Bot management** navigation, click **Settings**.
296
+
1. From the **Settings** navigation, click **Configuration**.
294
297
* Check the box labeled **Enable Streaming Endpoint**. This is needed to create a communication protocol built on web sockets between your bot and the Direct Line Speech channel.
0 commit comments