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
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 Generate Required Tokens

After creating the app, you’ll need to generate two tokens:

​
Generate App-Level Token

  1. Navigate to “Basic Information” → “App-Level Tokens”
  2. Click “Generate Token and Scopes”
  3. Add the connections:write scope
  4. Click “Generate”
  5. Copy and save the token securely

​
Install App and Get Bot Token

  1. Install the app to your workspace
  2. Navigate to “Install App” section
  3. Copy the Bot User OAuth Token
  4. Save this token securely
📝 Important: Both tokens (App-Level Token and Bot User OAuth Token) will be needed when connecting Slack with your self-hosted Relvy instance.

​
Next Steps

Once the Slack app is configured, proceed to Application Deployment to self-host Relvy and activate the Slack integration.