Slack Integration

Connect AegisRunner to Slack to receive real-time notifications about test runs, crawl completions, and failures directly in your team's Slack workspace.

What You'll Get

✅

Test Results

Instant notifications when tests pass or fail

🔍

Crawl Updates

Know when crawls complete with page counts

⚠️

Failure Alerts

Immediate alerts for failed tests

📊

Summary Reports

Daily/weekly testing summaries

Setting Up Slack Integration

Create a Slack Webhook

Go to your Slack workspace settings and create an Incoming Webhook:

Visit api.slack.com/apps
Click Create New App → From scratch
Name it "AegisRunner" and select your workspace
Go to Incoming Webhooks and enable them
Click Add New Webhook to Workspace
Select the channel for notifications
Copy the Webhook URL

Add Webhook to AegisRunner

In AegisRunner:

Go to Settings → Integrations
Find the Slack section
Paste your Webhook URL
Click Save

Configure Notifications

Choose which events trigger Slack messages:

All test completions
Only failures
Scheduled run completions
Crawl completions

Test the Connection

Click Send Test Message to verify the integration works.

Notification Types

Test Run Completed

When a test run finishes, you'll receive a message like:

✅ Test Run Passed
Suite: Homepage Tests
Browser: Chromium
Results: 12 passed, 0 failed, 1 skipped
Duration: 45s
View Details →

Test Run Failed

❌ Test Run Failed
Suite: Checkout Flow Tests
Browser: Firefox
Results: 8 passed, 3 failed, 0 skipped
Duration: 1m 23s
Failed Tests:

Payment form validation
Order confirmation display
Receipt email check

View Details →

Crawl Completed

🔍 Crawl Completed
Project: Main Website
Pages Found: 47
Forms Detected: 12
Duration: 2m 15s
View Results →

Channel Configuration

You can set up multiple Slack channels for different notification types:

Channel	Recommended Notifications
`#testing-alerts`	All test failures (immediate attention needed)
`#testing-general`	All test completions (for visibility)
`#dev-team`	Daily/weekly summaries

Notification Settings

Customize what triggers Slack notifications:

Setting	Description	Default
On Test Pass	Notify when all tests pass	Off
On Test Fail	Notify when any test fails	On
On Crawl Complete	Notify when crawls finish	Off
On Schedule Complete	Notify when scheduled runs finish	On (failures only)
Include Details	Include failed test names in message	On
Daily Summary	Send daily testing summary	Off

Message Customization

Customize how messages appear:

Mention on Failure - @mention a user or @channel on failures
Custom Prefix - Add a prefix to messages (e.g., "[PROD]")
Include Screenshots - Attach failure screenshots (when available)

Troubleshooting

Messages not appearing in Slack

Verify the webhook URL is correct
Check that the Slack app is still installed in your workspace
Ensure the channel still exists
Test the webhook with "Send Test Message"
Check if the webhook has been revoked

Too many notifications

Configure notifications for failures only
Disable notifications for scheduled runs if they're frequent
Use a dedicated channel to avoid noise in main channels
Enable daily summaries instead of individual notifications

Webhook URL expired

Slack webhook URLs don't expire, but they can be revoked
Create a new webhook in your Slack app settings
Update the URL in AegisRunner settings

Best Practices

Slack Integration Tips:

Use failures-only notifications to reduce alert fatigue
Create a dedicated #testing-alerts channel
Set up @channel mentions for critical production test failures
Enable daily summaries for team visibility
Use different webhooks for different projects/environments
Include failed test names to quickly identify issues

Slack Integration

Slack Integration

What You'll Get

Setting Up Slack Integration

Notification Types

Test Run Completed

Test Run Failed

Crawl Completed

Channel Configuration

Notification Settings

Message Customization

Troubleshooting

Best Practices

Related Documentation

Need help?