Skip to main content
Connect your Slack workspace to Ravenna to enable ticket creation, AI agents, and team collaboration directly in Slack.

​
Prerequisites

You must be a Slack workspace admin to install the Ravenna app. If you don’t have admin permissions, contact your Slack administrator to complete the installation.

​
Install Ravenna

1

Open Ravenna settings

Go to Settings > Integrations in your Ravenna workspace.
2

Add Slack integration

Find Slack in the Chat section and click Connect.
3

Authorize the connection

You’ll be redirected to Slack to authorize Ravenna:
  1. Select your Slack workspace from the dropdown
  2. Review the requested permissions
  3. Click Allow to grant access
4

Complete setup

After authorization, you’ll be redirected back to Ravenna with the integration connected.

​
Connect channels

After installing the Ravenna app, connect Slack channels to Ravenna to start receiving tickets.
1

Navigate to Channel settings

Go to Channel > Settings and click Slack in the left navigation.
2

Select a Slack channel

In the Request Channels section, click Add Channel and select the Slack channel you want to connect.
3

Configure channel settings

Configure how tickets are created from this channel:
  • Auto-create tickets: Automatically create tickets from all messages
  • Silent mode: Only create tickets in the web portal or triage channel (no ticket previews in the request channel)
  • Public preview actions: Allow end users to take actions on tickets from the request channel
4

Invite bot to channel

Open the Slack channel and type /invite @Ravenna to add the bot. The bot will start monitoring based on your channel settings.
Learn how users can create tickets in connected Slack channels.

​
User synchronization

Ravenna syncs only users who actively interact with the app, ensuring privacy and reducing clutter. Users are synchronized when they:
  • Create tickets with emojis or commands
  • Use Ravenna slash commands
  • Open the Ravenna app home in Slack
  • Interact with Ravenna modals or forms
Users are not synchronized when they:
  • Send regular messages in channels
  • Join or leave channels
  • Add non-Ravenna emoji reactions

​
Sync guest users

By default, Ravenna only syncs full Slack workspace members. Enable guest user synchronization to include single-channel and multi-channel guests.
1

Navigate to integration settings

Go to Settings > Integrations and find your Slack connection.
2

Open configuration

Click the settings icon next to your Slack connection.
3

Enable guest sync

Toggle Sync Guest Users in the configuration modal.
Guest user synchronization respects the same interaction-based sync rules. Guest users must actively interact with Ravenna to be synchronized.

​
Workspace visibility

Control which Ravenna workspaces appear in your Slack integration. Hide personal workspaces, testing environments, or other non-collaborative spaces while keeping team workspaces visible.
1

Navigate to workspace settings

Go to Workspace Settings > Slack.
2

Find visibility settings

Scroll to the Workspace Visibility section at the bottom of the page.
3

Adjust toggles

Toggle Show in Slack Assistant for each workspace to control whether it appears in Slack.
Changes take effect immediately. Hidden workspaces no longer appear in Slack commands, app home, or other Slack integrations.

​
Troubleshooting

Cause: Bot not invited to channel or integration disconnectedSolution:
  • Verify the bot is invited to the channel using /invite @Ravenna
  • Check integration status in Settings > Integrations
  • Try disconnecting and reconnecting the integration
Cause: Channel not connected or silent mode enabledSolution:
  • Verify the Slack channel is connected to a Ravenna Channel in Channel > Settings > Slack
  • Check if silent mode is enabled (tickets only appear in web portal or triage channel)
  • Ensure the bot is invited to the Slack channel
Cause: Slack app missing required permissionsSolution:
  • Reinstall the Slack app to grant all permissions
  • Verify workspace admin approved the installation
  • Check Slack workspace settings for app restrictions
Cause: Users haven’t interacted with RavennaSolution:
  • Users must actively interact with Ravenna to be synced (create tickets, use commands, etc.)
  • Verify Sync Guest Users is enabled if trying to sync guest users
  • Check that the Slack integration is properly connected