Slack Integration Setup
Configure Slack app for Relvy integration (optional)
Optional Integration - Slack integration is optional but highly recommended for seamless investigations.
Overview
Slack integration allows Relvy to respond to slash commands and provide interactive responses directly in your Slack workspace. This integration enhances the investigation experience by bringing Relvy’s capabilities into your team’s communication platform.
Integration Features
- Slash Commands - Execute Relvy commands directly from Slack channels
- Interactive Messages - Rich interactive responses with buttons and forms
Prerequisites
- Slack Workspace Access: Admin access to the Slack workspace where you want to install the app
Step 1: Create Slack App
1.1 Navigate to Slack API
- Go to https://api.slack.com/apps
- Click “Create New App”
- Select “From manifest”
- Choose your workspace
1.2 Configure App Manifest
- Select YAML as the manifest format
- Copy and paste the following YAML manifest into the configuration
- Replace
api.yourdomain.com
with your actual domain name in all URLs
Manifest Summary
The manifest configures the following components:
Slash Commands:
/auto-investigate
- Enables automatic investigation of alerts in the channel/cancel-auto-investigate
- Disables automatic investigation in the channel/set-relvyai-workspace
- Maps a Relvy workspace to the current channel
Bot Permissions:
- Read channel messages and history
- Send messages to channels
- Read user profiles
- Respond to app mentions
- Handle interactive components
User Permissions:
- Read user profile information
Event Subscriptions:
- App mentions and uninstall events
- Channel and group message events
OAuth Configuration:
- Redirect URL for user authentication
- Secure token exchange for API access
1.3 Save Credentials
After creating the app, navigate to “Basic Information” → “App Credentials” and save these values securely:
- Client ID - Used for OAuth authentication
- Client Secret - Used for OAuth token exchange
- Signing Secret - Used to verify webhook requests
📝 Important: These credentials will be needed during the self-hosting setup phase. The Slack app will be installed to your workspace once Relvy is self-hosted and running.
Next Steps
Once the Slack app is configured, proceed to Application Deployment to self-host Relvy and activate the Slack integration.