Publishing to Microsoft Teams

Learn how to configure the integration with MS Teams. Let users of Teams message your bot and get quick answers.

To publish your chatbot to Teams, you will need a Bot channels registration in the Microsoft Azure Portal.

Create a Bot channels registration

First, you have to open Azure Portal and create a Bot channels registration. The service is provided free of charge for the so-called premium channels (such as Microsoft Teams), you only need to have an active Azure account. For guidance on how to set up the registration please follow the official documentation.

Obtain your Bot channel registration’s credentials

From the channels registration you should be able to retrieve its App ID and an App Password (a.k.a client secret). You can find them in the Settings and the Certificate and secrets tabs, respectively.

Create a new channel in NativeChat

  1. Open the Channels & Publishing section of your NativeChat bot,
  2. Click the Publish button for Microsoft Teams
  3. Provide the App ID and App Password you have obtained from your channels registration.
  4. Click the Publish button. You will receive a Messaging endpoint URL that you will need to enter in the bot channels registration in Azure.

Configure the Messaging endpoint URL

Open the Settings tab of your Bot channels registration in Azure, paste the endpoint URL that was generated by NativeChat, and click the Save button. This will connect your Azure bot registration with NativeChat and you should now be able to chat with the bot.

Test your bot

With the Web Chat interface in Azure

The easiest way to validate that the setup is correct is to open the Test in Web Chat tab of your Bot channels registration. There you will find a chat window where you should be able to communicate with your bot.

With Microsoft Teams

To add your bot as a contact to your Teams account you will have to:

  1. Add the MS Teams channel in the Channels tab in Azure.
  2. Open the embedding link in your browser.

Please refer to these instructions for more details.

Publishing your bot as a Teams App

The recommended way of distributing Teams bots in production is to create a Teams App. Please use the official guide for details on how to create a manifest and an app package, and how to upload and publish it in Teams.

Enabling file transfer support

If your bot needs to receive or send files you have to enable the supportsFiles setting in your MS Teams App Manifest. If you use App Studio you have to:

  1. Open the Capabilities | Bots wizard page Bots Wizard
  2. Press the Edit button
  3. Tick the checkbox labeled My bot supports uploading and downloading files in the Messaging bot section of the dialog Bot Settings

Known issues

The Microsoft Teams channel is still in Beta and is missing some of the features available in the other channels that NativeChat provides.


Things to consider

  • After a user selects an item using the UI for Single-select, Multi-select or Date-picker they won’t see the actual response in the chat. This behavior of the Adaptive Cards cannot be changed and you may want to add some additional steps to your cognitive flow in order to display the chosen value.