Before others can use your bot, you must register it with the Bot Framework. Registration is a simple process. You are prompted to provide some information about your bot and then the portal generates the app ID and password that your bot will use to authenticate with the Bot Framework.
Bots created with the Azure Bot Service are automatically registered as part of the creation process.
Register your bot
To register your bot, sign in to the Bot Framework Portal, click Register, and complete the following steps.
Complete the Bot profile section of the form.
- Upload an icon that will represent your bot in the conversation.
- Provide your bot's Display Name. When users search for this bot, this is the name that will appear in the search results.
- Provide a Description of your bot. This is the description that will appear in search results, so it should accurately describe what the bot does.
Complete the Configuration section of the form.
Provide your bot's HTTPS endpoint. This is the endpoint where your bot will receive HTTP POST messages from Bot Connector. If you built your bot by using the Bot Builder SDK, the endpoint should end with
- If you have already deployed your bot to the cloud, specify the endpoint generated from that deployment.
- If you have not yet deployed your bot to the cloud, leave the endpoint blank for now. You will return to the Bot Framework Portal later and specify the endpoint after you've deployed your bot.
Click Manage Microsoft App ID and password.
- On the next page, click Generate an app password to continue.
- Copy and securely store the password that is shown, and then click Ok.
- Click Finish and go back to Bot Framework.
- Back in the Bot Framework Portal, the App ID field is now populated.
Click Register to complete the registration process.
After you've registered your bot, update the Microsoft App Id and Microsoft App Password values in your application's configuration settings to specify the app ID and password values that were generated for your bot during the registration process.
If you're using the Bot Builder SDK for Node.js, set the following environment variables:
Update or delete registration
- Sign in to the Bot Framework Portal.
- Click My Bots.
- Select the bot that you want to configure and click Settings.
- To generate a new password, click Manage Microsoft App ID and password.
- To delete a bot, click Delete bot.
After you have registered your bot with the Bot Framework, the next step in the bot publication process will depend upon whether or not you've already deployed your bot to the cloud.
If you have not yet deployed your bot to the cloud:
Deploy your bot to the cloud by following the instructions found in Deploy a bot to the cloud.