How to configure the Microsoft Teams Integration on premise


On premise, the MS Teams configuration cannot be done automatically for security reasons. You will need to manually create a custom bot and link it with your Toucan Toco platform. In order to do that, you will need the Teams administrator privilege on your Azure Active Directory.


The below only applies for self-hosted platforms (aka. on premise). For “standard” cloud platforms, use this doc.

Step 1: Create a custom bot with the Microsoft Teams developer portal

Go to the Teams bot management portal and login with your enterprise microsoft account.

Then, click on “Add Bot”: image0

In the “Add bot” popup, fill in “Toucan Toco Bot” and click “Add”: image1

After some time, you should see a success message and then on the following screen, click on “Client secrets”: image2

On the “Client secrets” screen, click on “Add a client secret for your bot”: image3

You should see a “new cient secret generated” message. Copy the secret and store it securely for later use. Make sure to copy the value before clicking “OK”. image4

Copy also the bot ID. The easiest way to do that is to copy it from the URL, it appears between and /client-secrets For example, below it is 242771b7-23a0-4410-81ef-ac14cc2a4934. Store it securely next to your bot password for later use. image5

Step 2: add the custom bot to your teams organization

Download the app zip package, unzip it and in manifest.json replace occurrences of <put your bot id here> by your bot id. image6

Re-zip the file: this file is the custom app package you will updload to the Teams app store for your organization.

Go to your Teams apps. After clicking on Manage your apps, you should have a Upload an app to your org's app catalog button. image7

Upload the zip file you created earlier, click on the Toucan Toco app and add it to your team image8

The app will be available in your app store in the future. You will be able to add it to other teams by going to the app store and go to the “Built for your org” category.

If you need more information on this step, see Microsoft documentation

Step 4: Test the integration

You can go to any story and you should see the “Annotate and share to Teams” button on the side panel. You can click on it to share this story in teams.

Please check this video for further information about the integration: