Skip to main content
Version: 1.7

Microsoft Teams

info

The previous Microsoft Teams integration has been deprecated. If you need to use the legacy Microsoft Teams integration, see the Botkube 1.5 Documentation. It is recommended to migrate to the new Microsoft Teams app per the below instructions.

Botkube Cloud Microsoft Teams App

The Botkube Cloud Microsoft Teams app offers several advanced features:

  • Simplified installation into your Microsoft Teams workspace
  • Multi-cluster executor support with a single Microsoft Teams app
  • Manage Teams channels directly from the Botkube web app and ensure the Botkube bot is invited to the correct channels

The Botkube Cloud Microsoft Teams app uses Botkube's cloud services to manage channels and route source events and executor commands. Currently, it requires a manual side-loading of the app, but we are working on getting it listed in Microsoft AppSource.

You can directly try Botkube Cloud Microsoft Teams app for free by creating an account in the Botkube Web App. Follow the steps below to install the app.

Prerequisites

  • A Botkube Cloud account.

    You can try out the Botkube Cloud Microsoft Teams app for free by creating an account in the Botkube Cloud app.

Create a Botkube Cloud Instance with Microsoft Teams

Connect Botkube Cloud to your Kubernetes cluster

  1. Go to Botkube Cloud Web App and click on New Instance button.

    New Instance

  2. Install Botkube Agent on your Kubernetes cluster by following the instructions on the page.

    Install Agent

  3. Click Add platform dropdown, and select Teams option.

    Teams Platform Select

Proceed with the next section.

Install Botkube app to your Microsoft Teams organization and add it to your team

  1. Download the Botkube Cloud Microsoft Teams app by clicking the Download Botkube App for Teams button.

    Download Teams App

  2. Sideload the Botkube app to your Microsoft Teams organization via Teams Admin Center, following the official documentation.

    info

    This step requires administrator permissions on your Microsoft Teams organization. Sideloading app is needed only once for the whole organization.

    Teams Admin Center

  3. Add the Botkube app to your team.

    1. In your Microsoft Teams application, navigate to the Apps tab.

    2. Select the Built for your organization tab.

    3. On the Botkube app card, click on the Add button.

      Add Botkube App

    4. Click the Add to a team button.

      Add app to team

    5. Select the team and default channel, where you'll get the welcome message.

      Select a team

    6. Click the Set up a bot button.

Once the Botkube app is added to your team, you'll receive a welcome message.

Botkube Cloud Microsoft Teams Welcome Message

Proceed with the next section.

Grant permissions for Botkube app

info

This step requires administrator permissions on your Microsoft Teams organization. Granting permissions is needed only once for the whole organization.

  1. Click on the Grant access button.

  2. Select your Microsoft account.

    Select account

  3. Click the Accept button.

    Grant access

  4. You will be redirected to the confirmation page.

    Confirmation page

Close the page and proceed with the next section.

Connect your team to Botkube Cloud

Go back to the Microsoft Teams app channel, where you received the welcome message.

  1. Click the Connect to Botkube Cloud button in the welcome message.

  2. Log in to Botkube Cloud, if you haven't already. Ensure that you selected the correct organization, where you want to connect your team.

  3. Click the Connect button.

    Connect to Botkube Cloud

  4. You will see a confirmation page.

    Confirmation page

Close the page and proceed with the next section.

Finalize Botkube Cloud instance configuration

Go back to the Botkube Cloud instance creation.

  1. In step 2, select your connected team and provide other details.

    • Connected Microsoft Teams team: Teams team that you connected in the previous section.
    • Display Name: Display name of the Microsoft Teams team configuration.
    • Channels: Teams channels where you can execute Botkube commands and receive notification.

    Botkube Cloud Instance Configuration

  2. Add plugins you want to enable in your Botkube instance and click Next button.

    Microsoft Teams Plugins

  3. Include optional default command aliases and actions and click Apply Changes button to update Botkube Cloud instance.

    Microsoft Teams Create

Using Botkube Cloud Microsoft Teams App

You can start using Botkube Cloud Microsoft Teams by typing @Botkube cloud help in one of the channels in the team you configured in one of the previous steps.

Botkube Cloud Microsoft Teams Command Help

Listing Cloud Instances

You can list all your Botkube Cloud instances by typing @Botkube cloud list in the Microsoft Teams channel, or click the button List connected instances in the help command response. Besides the instance name, ID, and status in the list response, you can also click the Get details button to go to instance details on Botkube Cloud Dashboard.

Botkube Cloud Microsoft Teams List Instances

Setting Default Instance

Once a Botkube command is executed, it will be handled on target Kubernetes cluster specified with --cluster-name flag. This is an optional flag, where if you have not specified it, Botkube Cloud will select the first instance. However, you can also achieve setting default instance with command @Botkube cloud set default-instance.

Cloud Microsoft Teams Set Default Instances

After this point, all of your commands will be executed on the default instance. Moreover, if you want to execute a command on all the target clusters, you can use --all-clusters flag.

Cloud Microsoft Teams All Clusters

Cleanup

  1. Go to Botkube Cloud instances page and click Manage button of the instance you want to remove.

    Cloud Teams Instance Manage

  2. Click Delete instance button, type instance name in the popup and click Delete instance.

    caution

    Remember to execute the displayed command to completely remove Botkube and related resources from your cluster.

    Cloud Teams Instance Delete

Caveats

RBAC ChannelName mapping

Same as other communication platforms, Botkube Cloud Microsoft Teams app supports RBAC along with all mappings. However, because of the Microsoft Teams API limitation, for the default team channel the ChannelName is always General, regardless of the actual localized channel name.

Limitations

Botkube Cloud Microsoft Teams App currently doesn't support the following features yet:

  • Processing states from selected dropdowns, e.g., used for the kubectl command builder. In a result, the command builder is not available.

  • Adding 👀 and ✅ reactions to messages indicating process status.

    This seems to be a limitation of the Microsoft Teams platform, however we'll investigate if there is a workaround.

  • Sending messages visible only to specific users.

  • Replacing messages with new content, e.g., used for pagination. Currently, a new card is sent as a new message.

  • User mentions in messages. Instead, Botkube app uses plaintext mentions with first and last name.