> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Connect your Slack workspace to Ravenna with workspace admin permissions to enable ticket creation, AI agents, and team collaboration in Slack.

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

## Prerequisites

<Warning>
  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.
</Warning>

## Install Ravenna

<Steps>
  <Step title="Open Ravenna settings">
    Go to **Settings > Integrations** in your Ravenna workspace.
  </Step>

  <Step title="Add Slack integration">
    Find **Slack** in the Chat section and click **Connect**.
  </Step>

  <Step title="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
  </Step>

  <Step title="Complete setup">
    After authorization, you'll be redirected back to Ravenna with the integration connected.
  </Step>
</Steps>

## Connect channels

After installing the Ravenna app, connect Slack channels to Ravenna <Tooltip headline="Channels" tip="Channels organize tickets by team, topic, or workflow. Each channel has its own settings, integrations, and routing rules." cta="Learn about Channels" href="/documentation/platform/channels">Channels</Tooltip> to start receiving tickets.

<Steps>
  <Step title="Navigate to Channel settings">
    Go to **Channel > Settings** and click **Slack** in the left navigation.
  </Step>

  <Step title="Select a Slack channel">
    In the **Request Channels** section, click **Add Channel** and select the Slack channel you want to connect.
  </Step>

  <Step title="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 mirrors in the request channel)
    * **Public preview actions**: Allow end users to take actions on tickets from the request channel
  </Step>

  <Step title="Invite bot to channel">
    Open the Slack channel and type `/invite @Ravenna` to add the bot. The bot starts monitoring based on your channel settings.

    <Note>
      When you add Ravenna to a **private** Slack channel, Ravenna posts a one-time message in the channel reminding you that the channel becomes visible to all users in your Ravenna organization. Public channels do not show this notice.
    </Note>
  </Step>
</Steps>

<Callout icon="link" color="#6B7280">
  Learn how users can [create tickets](/integrations/slack/creating-tickets) in connected Slack channels.
</Callout>

### Channel name sync

When you rename a Slack channel, Ravenna automatically updates the connected channel name to match. The new name appears wherever the channel is referenced, including channel settings, workflows, and the Slack integration card.

<Note>
  Channel renames are synced through Slack events in real time. No manual re-sync or reconnect is required.
</Note>

## 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

To manually trigger a re-sync, go to **Settings > Integrations**, find your Slack connection, and click the **Sync** button. This initiates a re-authentication flow through OAuth, which refreshes your Slack data including users and user groups.

### User group syncing

Ravenna automatically syncs Slack user groups when you connect your Slack workspace. This happens during the initial OAuth authentication and keeps your Slack user groups available in Ravenna for access control, workflow assignments, and collaboration.

<Callout icon="link" color="#6B7280">
  Learn more about [synced groups](/documentation/platform/users/groups#synced-groups) and how to use them in Ravenna.
</Callout>

### Sync guest users

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

<Steps>
  <Step title="Navigate to integration settings">
    Go to **Settings > Integrations** and find your Slack connection.
  </Step>

  <Step title="Open configuration">
    Click the settings icon next to your Slack connection.
  </Step>

  <Step title="Enable guest sync">
    Toggle **Sync Guest Users** in the configuration modal.
  </Step>
</Steps>

<Note>
  Guest user synchronization respects the same interaction-based sync rules. Guest users must actively interact with Ravenna to be synchronized.
</Note>

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

<Steps>
  <Step title="Navigate to workspace settings">
    Go to **Workspace Settings > Slack**.
  </Step>

  <Step title="Find visibility settings">
    Scroll to the **Workspace Visibility** section at the bottom of the page.
  </Step>

  <Step title="Adjust toggles">
    Toggle **Show in Slack Assistant** for each workspace to control whether it appears in Slack.
  </Step>
</Steps>

<Note>
  Changes take effect immediately. Hidden workspaces no longer appear in Slack commands, app home, or other Slack integrations.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Manually re-sync Slack">
    **Cause**: User or group data appears out of date, or recently added users are missing from Ravenna.

    **Solution**:

    * Go to **Settings > Integrations** and find your Slack connection
    * Click the **Sync** button on the Slack integration card
    * Complete the OAuth re-authentication flow when prompted
    * This refreshes your Slack data including users and user groups
    * You must be an **organization admin** to use the sync button
  </Accordion>

  <Accordion title="File attachments posted by Ravenna instead of the teammate">
    **Cause**: When a teammate replies to a ticket from the Ravenna web app with a file attachment, Ravenna uploads the file to the linked Slack thread on the teammate's behalf. The file then appears under the teammate's name in Slack. If their Slack authorization lacks the `files:write` scope, Ravenna uploads the file as the Ravenna bot instead.

    **Solution**:

    * Ask the teammate to sign in to Ravenna and re-authorize Slack from **Settings > Integrations**
    * After re-authorization, new file uploads from that teammate are attributed to them in Slack
    * Files uploaded before re-authorization remain attributed to the Ravenna bot
  </Accordion>
</AccordionGroup>

## Need help?

<Callout icon="link" color="#6B7280">
  Having issues with your Slack integration? Check our [support page](/integrations/slack/support) for troubleshooting help.
</Callout>