1. Docs
  2. Integrations
  3. Alerts + Microsoft Teams

Send Alerts to Microsoft Teams

The Microsoft (MS) Teams + Honeycomb integration uses Honeycomb Triggers or Honeycomb Service Level Objective (SLO) Burn Alerts to notify Microsoft Teams based on alerts sent from Honeycomb.

Before You Begin 

Before you set up the integration, you’ll need a few things:

  • a user account in your team’s Microsoft Teams organization
  • a user account in your Honeycomb Team

Setting Up Your Integration 

Before you can configure Honeycomb to send alerts to Microsoft Teams, you must set up your integration.

Microsoft has retired Office 365 Connectors.

As of August 12, 2024, any existing O365 Connector-based Honeycomb integrations for your Honeycomb Team requires recreation as a new Microsoft Teams Workflow integration.

Create a Workflow for your Microsoft Teams Channel 

First, in Microsoft Teams, you must create a Workflow that posts to a channel when a webhook request is received.

To learn how to configure a Workflow in Microsoft Teams, visit Microsoft’s documentation.

Use the generated Workflow URL in the next step when adding your Microsoft Teams Workflow in Honeycomb.

For a private Microsoft Teams channel, a Workflow requires additional configuration after creation to properly receive alerts.

After creating a Workflow, navigate to and edit the target Workflow. Within the Workflow editor:

  1. Expand the step “Send each adaptive card”.
  2. Expand the action “Post your own adaptive card as the Flow bot to a channel”.
  3. Change the Post as field from “Flow bot” to “User”.
  4. Save the workflow.

Create Your Integration in Honeycomb 

Then, to create your integration, you must add your Microsoft Teams Workflow to Honeycomb.

  1. Navigate to Team Settings, and select the Integrations view.
  2. Locate the Trigger and SLO Recipients section.
  3. Select Add Integration.
  4. For Provider:
    1. Select MS Teams Workflow.
    2. Enter a name that will be easy to find when you configure alerts in the future.
    3. Paste the Workflow URL in the Incoming Webhook URL.
  5. Select Add.

Configuring Alerts to Use Microsoft Teams as a Recipient 

After your integration is set up in Honeycomb, you can configure Triggers and SLOs to use MS Teams Workflow as a recipient for alerts.

Configuring Triggers to Alert Microsoft Teams 

  1. In the Honeycomb UI, navigate to Triggers.
  2. Select the name of the trigger you want to configure, or create a new trigger by selecting New Trigger.
  3. Locate the Recipients section, and select Add Recipient.
  4. In the Add Trigger Recipient modal:
    1. Locate the Recipient dropdown.
    2. Choose your MS Teams Workflow integration.
    3. Select Add.
  5. Select Save Trigger.

Configuring SLO Burn Alerts to Alert Microsoft Teams 

  1. In the Honeycomb UI, navigate to SLOs.
  2. In the list, locate the SLO you want to configure, or create a new SLO by selecting New SLO.
  3. Find your SLO in the list, and select the Configure button in the Burn Alerts column.
  4. Select New Burn Alert.
  5. In the Create Burn Alert form:
    1. Set your desired exhaustion time
    2. Choose your MS Teams Workflow integration in the Notify dropdown.
    3. Set your desired Severity, as Critical is the default setting.
  6. Select Create Burn Alert.

Removing the Integration 

To remove the integration, you will need to delete it from your Honeycomb team. Deleting the integration from your team will remove it from all associated triggers and SLOs.

  1. Navigate to Team Settings, and select the Integrations view.
  2. Locate Trigger and SLO Recipients, find your MS Teams integration, and then select Edit.
  3. In the form editor, select Remove.
On this page: