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
- Open the Channels & Publishing section of your NativeChat bot,
- Click the Publish button for Microsoft Teams
- Provide the App ID and App Password you have obtained from your channels registration.
- 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:
- Add the MS Teams channel in the Channels tab in Azure.
- 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:
- Open the Capabilities | Bots wizard page
- Press the Edit button
- Tick the checkbox labeled My bot supports uploading and downloading files in the Messaging bot section of the dialog
The Microsoft Teams channel is still in Beta and is missing some of the features available in the other channels that NativeChat provides.
- Location picker is not supported
- Third-party Authentication is not supported
- Single-select and Multi-select do not support images and subtitles. They show only each item’s title field.