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

# Slack

> Receive Oso alert notifications in Slack.

Connect Oso to Slack to receive alert notifications in a channel of your choice. Each notification links directly to the alert details page in Oso for investigation.

## Prerequisites

* An Oso for Agents account with at least one [alert](/oso-for-agents/alerts) configured
* Permission to add apps to your Slack workspace (or a workspace admin who can approve it)

## Connect Slack

1. In Oso, go to **Settings** and click the **Integrations** tab.

2. Click **Connect** next to Slack.

<img src="https://mintcdn.com/osoinc/RsJbsaYjnb-AQ_8q/images/integrations/slack/settings_integrations.png?fit=max&auto=format&n=RsJbsaYjnb-AQ_8q&q=85&s=8724bf90fd2b165f0f8f986cf54e918e" alt="Oso integrations settings page" width="937" height="359" data-path="images/integrations/slack/settings_integrations.png" />

3. You will be redirected to Slack to authorize the Oso app.

## Choose a notification channel

1. Once redirected, select the Slack channel where alert notifications should be posted.

<img src="https://mintcdn.com/osoinc/RsJbsaYjnb-AQ_8q/images/integrations/slack/channel_select.png?fit=max&auto=format&n=RsJbsaYjnb-AQ_8q&q=85&s=77eb079ef2254ae93bcb7c875045a94a" alt="Slack channel selection in Oso" width="1480" height="658" data-path="images/integrations/slack/channel_select.png" />

2. Click **Allow**.

3. On the next Alert the configured channel should receive a slack message.

## What a notification looks like

Each Slack notification includes:

* **What was detected** — the alert type
* **Who was involved** — the agent, user, or device

<img src="https://mintcdn.com/osoinc/RsJbsaYjnb-AQ_8q/images/integrations/slack/notification_example.png?fit=max&auto=format&n=RsJbsaYjnb-AQ_8q&q=85&s=cc67e4b9ad477bd4a8dd4909ef622ea9" alt="Example Slack alert notification" width="1828" height="650" data-path="images/integrations/slack/notification_example.png" />

## Disconnecting Slack

To disconnect, go to **Settings → Integrations → Slack** and click **Disconnect**. Oso will stop sending notifications immediately. Reconnecting will prompt you to re-authorize and re-select a channel.
