Microsoft Teams integration setup and configuration

Mabl's Microsoft Teams integration allows you to send activity from your workspace, such as plan failures, insights, and comments, directly to your channel of choice.

Getting started - initial setup

This integration is based on Team's incoming webhook functionality, which allows apps like mabl to send updates directly to a channel. Because of this, you'll need to have enough permissions in Teams to add a webhook to your channel of choice or find someone (like an admin) to do so for you. Additionally, you'll also need to at least be an editor in mabl to do so. (Find information on types of users in mabl here.)

Before beginning, we recommend that you start from within Teams. You will need the connector's destination URL to save your integration from within mabl, as detailed in the second half of this guide.

Within Teams

  1. Go to the channel where you want to add the webhook and select ••• More options from the top navigation bar.

  2. Select Connectors from the dropdown menu.

  1. Search for Incoming Webhook and select Add.

  2. Select Configure, enter "mabl" as the name. We recommend downloading this image as the icon for easy identification. Open the link, right-click, and then select "Save Image As" to download.

  1. The dialog window presents a unique URL that maps to the channel. Copy and save the webhook URL, to send information to Microsoft Teams and select Done.

Within mabl

  1. Navigate to the mabl app, go to the Integrations tab of the Settings page.

  2. Find the Microsoft Teams integration card, and select Add

  1. In the field provided, add the URL you copied from step 6.

A sample configuration, one that will alert on plan failures, newly passing plans (that were previously failing), comments, visual changes, and broken links.

  1. Name your integration something you can easily identify it with, such as the name of the channel it's sending data to.

  2. Configure which data you'd like to send to your channel. Don't worry, you can always update this later to better suit your needs.

  1. Save. Your integration is now configured!


There are multiple different types of messages you can send to Teams. They are:

  • Plan Failing: includes plan started failing and back to passing insights
  • Application Broken: Includes insights around home page load failures and auto-login failures
  • Timing: Page load and test execution timing insights
  • Broken Links: Broken and fixed links
  • Auto Heal: mabl adaptations to tests
  • Visual Changes: Insights about visual differences found during test runs. Enable visual modeling on your plans to receive these insights
  • Javascript Errors: New and fixed javascript errors encountered during test runs
  • Integration Events: Insights around integration events with mabl, first successful deployment, and first plan execution

Note: If multiple plan labels are selected, then you will get a notification if a matching plan is tagged with any of the labels.