Discord Integration

Integrate BugBrain with Discord to get real-time test execution notifications in your server.

Features

  • Channel notifications — Post test results to Discord channels
  • Rich embeds — Formatted messages with test summary
  • Mentions — @mention teams on critical failures
  • Role-based routing — Different channels for different test types
  • Customizable format — Control what appears in notifications
  • Available on all plans

Setup

  1. Create Discord Webhook

    • Discord Server → Settings → Webhooks → New Webhook
    • Copy Webhook URL
  2. Add to BugBrain

    • Settings → Integrations → Discord
    • Paste Webhook URL
    • Configure notification rules
  3. Test Connection

    • Click “Send Test Message”
    • Verify message appears in Discord

Notification Types

Test Execution Completed

🟢 BugBrain Tests: PASSED
━━━━━━━━━━━━━━━━━━━━━━━━
Test Plan: Production Smoke Tests
Passed: 45/47
Failed: 2
Duration: 2m 15s

Test Failures Alert

🔴 BugBrain Tests: FAILED
━━━━━━━━━━━━━━━━━━━━━━━━
Test Plan: Full Regression Tests
Failed Tests: 5
Critical: 2, High: 3, Medium: 0

Failed Tests:
• Login flow - selector not found
• Checkout - timeout
• Payment processing - API error

Channel Routing

Configure which channels receive which notifications:

Test TypeChannelNotify
Smoke Tests#qa-testsAlways
Full Regression#qa-regressionFailures only
Security Tests#security-alertsAll
Production Tests@security-teamCritical only

Custom Messages

Configure message template:

{test_plan_name}
{passed_count}/{total_count} passed
{failed_count} failed
Duration: {duration}

View: {execution_url}

Mentions

Auto-mention on specific conditions:

  • Mention @qa-team on any failure
  • Mention @devops on critical failures
  • Mention @security on security test failures

Deduplication

  • Time window: 15 minutes
  • Match criteria: Same test result status
  • Action: Thread reply instead of new message

Integration with Other Tools

With Slack: Use Discord to notify dev team, Slack for QA team With Email: Discord immediate notification, email summary report

Message Customization

Use variables in custom format:

  • {test_plan_name} — Test plan title
  • {status} — PASSED/FAILED
  • {passed_count} — Number passed
  • {failed_count} — Number failed
  • {duration} — Execution time
  • {execution_url} — Link to execution report
  • {branch} — Git branch (if available)
  • {commit} — Git commit (if available)

Troubleshooting

  • Messages not sending — Verify webhook URL is correct
  • Wrong channel — Check webhook points to intended channel
  • Mentions not working — Ensure bot has permission to mention roles
  • Formatting broken — Test webhook URL with simple message first