Microsoft Teams integration

Alerting on critical failures and testing insights in your workspace is critical to minimizing the impact of issues and regressions detected by your automated testing. To assist with this effort, mabl integrates with the tools your team uses to communicate and coordinate, including Microsoft Teams.

By configuring mabl to send notifications directly to a Teams channel of your choice, you can:

• Speed up the issue triage response time by setting alerts for critical failures
• Set filters to monitor mabl for the insights your team cares about the most, such as auto-heal, broken link, and visual change insights
• Keep up to date on comments in test output without having to log into the mabl app

This guide outlines how to set up and configure the Microsoft Teams integration.

Setup

To set up the Teams integration, add a webhook URL in the Teams channel where you want to receive notifications. The webhook URL is required for the Teams integration setup form in mabl.

📘

Setup privileges

The Microsoft Teams integration uses Team's incoming webhook functionality, which allows apps like mabl to send updates directly to a channel. For this reason, you need to have enough permissions in Teams to add a webhook to your channel of choice. If you do not have permissions to add a webhook, you can find someone on your team with the correct privileges.

In mabl, you must be a workspace editor or owner to configure the Teams integration.

In Teams

Go to the Teams channel where you want to add notifications from mabl and take the following steps:

1. Click on ••• (More options) from the top navigation bar.
2. Select Connectors from the dropdown menu.

3. Search for "Incoming Webhook" and select Add.
4. Select Configure.

5. Enter "mabl" as the name.
6. We recommend downloading this image as the icon for easy identification. Open the link, right-click, and then select "Save Image As" to download.
7. The dialog window presents a unique URL that maps to the channel. Copy the webhook URL. You will need this to set up the integration in mabl.

5. Select Done.

In mabl

In the mabl app, navigate to Settings > Integration to finish setting up the Teams integration:

1. Find the Microsoft Teams integration card and click on the + Setup button.

2. On the Teams setup form, enter the following required information:
   1. Name: Name your integration something that you can easily identify, such as the name of the channel that it's sending data to.
   2. Webhook URL: Paste in the webhook URL that you copied from the Teams webhook configuration.
3. Modify the Configuration options to suit your needs. For more details on configuration options, see the following section.
4. Click Save.

After saving, the integration appears in the Active integrations section of Settings > Integrations.

Configuration

Use the toggles and filters to configure the Teams integration to fit your needs.

The basics:

• Action buttons in cards: If this option is toggled on, you can trigger failed plans to re-run directly from Teams.

Plan notifications

• Plan run passed
• Plan run failed: This option includes a note on the first error encountered during the plan run, who was the last user to modify the test, and when the test was updated.
• Plan run started
• Plan run status changed: This option sends notifications if a plan run passes after a previous failing run, or if a plan run fails after a previous passing run. If the status changes to failing, the notification includes details on the last user to modify the test and when the test was updated.

Other notifications

Configuration notifications for other types of insights:

• Comments: Comments added to the Test Output page.
• Application broken: Includes insights around home page load failures and auto-login failures.
• Timing: Page load and test execution timing insights.
• Broken links: URL for broken and fixed links
• Auto-heal: Mabl adaptations to find page elements in browser tests
• Visual changes: Insights about visual differences found during test runs. Enable visual change learning 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, such as new OAuth(Slack) integration added, first successful deployment, and first plan execution

Only notify for

Insight statuses
Place a filter on the notifications configured in the "Plan notifications" and "Other notifications" sections to surface specific types of insights.

For example, if you want to receive notifications only when a scheduled plan's status changes from passing to failing, toggle on Plan run status changed and set the Insight filter to "Alert." This configuration filters out Plan run passing insights and only notifies you when there is a Plan run failing insight.

If you want to know when a test has JavaScript errors, but you don't want to know the JavaScript errors are fixed, toggle on JavaScript errors and set the Insight filter to "Warning." This configuration filters out JavaScript fixed insights and only notifies you when there is a JavaScript broken insight.

Plan labels

Use the plan labels filter to receive notifications only for plans that have certain labels. When multiple labels are selected, you get a notification if a matching plan is tagged with any of the labels.