Notification Channels

Configure how and where you receive alert notifications when feedback thresholds are exceeded.

Implementation Status

Currently, only email notifications are fully implemented and functional. Slack and webhook notifications can be configured in the UI but are not yet implemented in the backend. They will be available in future releases.

Available Channels

Email Notifications

Availability: All plans
Setup Difficulty: Easy

Email notifications are the simplest way to receive alerts. They're included in all plans and require minimal setup.

Configuration

Default Behavior: Uses the project owner's email address
Custom Recipients: Add specific email addresses for team notifications
Multiple Recipients: Add as many email addresses as needed

Email Content

Subject: "Alert: [Alert Name] - [Project Name]"
Body Includes:
- Alert summary with threshold details
- Representative feedback text from the cluster
- Sample feedback items that triggered the alert
- Direct link to view the cluster in your dashboard
- Timestamp and project information

Setup Steps

Select "Email" in notification channels
Leave recipients empty to use project owner email, or
Add specific email addresses by typing and pressing Enter
Save the alert configuration

Example Email

Subject: Alert: The app crashes when I try to upload large files (7 occurrences)

Feedback Alert Triggered

Configuration: Critical Bug Reports
Issue: The app crashes when I try to upload large files
Category: Bug
Occurrences: 7 in the last 24 hours
Threshold: 5
Triggered: 2024-01-15T14:30:00Z

Recent Feedback Samples:
• App crashes on file upload (Type: bug, Time: 2024-01-15 12:30:00)
• Cannot upload images, app freezes (Type: bug, Time: 2024-01-15 10:30:00)
• File upload feature is broken (Type: bug, Time: 2024-01-15 08:30:00)

Slack Notifications

Availability: Paid plans only
Setup Difficulty: Moderate
Status: ⚠️ Not yet implemented - Configuration available but notifications are not sent

Slack notifications will provide real-time alerts directly in your team's communication channel when fully implemented.

Prerequisites

Paid Bugwise plan
Slack workspace admin access (to create webhooks)
Target Slack channel

Setup Steps

Create Slack App
- Go to api.slack.com/apps
- Click "Create New App"
- Choose "From scratch"
- Name your app (e.g., "Bugwise Alerts")
- Select your workspace
Enable Incoming Webhooks
- In your app settings, go to "Incoming Webhooks"
- Toggle "Activate Incoming Webhooks" to On
- Click "Add New Webhook to Workspace"
- Select the target channel (e.g., #alerts)
- Click "Allow"
Copy Webhook URL
- Copy the webhook URL (starts with https://hooks.slack.com/services/...)
Configure in Bugwise
- Select "Slack" in notification channels
- Paste the webhook URL
- Enter the channel name (e.g., "#alerts")
- Save the alert configuration

Slack Message Format

🚨 Alert Triggered: Critical Bug Reports

Project: MyApp Project
Threshold: 5 in 24h | Current: 7 items
Time: Today at 2:30 PM

Representative Feedback:
"The app crashes when I try to upload large files"

Category: Bug
View Details: https://app.bugwise.com/projects/...

Troubleshooting Slack

Webhook URL Invalid: Ensure you copied the complete URL
Messages Not Appearing: Check channel permissions and webhook status
App Permissions: Verify the Slack app has permission to post to the channel

Webhook Notifications

Availability: Paid plans only
Setup Difficulty: Advanced
Status: ⚠️ Not yet implemented - Configuration available but notifications are not sent

Webhooks will allow you to integrate alerts with custom systems, third-party tools, or automated workflows when fully implemented.

Use Cases

Integration with incident management systems (PagerDuty, Opsgenie)
Custom notification systems
Automated ticket creation (Jira, Linear)
Data pipeline triggers
Custom analytics and reporting

Configuration

Webhook URL: Your endpoint that will receive POST requests
Headers: Optional HTTP headers (e.g., Authorization, API keys)
Timeout: 30 seconds maximum response time

Setup Steps

Prepare Your Endpoint
- Create an HTTP endpoint that accepts POST requests
- Ensure it can handle JSON payloads
- Implement proper error handling
- Return HTTP 200 for successful processing
Configure in Bugwise
- Select "Webhook" in notification channels
- Enter your webhook URL
- Add any required headers (e.g., Authorization: Bearer your-token)
- Save the alert configuration

Webhook Payload

Your endpoint will receive a POST request with this JSON payload:

json

{
  "alert_id": "123e4567-e89b-12d3-a456-426614174000",
  "cluster_id": "123e4567-e89b-12d3-a456-426614174001",
  "project_id": "123e4567-e89b-12d3-a456-426614174002",
  "alert_type": "threshold_exceeded",
  "representative_text": "The app crashes when I try to upload files",
  "category": "Bug",
  "current_count": 7,
  "threshold_value": 5,
  "time_window_hours": 24,
  "triggered_at": "2024-01-15T14:30:00Z",
  "channels": ["email", "webhook"],
  "feedback_samples": [
    {
      "id": "feedback-id-1",
      "content": "App crashes on file upload",
      "type": "bug",
      "category": "Bug",
      "created_at": "2024-01-15T12:30:00Z"
    },
    {
      "id": "feedback-id-2",
      "content": "Cannot upload images, app freezes",
      "type": "bug",
      "category": "Bug",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

Example Webhook Handler (Node.js)

javascript

app.post('/bugwise-alerts', (req, res) => {
  const alert = req.body;
  
  console.log(`Alert triggered: ${alert.representative_text}`);
  console.log(`Count: ${alert.current_count}/${alert.threshold_value}`);
  
  // Process the alert (create ticket, send notification, etc.)
  processAlert(alert);
  
  // Always respond with 200 to acknowledge receipt
  res.status(200).json({ received: true });
});

Webhook Security

HTTPS Only: Webhooks are only sent to HTTPS endpoints
Headers: Use Authorization headers for authentication
Validation: Validate the payload structure in your handler
Idempotency: Handle duplicate webhooks gracefully

Troubleshooting Webhooks

Endpoint Not Receiving: Check URL and ensure it's publicly accessible
Timeout Errors: Ensure your endpoint responds within 30 seconds
Authentication Issues: Verify headers are configured correctly
SSL Errors: Ensure your endpoint has a valid SSL certificate

Multiple Channels

You can configure multiple notification channels for a single alert:

Benefits

Redundancy: Ensure notifications are received even if one channel fails
Different Audiences: Send emails to managers, Slack to developers
Escalation: Use webhooks for automated responses, email for human review

Example Configuration

Channels: ✅ Email ✅ Slack ✅ Webhook
Email Recipients: [email protected], [email protected]
Slack Channel: #critical-alerts
Webhook URL: https://api.company.com/alerts

Channel Comparison

Feature	Email	Slack	Webhook
Availability	All plans	Paid only	Paid only
Implementation Status	✅ Fully implemented	⚠️ Not implemented	⚠️ Not implemented
Setup Difficulty	Easy	Moderate	Advanced
Real-time	No	Yes (when implemented)	Yes (when implemented)
Rich Formatting	Limited	Yes (when implemented)	Custom (when implemented)
Integration	Manual	Manual	Automated
Cost	Free	Included	Included

Best Practices

Email

Use team distribution lists for broader coverage
Set up email filters to organize alerts
Include key stakeholders but avoid spam

Slack

Create dedicated alert channels
Use thread replies for discussions
Set up channel notifications appropriately

Webhook

Implement proper error handling and retries
Log webhook calls for debugging
Use idempotent processing to handle duplicates
Secure your endpoints with authentication

General

Test all channels before going live
Monitor notification delivery and adjust as needed
Use multiple channels for critical alerts
Review and update configurations regularly

Plan Limitations

Free Plan

✅ Email notifications
❌ Slack notifications
❌ Webhook notifications
✅ Multiple email recipients

Paid Plans

✅ All notification channels
✅ Unlimited configurations
✅ Advanced filtering options
✅ Priority support

Need help setting up notifications? Contact our support team or check the troubleshooting guide.

Notification Channels ​

Available Channels ​

Email Notifications ​

Configuration ​

Email Content ​

Setup Steps ​

Example Email ​

Slack Notifications ​

Prerequisites ​

Setup Steps ​

Slack Message Format ​

Troubleshooting Slack ​

Webhook Notifications ​

Use Cases ​

Configuration ​

Setup Steps ​

Webhook Payload ​

Example Webhook Handler (Node.js) ​

Webhook Security ​

Troubleshooting Webhooks ​

Multiple Channels ​

Benefits ​

Example Configuration ​

Channel Comparison ​

Best Practices ​

Email ​

Slack ​

Webhook ​

General ​

Plan Limitations ​

Free Plan ​

Paid Plans ​

Notification Channels

Available Channels

Email Notifications

Configuration

Email Content

Setup Steps

Example Email

Slack Notifications

Prerequisites

Setup Steps

Slack Message Format

Troubleshooting Slack

Webhook Notifications

Use Cases

Configuration

Setup Steps

Webhook Payload

Example Webhook Handler (Node.js)

Webhook Security

Troubleshooting Webhooks

Multiple Channels

Benefits

Example Configuration

Channel Comparison

Best Practices

Email

Slack

Webhook

General

Plan Limitations

Free Plan

Paid Plans