Skip to main content
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

  1. Go to https://api.slack.com/apps
  2. Click “Create New App”
  3. Select “From manifest”
  4. Choose your workspace

​
1.2 Configure App Manifest

  1. Select YAML as the manifest format
  2. Copy and paste the following YAML manifest into the configuration
  3. Replace api.yourdomain.com with your actual domain name in all URLs
display_information:
  name: Relvy AI
  description: AI-powered debugging notebooks for faster incident resolution
features:
  bot_user:
    display_name: Relvy AI
    always_online: false
  slash_commands:
    - command: /auto-investigate
      description: Automatically investigates all alerts in the channel
      should_escape: false
    - command: /cancel-auto-investigate
      description: Disable automatic investigation of all channels
      should_escape: false
    - command: /set-relvyai-workspace
      description: Set a Relvy AI workspace for this channel
      usage_hint: "[workspace name]"
      should_escape: false
oauth_config:
  scopes:
    user:
      - users.profile:read
    bot:
      - app_mentions:read
      - channels:history
      - channels:read
      - chat:write
      - commands
      - groups:history
      - users.profile:read
settings:
  event_subscriptions:
    bot_events:
      - app_mention
      - app_uninstalled
      - message.channels
      - message.groups
  interactivity:
    is_enabled: true
  org_deploy_enabled: false
  socket_mode_enabled: true
  token_rotation_enabled: false

​
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.