Slack Integration - Proliferate

Overview

The Slack integration sends real-time error alerts directly to your team’s Slack channels. Stay informed about critical issues without constantly monitoring your dashboard. With Slack connected, you can:

Receive notifications when new errors occur
Get alerts for error spikes or critical issues
Configure which channel receives notifications
Customize notification thresholds and filters
Enable workspace-wide search and indexing of Slack messages

The Slack integration uses OAuth 2.0 to securely connect your workspace. Access tokens are encrypted and stored securely.

What You Get

Real-Time Alerts

Instant notifications when errors occur in your applications

Rich Error Details

See error type, message, affected users, and a link to the full detail page

Channel Selection

Choose which channel receives notifications

Workspace Search

Enable indexing of Slack messages for workspace-wide search

Setup Process

Navigate to Integrations

Go to Settings → Integrations in your Proliferate dashboard.

Install Slack App

Click Install on the Slack integration card. You’ll be redirected to Slack for authorization.

Authorize Workspace

On the Slack authorization page:

Select the workspace you want to connect
Review the requested permissions
Click Allow to grant access

You must be a workspace admin or have permission to install apps in your Slack workspace.

Select Default Channel

After authorization, you’ll be redirected back to Proliferate:

Navigate to the Slack integration settings
Choose a default channel for error notifications
The bot will automatically join the selected channel

The Proliferate bot can post to any public channel, even if it’s not a member. For private channels, you’ll need to invite the bot manually.

Test the Connection

Send a test message to verify everything is working:

Click Send Test Message in the integration settings
Check your selected channel for the test notification

Configuring Notifications

Selecting a Notification Channel

To set or change the default notification channel:

Go to Settings → Integrations
Click on the Slack integration card (if connected)
Select a channel from the dropdown
Click Save

The bot will automatically join the channel if needed.

Notification Settings

Configure when and how you receive notifications:

Error Severity Levels

Choose which error levels trigger notifications:

Fatal: Critical errors that crash the application
Error: Standard errors
Warning: Non-critical warnings
Info: Informational messages

Notification Frequency

Control how often you’re notified about the same issue:

First occurrence only: Notify only when an issue first appears
Every occurrence: Notify for each error event (can be noisy)
Threshold-based: Notify when error count exceeds a threshold
Rate-based: Notify when error rate spikes

Filters

Set up filters to only receive notifications for specific errors:

Filter by environment (production, staging, etc.)
Filter by release version
Filter by affected user count
Custom tag filters

Notification Format

Slack notifications include:

🔴 New Error in Production

TypeError: Cannot read property 'user' of undefined

Project: My App
Environment: production
Affected Users: 12
First Seen: 2 minutes ago

[View Full Details →]

The notification includes:

Error severity icon
Error type and message
Project and environment information
User impact metrics
Link to the error detail page

Workspace Search & Indexing

Enable Slack message indexing to search your workspace directly from Proliferate:

During installation, grant the additional permissions for message history
The indexing connector will be automatically created
Messages are indexed on a regular schedule
Search across all accessible channels from your Proliferate dashboard

Indexing respects Slack’s privacy settings. Only messages in channels where the bot is a member will be indexed.

Permissions for Indexing

The Slack App requests these additional permissions for indexing:

channels:history - Read public channel messages
groups:history - Read private channel messages (for channels the bot is invited to)
im:history - Read direct messages
users:read.email - Match Slack users to Proliferate users for access control

API Endpoints

The Slack integration provides these endpoints:

Endpoint	Method	Description
`/api/v1/integrations/slack/install`	GET	Start Slack OAuth flow
`/api/v1/integrations/slack/callback`	GET	Handle OAuth callback
`/api/v1/integrations/slack/channels`	GET	List available channels
`/api/v1/integrations/slack/channels/select`	POST	Set default notification channel
`/api/v1/integrations/slack/test`	POST	Send a test message
`/api/v1/integrations/slack/disconnect`	DELETE	Remove Slack connection
`/api/v1/integrations/slack/webhook`	POST	Receive Slack events

Testing Your Connection

After installation, verify your Slack integration:

Send a Test Message:
- Go to Settings → Integrations
- Find the Slack integration
- Click Send Test Message
- Check your selected channel
Trigger a Test Error:
- Generate an error in your application
- Wait a few seconds
- Check your notification channel for the alert

Troubleshooting

Not receiving notifications

Checklist:

Is a default channel selected?
Has the bot been kicked from the channel?
Are your notification filters too restrictive?
Check that errors match your severity filter settings

Bot can't post to channel

For private channels:

Type /invite @Proliferate in the channel
The bot needs to be explicitly invited to private channels

For public channels:

The bot should be able to post automatically
Ensure the bot hasn’t been removed from the workspace

Messages not being indexed

Common issues:

The bot must be a member of channels to index them
Indexing runs on a schedule (not real-time)
Check that you granted history permissions during installation
Private channels require the bot to be invited

OAuth connection failed

If installation fails:

Verify you have permission to install apps
Check that your workspace allows custom app installations
Try disconnecting and reconnecting
Clear your browser cache and try again

Managing the Integration

Updating Channel Selection

To change which channel receives notifications:

Go to Settings → Integrations
Click on the connected Slack integration
Select a new channel from the dropdown
Click Save

Changes take effect immediately for new notifications.

Managing Bot Permissions

To modify what the bot can access:

Go to your Slack workspace settings
Navigate to Apps → Proliferate
Update permissions or channel access
Changes sync automatically

Disconnecting Slack

To remove the integration:

Disconnect in Proliferate

Go to Settings → Integrations
Click the disconnect icon on the Slack card
Confirm the disconnection

Uninstall from Slack (Optional)

Go to Slack workspace settings
Navigate to Apps → Proliferate
Click Remove App

Disconnecting Slack will stop all error notifications to your channels. Existing messages will remain in Slack.

Best Practices

Use a Dedicated Channel

Create a dedicated channel like #errors or #app-monitoring for notifications. This keeps alerts organized and doesn’t clutter other channels.

Set Appropriate Filters

Use severity and environment filters to reduce noise. For example, only notify for errors in production.

Configure Thresholds

Use threshold-based notifications to avoid spam during error spikes. Get notified when an issue crosses a threshold, not for every occurrence.

Invite Bot to Relevant Channels

For indexing to work effectively, invite the bot to channels where you discuss technical issues or share knowledge.

Review Permissions Regularly

Audit which channels the bot has access to and adjust as your team’s needs change.

Required Scopes

The Slack integration requests these OAuth scopes:

Scope	Purpose
`channels:read`	List public channels
`channels:join`	Join public channels for posting
`channels:history`	Read public channel messages (for indexing)
`groups:read`	List private channels
`groups:history`	Read private channel messages (for indexing)
`chat:write`	Post messages to channels
`chat:write.public`	Post to channels without being a member
`team:read`	Get workspace information
`users:read`	Get user information
`users:read.email`	Get user emails (for ACL matching)

All scopes are necessary for the full feature set. If you deny certain permissions, some features may not work as expected.

Integrations

​Overview

​What You Get

Real-Time Alerts

Rich Error Details

Channel Selection

Workspace Search

​Setup Process

​Configuring Notifications

​Selecting a Notification Channel

​Notification Settings

​Notification Format

​Workspace Search & Indexing

​Permissions for Indexing

​API Endpoints

​Testing Your Connection

​Troubleshooting

​Managing the Integration

​Updating Channel Selection

​Managing Bot Permissions

​Disconnecting Slack

​Best Practices

​Required Scopes

Overview

What You Get

Setup Process

Configuring Notifications

Selecting a Notification Channel

Notification Settings

Notification Format

Workspace Search & Indexing

Permissions for Indexing

API Endpoints

Testing Your Connection

Troubleshooting

Managing the Integration

Updating Channel Selection

Managing Bot Permissions

Disconnecting Slack

Best Practices

Required Scopes