IntegrationsSlack

Slack Integration

Get instant notifications in Slack when your tests pass or fail. Perfect for keeping your team informed about testing status.

What You’ll Get

  • Test result notifications with pass/fail status
  • Rich formatting with test details, duration, and screenshots
  • Links back to BugBrain to view full execution details
  • Failure alerts with error messages and context

Prerequisites

Before you start, you’ll need:

  • Slack workspace with permission to add apps
  • Slack webhook URL (we’ll show you how to get one)
  • BugBrain project where you want to enable notifications

Getting a Slack Webhook URL

1
Go to Slack API
Visit https://api.slack.com/apps and click 'Create New App'.
2
Choose 'From Scratch'
Enter an app name like 'BugBrain Notifications' and select your workspace.
3
Enable Incoming Webhooks
In the app settings, click 'Incoming Webhooks' and toggle it on.
4
Add Webhook to Workspace
Click 'Add New Webhook to Workspace' and select the channel where you want notifications.
5
Copy the Webhook URL
Copy the webhook URL that starts with 'https://hooks.slack.com/services/...'. You'll need this for BugBrain.

Configuring BugBrain

1
Open Project Settings
In BugBrain, go to your project and click 'Settings' → 'Integrations'.
2
Click 'Add Integration'
Select 'Slack' from the list of available integrations.
3
Enter Webhook URL
Paste the Slack webhook URL you copied earlier.
4
Configure Notifications
Choose which events to notify about: test completed, test failed, discovery completed, etc.
5
Test the Integration
Click 'Test Integration' to send a test message to Slack. Check your channel to confirm it works.
6
Save Configuration
Click 'Save' to enable the integration.

Notification Events

You can choose which events trigger Slack notifications:

EventWhen It FiresRecommended
Test CompletedEvery test execution completesFor critical tests only
Test FailedA test execution fails✅ Recommended
Discovery CompletedA discovery session finishesOptional
Batch CompletedA test plan finishes running✅ Recommended

Tip: Start with just “Test Failed” notifications to avoid Slack spam. You can always enable more events later.

Notification Format

Slack notifications include:

🔴 Test Failed: User can login with valid credentials

Project: My Website
Duration: 15.3 seconds
Failed Step: Verify dashboard appears

Error: Element 'dashboard-heading' not found

View Details → [link to BugBrain]

Filtering Notifications

Configure filters to control which tests trigger notifications:

  • By Priority: Only notify for Critical or High priority tests
  • By Tag: Only notify for tests tagged with “smoke” or “critical”
  • By Status: Only notify on failures (not passes)

This prevents notification fatigue and keeps your Slack channel focused.

Multiple Channels

You can set up different Slack channels for different purposes:

  1. Add multiple integrations with different webhook URLs
  2. Use filters to route notifications:
    • Critical test failures → #engineering-alerts
    • All test results → #qa-results
    • Discovery completions → #test-automation

Troubleshooting

Not receiving notifications?

  • Check that the webhook URL is correct
  • Verify the Slack app has permission to post to the channel
  • Make sure the integration is enabled (check the toggle in Settings)
  • Test the integration using the “Test Integration” button

Receiving too many notifications?

  • Enable filters to reduce notification volume
  • Change event settings to only notify on failures
  • Consider using a dedicated Slack channel

Notifications are delayed?

  • Slack notifications are sent immediately after test completion
  • Check your Slack workspace’s notification settings
  • Verify there are no Slack API outages at status.slack.com

Best Practices

  1. Use dedicated channels - Create a #test-results channel instead of spamming #general
  2. Filter appropriately - Only send important failures, not every test
  3. Test before deploying - Use the “Test Integration” button to verify setup
  4. Monitor usage - Review notifications weekly to ensure they’re valuable

Next Steps

OverviewJira