Bot-docs: documentation suggests "new app service" but web app bots are being deprecated....

[joslat]

Hi,

The documentation suggests deploying by creating an app service... but they are no longer needed in the new Azure Bots...
but they are on the old ones, deprecated on 9/1/2021...

(as stated in the marketplace...)

What is the best way to do this for the new bots? (Azure Bot)

Otherwise, is there documentation covering the new "Azure Bot"s which is up to date or can be used as a guidance?

Following visual studio quickstarts with the templates, seems to be creating bots based in the app service model...

So a bit puzzled/troubled... what should we follow? the documentation, guidance and templates are a bit conflicting each other...

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 096d934c-2856-e868-efeb-6622e2a5eafb
• Version Independent ID: 8bf74926-6a35-5753-0a1a-6663ba5965b2
• Content: Deploy your bot - Bot Service
• Content Source: articles/bot-builder-deploy-az-cli.md
• Service: bot-service
• GitHub Login: @ivorb
• Microsoft Alias: kamrani

[JonathanFingold]

1. New bots should use the _Azure Bot_ resource type, instead of the _Web App Bot_ or _Channels Registration_ resource types. That said, existing bots will continue to work with those resource types past the 9/1/2021 date, you just won't be able to create new resources of those types.
2. Azure would create bot code for you when you created a new Web App Bot, which is not the case for Azure Bot or Channels Registration resources.
3. Going forward, you can create a bot locally from a template and then deploy it to an Azure Bot resource.
4. If you're just starting out with the Bot Framework, try starting with Bot Framework Composer.

This is a relatively new change, and we obviously missed a couple of the corners. Let me know if you have other questions about this. I'll work on updating this and adjacent docs.

[JayZuo]

As per the doc https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-deploy-az-cli?view=azure-bot-service-4.0&tabs=csharp#deploy-via-arm-template-with-existing-resource-group

Web App Bot and Bot Channels Registration will be deprecated but existing resources will continue to work. Bots created with a version 4.13.0 or later template will generate an Azure Bot resource.

I'm using the newest Templates (4.14.0), however, it still creates a new Web App and Bot Channels Registration. So I'm having the same questions as @joslat.

@JonathanFingold How can we create a bot locally from a template and then deploy it to an Azure Bot resource (not Web App and Bot Channels Registration)?

[JonathanFingold]

This seems like an issue with the templates. I'll follow up with one of the devs, and possibly open or transfer this issue to another repository.

[JonathanFingold]

There's an existing issue in the Samples repo requesting this fix, see linked botbuilder-samples issue 3340.

[JonathanFingold]

Devs are engaged in the samples issue. Closing the docs issue.

[joslat]

So we just should wait, learning bots with the current documentation and guidance point to "web app style" that's outdated... and completely deprecated in 1 month and some days... yes?

[JonathanFingold]

Unfortunately, my understanding is yes. I've asked for further comment here from one of the PMs on the team.