Contact Support | System Status
Page Contents

    Installing the Connector for Teams

    This topic covers the installation and configuration of the Brightcove Video Connector for Microsoft 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 (soon-to-come) via the App Store.

    Prerequisites

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

    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: Releases · Oceanswave/brightcove-teams-connector (github.com) 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:
      More Options for Team
      More Options for Team
    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):
      Manage Team
      Manage Team
    5. Select the Apps tab:
      Team Apps Tab
      Team Apps Tab
    6. Click the Upload a custom app link at the bottom of the apps page:
      Upload Custom App Link
      Upload Custom App Link
    7. Navigate to the location of the Connector manifest (that you previously downloaded), select it, and click the Open button:
      Upload the Connector
      Upload the Connector
    8. Click Add on the Brightcove Video Connect modal window that is displayed:
      Add Brightcove Video Connect
      Add Brightcove Video Connect
    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:
      Available Team Apps
      Available Team Apps

    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:
      Add Tab Options for Team Channel
      Add Tab Options for Team Channel
    4. Select the Brightcove Video Connect app from the Add a tab modal window:
      Add a Tab Modal
      Add a Tab Modal
    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.
      Brightcove Account Information
      Brightcove Account Information

      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:

      Minimum API Permissions
      Minimum API Permissions
    7. In the configuration window, under Connector Tab Mode select the Brightcove Asset Manager from the dropdown options:
      Connector Tab Mode
      Connector Tab Mode
    8. Click Save:
      Save Brightcove Connector Configuration
      Save Brightcove Connector Configuration
    9. The Brightcove Asset Manager should now appear on your newly created tab as shown below:
      Video Connector Configured
      Video Connector Configured

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


    Page last updated on 05 Aug 2021