Create your first Health Bot

This Quickstart guide will walk you through creating your first Azure Health Bot.

At the end of this guide you will be able to access a white-labeled bot instance that can be embedded within your app or website. You can customize the built-in functionality and extend to introduce your own business flows through simple and intuitive visual editing tools


An Azure account is required to complete these steps. If you don't have an Azure subscription, create a free account before you begin.

  1. Once you have an Azure account, sign-in to the Azure portal.

  2. In the global search look for "Health Bot"

  3. In the Health Bot management blade, click "Create" to create a new Health Bot instance

  4. Follow the steps in the resource creation wizard and provide the required details for your new Health Bot resource

  • Subscription: The Azure subscription that will be charged if you use a paid version of Health Bot
  • Resource group: Create a new group or use an existing group to organize your Health Bot instances
  • Name: Name for the bot that appears in the conversations. The name can only use lowercase letters and hyphens (-). The name must start with a letter and can't end with a hyphen (-) and must be between 2 and 30 characters in length.
  • Region: Determine the location of the deployment data center for your instance . Note that the it's best to choose a location closest to your customer. The location cannot be changed once the bot is created.
  • Plan: Choose between the free and standard paid plans.

You can optionally add tags to the resource or complete the creation by clicking "Review + create".

  1. Start the creation process and wait a few minutes for the deployment process to complete. Once the resource is available, click "Go to resource"

  2. Explore the resource details in the resource overview page. You can now navigate to "Health Bot Management Portal" to discover the available functionality and start authoring custom scenarios for your bot.

Next steps

Create your first custom scenario