The information on this page pertains to the legacy version of Botkit, 0.7 and below and may be out of date! Documentation for the new v4+ version of Botkit can be found here.

Configure Botkit and Microsoft Teams

Building a bot with Botkit and the Microsoft Teams API gives you access to all of the best tools and options available to create a feature-rich app for Teams.

We've created the following guide to help you configure your Microsoft Teams bot.

Step 1 Register your bot with Bot Framework

Microsoft Teams first requires you to register with their "Bot Framework" before you can add a bot to your Teams team. This is a multi-step process:

Create an account / Log in

Log into the Bot Framework Developer Portal using your Microsoft credentials, or create an account.

Register a new bot

Once you are logged in, click this link to create a new bot and then you can skip the next two steps!

You will be asked some questions about your bot. Some of these can be changed later, but some cannot be changed so consider your responses carefully!

These are the important fields when creating your bot:

Generate your keys

Register your bot with Microsoft by clicking: Create Microsoft App ID and password

This action will take you to a new website (and require you to log in again) and then ask you for an App name.

Once added, it will provide an App ID which you need to copy somewhere safe to use in the next step.

Next, click Generate password. This will only be shown to you once, if you lose it, you will need to invalidate the old one and set this up again!

Click Register.

Add the Microsoft Teams channel

Add the Microsoft Teams channel from the list of channels, making sure the Enabled is set to on.

You will want to leave this window open as you finish setting up Botkit, as you will need to come back here before you are done.

Step 4 - Deploy your bot and install to a team

Turn on your Botkit app

Now that everything is setup on Microsoft's side, you can run Botkit using the method you've chosen and with the information created in the Bot framework in the previous step.

Update your Messaging Endpoint in Bot Framework

Once a Botkit instance is running, you may have a new URL that you will have to update in the bot's settings in Microsoft Bot Framework.

Once logged in to that page:

Create your Application Manifest

To add a development bot on a team, you will need to prepare an App Package.

Sideload your Bot to Microsoft Teams

After creating your app package, you can load it easily into your development team.

Say hello to your real live bot!

Step 5 - Add dialogue and features

Once you have a bot up and running, you can start the fun part of making your bot functional.

You can extend your bot's functionality using various Botkit Middleware, or check our example library for a good starting point.

If you have questions or suggestions, please take a look at our community support resources. You can chat with contributors and enthusiasts in our Slack community.

Additional resources

Is something missing or out of date?

This file is managed on Github. click here to view the source, and send us a pull request with your improvements!

Back to top