Microsoft Teams connector installation guide
We provide a connector to integrate your chatbot with Microsoft Teams.
You must have administrator access to your Microsoft Azure cloud or, at least, the rights to create an Azure "Bot services" resource.
You must have the Administrator or Technical Manager role in your chatbot's management back-office.
In order to make the documentation easier to read, we voluntarily display the sensitive data of the Microsoft Teams application in clear text. These data are not exploitable. Please make sure to keep and secure access to this data in accordance with your organization's security policy.
Authenticate to your Microsoft Azure cloud with your credentials; then search for "Azure bot"; then click on the "Azure bot" link.
- Fill in the resource creation form respecting the constraints of the form and your organization.
- Enter the name of your chatbot (bot descriptor).
- Select your subscription and your resource group.
- Select the Standard price level in order not to be limited in the number of messages exchanged.
- Leave the creation of the application ID and password activated.
- Click on the "Verify + create" button at the bottom of the form and validate the creation.
Once the operation is done, you are redirected to the deployment screen. Once it is completed, click on "Access the resource".
Once the resource screen is visible, click on "Configuration" in the side menu.
Once on the configuration screen, enter the following email endpoint: https://lespetitsbots.com/api/microsoft-teams/talk
Remind to copy the Microsoft App ID somewhere, you will be asked for it in the next steps.
Once you have created your resource, click on the "Channels" tab in the side menu.
Then click on the Microsoft Teams button to activate the channel.
Validate the default configuration by clicking on the "Save" button then accept the terms of use.
We now need to recover the secret key previously created (automatically).
Keep the tab open, and open the Azure portal again. Type in the search bar "Key vault" and click on the corresponding service.
Once on this screen, select the previously created key safe and click on the "Secrets" tab in the side menu.
It is likely that you do not have the rights to view the various secrets, so we will now create an access policy.
Go to "Access Policies" in the side menu, then click on the "Add Access Policy" button.
Once on the creation screen, select the "Key and secret management" template, then select your own account as the principal. This procedure allows you to get the rights to list, modify, etc. the various secrets in the vault.
Finally, click on the "Add" button.
Now go to "Secrets", you should now be able to see the different secrets of the vault.
Click on the one previously created and then on its "Current version" (there should be only one version).
Finally, copy its value by clicking on the button at the bottom right of the secret screen.
You now have two keys at your disposal, the first one corresponds to the ID of the Microsoft application, the second to its secret. We are now going to add these values in the chatbot administration back-office.
Go to the chatbot back-office connectors page. Log in with your login and password if necessary.
Once on the "Settings" page, click on the "Connectors" button in the left menu, then click on the "Microsoft Teams" tab.
Go to Access Connector Settings
Click on the activation button of the Microsoft Teams application, enter your "App ID" previously noted, then click on the "Save" button, perform the same operation with the "App Key" data (secret).
You have now finished configuring the connector. If you want, you can customize it directly from the retained tab on the Azure portal or go to Microsoft Teams to make sure it works properly.
To use the chatbot, connect to your Microsoft Teams account and click on the "Conversations" tab. Click on the button to create a new conversation and in the search engine, enter the name of your chatbot, you can now chat with it!
If you wish, you can customize your chatbot in white-label. In this case, go to the "Azure bot" resource that you created in the second step. In the side menu, go to the "Bot profile" tab.
From this screen you can:
Modify the chatbot's name
Add a description to the chatbot
Add a custom icon to the chatbot
To go back to the home page: click here
Prerequisites for the installation
You must have administrator access to your Microsoft Azure cloud or, at least, the rights to create an Azure "Bot services" resource.
You must have the Administrator or Technical Manager role in your chatbot's management back-office.
Installation
In order to make the documentation easier to read, we voluntarily display the sensitive data of the Microsoft Teams application in clear text. These data are not exploitable. Please make sure to keep and secure access to this data in accordance with your organization's security policy.
1. Access the resource creation page on Microsoft Azure
Authenticate to your Microsoft Azure cloud with your credentials; then search for "Azure bot"; then click on the "Azure bot" link.
2. Creation of the Azure Bot
- Fill in the resource creation form respecting the constraints of the form and your organization.
- Enter the name of your chatbot (bot descriptor).
- Select your subscription and your resource group.
- Select the Standard price level in order not to be limited in the number of messages exchanged.
- Leave the creation of the application ID and password activated.
- Click on the "Verify + create" button at the bottom of the form and validate the creation.
Once the operation is done, you are redirected to the deployment screen. Once it is completed, click on "Access the resource".
3. Resource configuration
Once the resource screen is visible, click on "Configuration" in the side menu.
Once on the configuration screen, enter the following email endpoint: https://lespetitsbots.com/api/microsoft-teams/talk
Remind to copy the Microsoft App ID somewhere, you will be asked for it in the next steps.
4. Activating the Microsoft Teams channel
Once you have created your resource, click on the "Channels" tab in the side menu.
Then click on the Microsoft Teams button to activate the channel.
Validate the default configuration by clicking on the "Save" button then accept the terms of use.
5. Recovering the secret
We now need to recover the secret key previously created (automatically).
Keep the tab open, and open the Azure portal again. Type in the search bar "Key vault" and click on the corresponding service.
Once on this screen, select the previously created key safe and click on the "Secrets" tab in the side menu.
It is likely that you do not have the rights to view the various secrets, so we will now create an access policy.
Go to "Access Policies" in the side menu, then click on the "Add Access Policy" button.
Once on the creation screen, select the "Key and secret management" template, then select your own account as the principal. This procedure allows you to get the rights to list, modify, etc. the various secrets in the vault.
Finally, click on the "Add" button.
Now go to "Secrets", you should now be able to see the different secrets of the vault.
Click on the one previously created and then on its "Current version" (there should be only one version).
Finally, copy its value by clicking on the button at the bottom right of the secret screen.
You now have two keys at your disposal, the first one corresponds to the ID of the Microsoft application, the second to its secret. We are now going to add these values in the chatbot administration back-office.
6. Chatbot configuration (back-office)
Go to the chatbot back-office connectors page. Log in with your login and password if necessary.
Once on the "Settings" page, click on the "Connectors" button in the left menu, then click on the "Microsoft Teams" tab.
Go to Access Connector Settings
Click on the activation button of the Microsoft Teams application, enter your "App ID" previously noted, then click on the "Save" button, perform the same operation with the "App Key" data (secret).
You have now finished configuring the connector. If you want, you can customize it directly from the retained tab on the Azure portal or go to Microsoft Teams to make sure it works properly.
7. Using the chatbot
To use the chatbot, connect to your Microsoft Teams account and click on the "Conversations" tab. Click on the button to create a new conversation and in the search engine, enter the name of your chatbot, you can now chat with it!
Optional: white-label customization
If you wish, you can customize your chatbot in white-label. In this case, go to the "Azure bot" resource that you created in the second step. In the side menu, go to the "Bot profile" tab.
From this screen you can:
Modify the chatbot's name
Add a description to the chatbot
Add a custom icon to the chatbot
To go back to the home page: click here
Updated on: 23/02/2022
Thank you!