# Slack

import { Steps } from "@astrojs/starlight/components"
import Prereqs from "@docs/Prereqs.astro"
import UiWalkthrough from "@docs/UiWalkthrough.astro"

Connect Ren to Slack so that messages in mapped channels create agent sessions, and agents can reply directly in threads.

<Prereqs>
  - A Ren account with admin access to your organization - A Slack workspace where you can install apps - At least one
  [project](/docs/deep-dives/concepts/compute/projects/) with an agent attached
</Prereqs>

## Install the Slack app

<UiWalkthrough>
  {/* TODO(demo): screen recording – Slack OAuth install flow and channel mapping, ~12s loop */}
</UiWalkthrough>

<Steps>

1. Open **Settings → Integrations → Slack** in the Ren dashboard.

2. Click **Connect Slack**. You'll be redirected to Slack to authorize the Ren bot for your Slack workspace.

3. After approval, you're returned to Ren. The Slack workspace is now linked to your organization.

</Steps>

## Map channels to projects

Each Slack channel can be mapped to one Ren project. When someone posts in a mapped channel, Ren creates a session using the project's primary agent (or the default agent you specify).

<Steps>

1. In **Settings → Integrations → Slack**, click **Map channel**.

2. Select a Slack channel and a Ren project.

3. Optionally choose a **default agent** and a **fallback sender** (the Ren user whose identity the agent uses when posting).

4. Click **Save**. Messages in that channel now trigger agent sessions.

</Steps>

To remove a mapping, click the channel's **Unmap** button. The Slack bot remains installed. Only the routing is removed.

## Disconnect Slack

In **Settings → Integrations → Slack**, click **Disconnect**. This removes the Slack bot from your Slack workspace and deletes all channel mappings.