# Slack Integration

Source: https://docs.qualflare.com/docs/integrations/slack · Last updated: 2026-11-06

Connect Qualflare to Slack to receive notifications about defects, milestones, failure clusters, and test results in your Slack channels.

The Slack integration posts a short message to a Slack channel when something happens in a project. Stay informed about new defects, failed test runs, failure clusters and completed milestones without leaving Slack.

## Setup

### Step 1: Install the Slack App

1. In the workspace sidebar, open **Integrations**. You need a workspace role of **Editor** or higher
2. Find **Slack** under **Notifications**
3. Click **Install**
4. You are redirected to Slack to authorize the Qualflare app
5. Select your Slack workspace, then click **Allow**
6. You are redirected back to Qualflare with the integration installed

### Step 2: Configure Per-Project Notifications

1. In Slack, add the Qualflare app to the channel you want to use. Qualflare can't post to a channel the app hasn't joined, and a private channel appears in the list only after you add the app
2. In Qualflare, open **Integrations** in the project sidebar. You need the **Editor** role or higher on the project
3. Click **Configure** on the Slack integration
4. Select the **Default Channel**
5. Under **Events**, select the events that should send a message
6. Click **Save**

*Figure: Each project sends the events you select to one Default Channel.*

## Notification Events

| Event               | Message Format                                                                        |
| ------------------- | ------------------------------------------------------------------------------------- |
| Defect Created      | `New defect created: #<number> <name> (Severity: <severity>)`                         |
| Defect Resolved     | `Defect resolved: #<number> <name>`                                                   |
| Launch Completed    | `Launch #<number> completed with status: <status> (Passed: <count>, Failed: <count>)` |
| Launch Failed       | `Launch #<number> failed with status: <status> (Failed: <failed>/<total>)`            |
| Cluster Created     | `Failure cluster detected: <cluster name> (<count> affected cases)`                   |
| Milestone Completed | `Milestone completed: <milestone name>`                                               |
| Flaky Test Detected | `Flaky test detected: <test case name> (<rate>% flaky rate)`                          |

Messages are plain text, with no links. Launch events come only from results uploaded with the CLI, a reporter or the API: **Launch Failed** when the upload includes a failed, error, timed-out or aborted test, and **Launch Completed** otherwise. In **Launch Completed** messages the counts currently always read `Passed: 0, Failed: 0`.

Each project posts every selected event to its one **Default Channel**, and a project can't split events across Slack channels. To send some events somewhere else, connect another chat integration, such as Microsoft Teams or Discord, and select those events there.

## Disconnecting

> **Caution:** Removing Slack deletes every project's Slack settings. To use Slack again, install it and set up each project from scratch.

To remove the Slack integration, open **Integrations** in the workspace sidebar, click the trash icon on the Slack card, then click **Remove**. Qualflare also revokes its access token at Slack.

## See Also

* [Integrations Overview](https://docs.qualflare.com/docs/integrations)
* [Project Settings](https://docs.qualflare.com/docs/administration/project-settings)
