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
features:
  bot_user:
    display_name: Relvy AI
    always_online: false
  slash_commands:
    - command: /auto-investigate
      url: https://api.yourdomain.com/api/slack/slash
      description: Automatically investigates all alerts in the channel.
      should_escape: false
    - command: /cancel-auto-investigate
      url: https://api.yourdomain.com/api/slack/slash
      description: Disable automatic investigation of all channels
      should_escape: false
    - command: /set-relvyai-workspace
      url: https://api.yourdomain.com/api/slack/slash
      description: Map a Relvy workspace to this channel
      usage_hint: "[workspace name]"
      should_escape: false
oauth_config:
  redirect_urls:
    - https://api.yourdomain.com/slack/redirect
  scopes:
    user:
      - users.profile:read
    bot:
      - app_mentions:read
      - channels:history
      - channels:read
      - chat:write
      - commands
      - users.profile:read
      - groups:history
settings:
  event_subscriptions:
    request_url: https://api.yourdomain.com/api/slack/webhook
    bot_events:
      - app_mention
      - app_uninstalled
      - message.channels
      - message.groups
  interactivity:
    is_enabled: true
    request_url: https://api.yourdomain.com/api/slack/interaction_webhook
  org_deploy_enabled: false
  socket_mode_enabled: false
  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.