Skip to main content

Slack Integration

Get notified in Slack when test runs complete, tests fail, or on a daily schedule. Keep your team informed without checking the ProvaLab.io dashboard.

What You Can Do

  • Test run notifications -- Get a message when a test run completes with pass/fail summary
  • Failure alerts -- Get immediate alerts when critical tests fail
  • Daily summaries -- Receive a daily digest of test activity
  • Custom channels -- Route different notifications to different Slack channels

Set Up Slack Notifications

Step 1: Create a Slack Incoming Webhook

  1. Go to https://api.slack.com/apps
  2. Click Create New App > From scratch
  3. Name it "ProvaLab.io Notifications" and select your workspace
  4. Go to Incoming Webhooks and toggle Activate Incoming Webhooks on
  5. Click Add New Webhook to Workspace
  6. Select the channel where you want notifications (e.g., #qa-alerts)
  7. Click Allow
  8. Copy the Webhook URL (it looks like https://hooks.slack.com/services/T00.../B00.../xxx...)

Step 2: Add the Webhook to ProvaLab.io

  1. In ProvaLab.io, go to Settings > Integrations > Slack
  2. Click Add Webhook
  3. Paste your Slack webhook URL
  4. Give it a name (e.g., "QA Alerts Channel")
  5. Click Save

Step 3: Configure Notification Events

Choose which events trigger Slack notifications:

EventDescriptionRecommended
Test run completedSent when any test run finishesYes
Test run failedSent when a test run has failuresYes
All tests passedSent when a test run passes 100%Optional
Daily summarySent daily at a configured timeYes
New critical failureSent when a critical-priority test failsYes
Test plan completedSent when all runs in a plan finishOptional

For each event, you can filter by:

  • Project -- Only notify for specific projects
  • Environment -- Only notify for production, staging, etc.
  • Test plan -- Only notify for specific test plans

Notification Examples

Test Run Completed

ProvaLab.io Test Run Completed

Run: Playwright: 2026-02-20 14:30:00
Project: E-Commerce Platform
Environment: staging

Results:
Total: 47
Passed: 44 (93.6%)
Failed: 2
Skipped: 1

Failed tests:
- [TC-103] Login with expired credentials
- [TC-245] Checkout with expired card

View in ProvaLab.io: https://tms.yourcompany.com/org/1/projects/12/runs/847

Critical Failure Alert

ALERT: Critical Test Failed

Test: [TC-101] User login with valid credentials
Run: Nightly Regression #847
Project: E-Commerce Platform
Environment: production

Error: Expected status 200, got 503

View: https://tms.yourcompany.com/org/1/projects/12/runs/847/results/3021

Daily Summary

ProvaLab.io Daily Summary - February 20, 2026

E-Commerce Platform:
Runs today: 5
Total tests: 235
Pass rate: 96.2%
New failures: 3

Mobile App:
Runs today: 3
Total tests: 128
Pass rate: 100%
New failures: 0

View dashboard: https://tms.yourcompany.com/org/1/dashboard

Multiple Channels

You can set up different webhooks for different channels:

ChannelEvents
#qa-alertsAll failure alerts, critical failures
#dev-teamTest run completed (production only)
#qa-dailyDaily summary
#release-channelTest plan completed

Add multiple webhooks

  1. Go to Settings > Integrations > Slack
  2. Click Add Webhook for each channel
  3. Configure events independently for each webhook

Customize Message Format

Minimal format

Show only the essentials:

[PASS] Nightly Regression #847 - 47/47 passed

Detailed format (default)

Shows full breakdown with failed test names and links.

Custom format

Use the message template editor in Settings > Integrations > Slack > Message Format to customize what appears in notifications. Available variables:

VariableDescription
{run_name}Test run name
{run_id}Test run ID
{project_name}Project name
{environment}Environment
{total}Total tests
{passed}Passed count
{failed}Failed count
{skipped}Skipped count
{pass_rate}Pass rate percentage
{failed_tests}List of failed test names
{run_url}Link to test run in ProvaLab.io
{duration}Total run duration

Disable Notifications

Temporarily mute

  1. Go to Settings > Integrations > Slack
  2. Click Mute on a webhook
  3. Choose duration: 1 hour, 4 hours, 24 hours, or until you unmute

Remove a webhook

  1. Go to Settings > Integrations > Slack
  2. Click the trash icon next to the webhook
  3. Confirm deletion

Verify It Works

  1. Create a Slack incoming webhook for a test channel
  2. Add the webhook in Settings > Integrations > Slack
  3. Enable "Test run completed" notifications
  4. Run a test suite with ProvaLab.io integration enabled
  5. Check your Slack channel for the notification
Test your webhook

After adding a webhook, click the Send Test Message button to verify the connection works before running a real test suite.

Common issues
  • No notifications: Verify the webhook URL is correct and the Slack app is still installed in your workspace
  • Wrong channel: Each webhook is tied to a specific Slack channel. Create a new webhook if you need to change the channel
  • Too many notifications: Use event filters to limit notifications to specific projects or environments