Slack Integration

QA Sphere integrates natively with Slack to keep your team informed without leaving their conversations. Once connected, QA Sphere can:

• Post channel notifications when test runs, test plans, milestones, and test results change
• Respond to slash commands (/qasphere) for managing subscriptions directly from Slack
• Expand QA Sphere links pasted in Slack into rich preview cards

Connecting Your Slack Workspace

1. Navigate to Settings > Integrations and click Connect on the Slack Workspace row (alternatively, click Create and select Slack).

2. A Slack authorization window opens. If you are not signed in to Slack in your browser, Slack will first ask you to sign in to your workspace.

3. Review the requested permissions, make sure the correct workspace is selected in the workspace picker, and click Allow.

4. The window closes automatically and QA Sphere confirms with a "Slack connected successfully." message. The Slack Workspace row now shows a Connected badge along with your workspace name.

Linking Your Slack Account

Individual users link their Slack identity to their QA Sphere account. Linking is required to subscribe channels to projects and to see link previews for QA Sphere URLs.

• The user who connects the workspace is linked automatically.
• Everyone else can run /qasphere link in any channel or DM with the QA Sphere app. The bot replies with a personal link that opens QA Sphere, where you confirm the connection. The link expires after 15 minutes.

A Slack account can be linked to only one QA Sphere account.

Subscribing a Channel to a Project

In the Slack channel that should receive notifications, run:

/qasphere subscribe project <CODE> events all

Replace <CODE> with your QA Sphere project code (for example, BD). The bot joins the channel automatically and confirms the subscription.

You can subscribe a channel to multiple projects, and a project to multiple channels. Subscribing requires access to the project in QA Sphere — Owners and Admins can subscribe to any project, while other roles need to be members of it.

Slash Commands

Event Categories

Subscriptions are configured per event category:

Notifications

Once subscribed, the QA Sphere bot posts a message to the channel whenever a matching event occurs. Each notification links back to the entity in QA Sphere and includes key details such as the project code, state, and the user who performed the action.

Link Previews

When a linked user pastes a QA Sphere URL — a test run or a test case — into Slack, the bot expands it into a preview card with the entity's key details and an Open in QA Sphere link.

Previews are shown only for links to your own QA Sphere workspace, and only when the user who posted the link has access to the project.

Managing the Integration

On Settings > Integrations, the connected Slack Workspace row offers:

• Reconnect — re-runs the Slack authorization. Useful if the connection stops working or permissions change. Disconnecting first is not required.
• Disconnect — stops all notifications and disables the app in your workspace. Channel subscriptions are kept, so reconnecting later restores notifications without re-subscribing each channel.

Uninstalling the QA Sphere app from within Slack also disables the integration.

All connection, account linking, and subscription changes are recorded in the QA Sphere audit log (Settings > Audit Log).