Installing the Connector for Teams

Introduction

The Brightcove Video Connector for Microsoft Teams (Video Connector) can be installed one of two ways: Manually, as a Teams custom app, or via Microsoft AppSource.

Prerequisites

• Microsoft Teams
• Owner permissions on the Teams location you are installing the Video Connector to

Install from Microsoft AppSource

To install the Video Connector from Microsoft AppSource, follow the steps below.

1. Open https://appsource.microsoft.com/ in your browser.
2. Search for Brightcove Video Connect:

   

3. Click on the app to display the app details:

   

4. Click on the Add to a team button:

   

5. Search for the team you want to add the app to and select it:

   

6. Note that by default the app is add to the team's General channel - later you will be able to create a new channel and add the app to it also if you wish to:

   

7. Click the Set up a tab button:

   

8. In the modal dialog that opens, select the Brightcove account you want to connect to the team:

   

9. Next, select the tab mode you want to use for the connector:

   

10. Click Save, and you will be taken to the Asset Manager:

    

Manual (Custom App) installation

To install the Video Connector manually (Custom App install in Teams), follow the steps below.

1. Download the latest release of the Video Connector manifest package from the GitHub repository here: Microsoft AppSource and save it to your local computer.
2. Open Microsoft Teams, and open the Team where you want to install the connector.
3. Select the More Options menu:

   

4. Click the “Manage Team” menu item (note: you must have Owner permissions on this Teams location to see the menu item mentioned – see pre-requisites section above):

   

5. Select the Apps tab:

   

6. Click the Upload a custom app link at the bottom of the apps page:

   

7. Navigate to the location of the Connector manifest (that you previously downloaded), select it, and click the Open button:

   

8. Click Add on the Brightcove Video Connect modal window that is displayed:

   

9. The Video Connector app should be installed, and you should now see it in the list of available apps for the Team as shown below:

   

We will cover the configuration of the connector in a later section, and using it in Using the Connector for Microsoft Teams

Install from Microsoft App Store

This capability is currently being provisioned and the documentation will be updated once in place.

Add Brightcove Media Asset Manager to Teams

You must first install the Video Connector to the Team you want to add the media manager to. Follow the install guide as outlined in previous sections of the documentation if you have not already done so.

Now we will proceed with the configuration.

1. In Microsoft Teams, open the Team that already has the video connector app installed.
2. Open the Team Channel you want to install the media manager to.
3. Click the Add Tab menu option:

   

4. Select the Brightcove Video Connect app from the Add a tab modal window:

   

5. In the Configuration modal window, under Brightcove Account click New to add an account to the connector (or select one from the drop-down if you have previously used the connector on another Team on this Teams environment before).
6. If adding a new Brightcove Account (if you clicked New in the previous step) fill out the form with your Brightcove Account ID, API Access Key Id (Client ID) and API Secret Access Key (Client Secret) as shown. Click Save Account and Continue.

   

   For information on how to get client credentials, see Authentication for API Requests. The credentials need at least these permissions for the CMS, Dynamic Ingest, and Ingest Profiles APIs:

   

7. In the configuration window, under Connector Tab Mode select the Brightcove Asset Manager from the dropdown options:

   

8. Click Save:

   

9. The Brightcove Asset Manager should now appear on your newly created tab as shown below:

   

The Brightcove Video Connector is now installed and configured. To use the connector to manage media assets, see Using the Connector for Microsoft Teams.