Skip to main content
Version: 1.12

Microsoft Teams

Botkube app for Microsoft Teams

The Botkube app for Microsoft Teams 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 app for Microsoft Teams 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 app for Microsoft Teams 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 app for Microsoft Teams 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 team

  1. Install Botkube app for Microsoft Teams from the official app catalog by clicking the Install Botkube App for Teams button.

    Install Botkube App for Microsoft Teams

    Alternatively, you can search for the "Botkube" app in the Microsoft Teams app catalog and click the Add button.

    Add Botkube App

  2. Add the Botkube app to your team.

    1. Click the Add to a team button.

      Add app to team

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

      Select a team

    3. 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 app for Microsoft Teams

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 app for Microsoft Teams 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 app for Microsoft Teams 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.