Microsoft Teams Integration Installation Guide – Beekeeper Help Center

If at any point you require assistance with the below steps, please reach out to Beekeeper Support.

Integration Summary

Beekeeper’s integration with Microsoft Teams currently supports the following use cases:

Share Messages from a Teams Channel to a Beekeeper Stream at the click of a button. Comments and reactions will also be shared between the platforms.
Send Beekeeper Form submissions directly to a Teams Channel.

Requirements

You need to have access to a user with Global Admin permissions in the Beekeeper tenant you are configuring the integration for.
You need to have an Admin User in Microsoft Teams.
You need to have the Teams Tenant ID of the Teams instance you want to integrate with Beekeeper.

You can follow the below steps to retrieve your Microsoft Teams tenant ID:

Navigate to one of your Teams inside the Microsoft Teams Application
Click on the … next to the Team name and click on Get link to team
Copy the link to the team and grab the tenant ID from the URL (the part after tenantId= in the URL):

Installation & Configuration in Microsoft Teams

Installing the Beekeeper Connector app on Microsoft Teams

In your Microsoft Teams application, click on Apps
In the search bar type in "Beekeeper" and click on the Beekeeper Connector app

You are able to connect multiple teams in Teams to one Beekeeper tenant. If you add the Beekeeper Connector app to multiple Teams, you can share announcements from any of those Teams to Beekeeper. If you would like to connect multiple teams, you need to repeat the configuration process for each team.
Click on the downward arrow next to Add and select Add to a team
Click into the search bar and select the channel for which you want to use the Beekeeper app
Click Set up a bot

Granting Admin consent to Beekeeper Connector app

This is required to enable transferring avatars from Teams to Beekeeper.

Navigate to Azure
Log in as your Teams Admin user
Click on Azure Active Directory in Azure Services
Click on Enterprise applications

Please note: Currently (probably only temporary) the Beekeeper connector can be found under “App registrations. In this case, click on App registrations.
In the search bar type "431da5c6-a52c-4a09-9344-0f095c21c58c" (the ID of the Beekeeper Connector app) and click on Beekeeper

In Enterprise applications:

In App registrations:

In addition, click on Try searching in Enterprise applications. The app should then be visible as follows:
Click on Permissions
Click on Grant admin consent for Beekeeper

The Teams installation is now complete. The next part shows how to configure the integration in your Beekeeper tenant.

Installation & Configuration in Beekeeper

In the Beekeeper Dashboard, navigate to Extensions > Marketplace
Type "Teams" in the search bar and click on the Microsoft Teams app
Click on Install
After the app has been installed, click on Configuration
In the configuration field, add your Microsoft Teams tenant ID as shown below:
```
{
   "externalTenantId": "Insert your Microsoft Teams tenant ID here"
}
```
Important: please ensure that the tenant ID is inserted within the quotation marks ("").
Click Validate & Save

If you see a green notification saying that the app has been configured, it means that the process was successful. Once you have configured the integration, you can do a test run. You can find the step-by-step instructions here.

Optional: Send Beekeeper Forms Submissions to Microsoft Teams

⚠️ Prerequisite: This functionality requires Form feature to be enabled for Beekeeper.

You can set up the integration to automatically send Beekeeper Forms submissions to a channel of your choice in Microsoft Teams. Form submissions are posted to Microsoft Teams anonymously.

Configuring this functionality is optional. You can have multiple forms connected to one Microsoft Teams tenant.

Create a form from the Beekeeper Dashboard. The exact instructions for creating forms are beyond the scope of this article. If you want to read the step-by-step instructions, you can click here.

There’s no limit to the number of questions you can put in the form. Just keep in mind that currently image & drawing question types are not supported by the integration (submitted answers will be shown as empty in Microsoft Teams).
Navigate to Extensions > Marketplace > Requested/Installed > Microsoft Teams > Configuration
Update Microsoft Teams's app configuration by adding the formsConfig section:
```
{
   "formsConfig": [
      {
         "channel": "Insert your Microsoft Teams Channel ID here",
         "formId": "Insert your Beekeeper Form ID here"
      }
   ],
   "externalTenantId": "Insert your Microsoft Teams tenant ID here"
}
```
- formId is the last part of your form's URL (e.g. https://your-company.beekeeper.io/dashboard/forms/dfcb0e6c-c48b-4a73-b5d7-9fe23a2c80b9, see screenshot below).
- channel is a Teams channel ID to which the questions will be posted. To retrieve it click on three dots next to the channel name you want to use and click Get link to channel.
  
  In the displayed URL, the channel ID is the part in between the channel/ and the next / (see screenshot below):
  
  Important: The channel ID has to be URL decoded before inserting into the Marketplace configuration. You can use https://www.urldecoder.org/ or any other tool of your choice to decode the channel ID.
  
  The completed configuration should look similar to the screenshot below:
Click on Validate & Save
Share the Beekeeper Form, for example in a post or in Shortcuts.

Please note: The Beekeeper form can only be connected with one channel. If you specify the mapping between one form ID and multiple channels, the submitted form will only appear in the first channel defined in the configuration and the rest of them will be ignored.

Marketplace