Skip to Content
User GuidesSlack Integration Guide

Slack Integration Guide

Get real-time feedback notifications directly in your Slack workspace. Available on STARTER and PRO plans.

⚡ Quick Setup (5 minutes)

  1. Go to Slack Apps  → Create App
  2. Enable “Incoming Webhooks” → Add webhook to channel
  3. Copy webhook URL
  4. In Miniback: Settings → Notifications → Paste URL → Save
  5. Click “Send Test” to verify

Requirements: STARTER or PRO plan • Slack admin access

Overview

The Slack integration sends automatic notifications to your chosen Slack channel whenever new feedback is submitted. Each notification includes:

  • Feedback message content
  • Submitter information (if provided)
  • Project name
  • Submission timestamp
  • Link to view in dashboard

Prerequisites

  • Plan Requirement: STARTER or PRO plan (upgrade here)
  • Slack Access: Admin permissions to your Slack workspace
  • Active Project: At least one active Miniback project

Step 1: Create a Slack Incoming Webhook

1.1 Access Slack App Directory

  1. Go to Slack Apps 
  2. Click “Create New App”
  3. Choose “From scratch”

1.2 Configure Incoming Webhooks

  1. Name your app (e.g., “Miniback Notifications”)
  2. Select your workspace
  3. Click “Create App”
  4. In the left sidebar, click “Incoming Webhooks”
  5. Toggle “Activate Incoming Webhooks” to ON

1.3 Generate Webhook URL

  1. Scroll down and click “Add New Webhook to Workspace”
  2. Select the channel where you want notifications
    • Recommended: Create a dedicated #feedback or #miniback channel
    • You can change this later in Slack settings
  3. Click “Allow”
  4. Copy the Webhook URL (looks like: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX)

Step 2: Configure Miniback

2.1 Navigate to Settings

  1. Sign in to your Miniback dashboard
  2. Go to Settings → Notifications
  3. Find the Slack Integration card

2.2 Add Webhook URL

  1. Paste your Slack webhook URL into the Webhook URL field
  2. Click “Save Settings”
  3. Enable the toggle switch to activate notifications

Step 3: Test the Integration

  1. Click the “Send Test” button in the Slack Integration card
  2. Check your Slack channel for the test message
  3. If successful, you’ll see: ✅ “Test notification sent to Slack!”

Troubleshooting Test Failures

If the test fails:

  • Invalid URL: Verify the webhook URL is complete and correct
  • Channel Deleted: Check that the target channel still exists
  • App Removed: Ensure the Slack app wasn’t uninstalled
  • Workspace Changed: Webhooks are workspace-specific

Understanding Notifications

Notification Format

🔔 New Feedback Received

Message: [Feedback content]
Project: [Project name]
Email: [user email] (if provided)
URL: [submission URL] (if provided)

View in Dashboard: [link]

When Notifications Are Sent

Notifications trigger when:

  • ✅ New feedback is submitted via widget
  • ✅ New feedback is submitted via API
  • ❌ Feedback status changes (not currently supported)
  • ❌ Feedback is deleted (not currently supported)

Best Practices

Channel Organization

Single Project:

  • Use a dedicated channel like #feedback or #product-feedback

Multiple Projects:

  • Create project-specific channels: #feedback-website, #feedback-app
  • Use Slack threads to organize discussions

Team Workflows:

  • Create channels by team: #engineering-feedback, #design-feedback
  • Use Slack’s workflow builder to auto-assign feedback

Managing Notification Volume

For high-traffic projects:

  1. Use Channel Muting:

    • Mute the channel but allow mentions
    • Check periodically rather than real-time

  2. Filter with Multiple Projects:

    • Create different Miniback projects for priority levels
    • High-priority feedback → active channel
    • Low-priority feedback → muted channel

  3. Batch Notifications (coming soon):

    • Daily/weekly digest options

Advanced Configuration

Multiple Slack Workspaces

Each Miniback account supports one Slack webhook. To send to multiple workspaces:

  1. Create separate Miniback projects per workspace
  2. Configure different webhooks for each project (not currently supported)
  3. Alternative: Use Zapier or webhook forwarding

Custom Notification Formatting (Coming Soon)

Future updates will include:

  • Custom message templates
  • Conditional formatting based on feedback content
  • Priority levels and tagging

Disabling Notifications

To temporarily disable Slack notifications:

  1. Go to Settings → Notifications
  2. Toggle OFF the Enable switch
  3. Your webhook URL is saved for when you re-enable

To permanently remove:

  1. Toggle OFF notifications
  2. Clear the webhook URL field
  3. Click “Save Settings”
  4. Optionally delete the Slack app from your workspace

Security Considerations

Webhook URL Security

  • ⚠️ Never expose webhook URLs publicly - they grant posting access to your Slack
  • ✅ Store securely - only admins should access
  • ✅ Regenerate if compromised (create new webhook in Slack)

Data Privacy

Slack notifications include:

  • Feedback message content
  • User email (if provided)
  • Submission URL

Ensure your team’s Slack permissions align with data sensitivity.

Troubleshooting

Notifications Not Appearing

Check 1: Integration Enabled

  • Verify the toggle is ON in Settings → Notifications
  • Webhook URL is saved

Check 2: Channel Exists

  • Original channel wasn’t deleted or archived
  • Slack app still has access

Check 3: Slack App Active

  • App wasn’t uninstalled from workspace
  • Permissions weren’t revoked

Check 4: Miniback Status

  • Project is ACTIVE (not paused)
  • Within plan limits (feedback quota)

Test Works But Real Feedback Doesn’t

  1. Submit test feedback via your widget

  2. Check dashboard - does feedback appear there?

    • If NO: Widget configuration issue (see Installation)
    • If YES: Slack integration issue

  3. Verify webhook - try test notification again

  4. Check Slack app logs in Slack App Settings 

Wrong Channel

To change the notification channel:

  1. Go to Slack Apps 
  2. Select your Miniback app
  3. Click “Incoming Webhooks”
  4. Delete the old webhook
  5. Add new webhook to desired channel
  6. Update webhook URL in Miniback Settings

Rate Limits

Slack imposes rate limits on webhooks:

  • Standard limit: 1 message per second
  • Burst limit: ~30 messages per minute

Miniback automatically handles these limits. High-volume projects may experience slight delays.

Migration from Other Services

From Email Notifications

Slack notifications complement email alerts - you can use both simultaneously:

  • Enable both in Settings → Notifications
  • Slack for real-time team awareness
  • Email for personal tracking and archives

From Zapier

If you’re currently using Zapier for Slack:

  1. Keep Zapier enabled during testing
  2. Test native Miniback Slack integration
  3. Disable Zapier once confirmed working
  4. Native integration is faster and more reliable

Plan Comparison

FeatureFREESTARTERPRO
Slack Integration❌✅✅
Webhook URL-1 per account1 per account
Notification Volume-Up to 5,000/monthUnlimited

Upgrade your plan to unlock Slack integration.

What’s Next?

FAQ

Q: Can I send to multiple channels? A: Currently one webhook per account. Create separate projects for different channels (workaround).

Q: Can I customize the notification format? A: Not yet - custom templates are on the roadmap.

Q: Will status changes trigger notifications? A: Not currently - only new feedback submissions. Feature coming soon.

Q: Is there a delay in notifications? A: Notifications are sent immediately (< 1 second typically).

Q: Can team members reply via Slack? A: Not directly - click the dashboard link to respond. Slack reply integration coming in V2.

Need more help? See Troubleshooting or contact support through your dashboard.

Last updated on
Project Management Guide Webhook Integration Guide