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

# Connecting Omni to Slack

> Connect Omni to your Slack workspace and link your Slack account to Omni to use the Omni Slack Agent.

Getting Omni into Slack has two steps:

1. An Organization Admin connects Omni to your Slack workspace. This only needs to happen once, and it sets up both the Omni Slack Agent and [scheduled Slack deliveries](https://docs.omni.co/share/deliveries/slack.md).
2. Anyone who wants to chat with the agent links their own Slack account to Omni.

## Connecting your Omni organization

To connect your Omni organization to Slack, you'll need:

* **The following in Slack**:
  * An existing Slack workspace
  * Permissions to install apps
* **The following in Omni**:
  * Organization Admin permissions
  * [AI features enabled](https://docs.omni.co/ai/settings/features.md)
  * At least one [topic](https://docs.omni.co/modeling/topics) configured in a model

### 1. Connect your Slack workspace

1. In Omni, navigate to **Settings > Integrations**.
2. In the **Slack** tab, click **Connect to Slack**.
3. Complete the Slack authorization flow.

You'll be redirected back to Omni once the connection is established. Admins receive a welcome message in Slack confirming the integration is active.

> [!TIP]
>
> **Already connected for deliveries?** If your Slack workspace is already connected for [scheduled deliveries](https://docs.omni.co/share/deliveries/slack.md), you'll see an option to upgrade the connection with additional permissions required by the Omni Slack Agent. Click **Reconnect** to authorize the expanded permissions.

### 2. Configure the agent's settings

Before your team starts using the agent, review its settings in the **Slack** tab. You can set the default model the agent uses and choose whether its channel responses are private. See [Omni Slack Agent settings](https://docs.omni.co/integrations/slack/settings.md) for more information.

### 3. Introduce the agent to your team

To help your team discover the Omni Slack Agent, use the workflow in the welcome message to let the agent introduce itself in a public channel. The welcome message includes a preview of the introduction.

> [!NOTE]
>
> Introducing the Omni Slack Agent in a public channel is the best way to drive broad awareness and encourage your team to connect their accounts and start asking questions.

## Connecting your Omni account

> [!NOTE]
>
> **This section applies to all users**. Every user who wants to interact with the Omni Slack Agent must connect their Omni account.

Before you can use the Omni Slack Agent, you'll need to link your Slack account to your Omni account:

1. Send a message to the Omni Slack Agent, either in a DM or a channel that Omni is a member of.
2. Click the **Connect account** button in the agent's reply.
3. Follow the prompts to link your Slack identity to your Omni account.

After you connect, you'll receive confirmation and welcome messages. The agent will also reply to your original question. See [Interacting with the Omni Slack Agent](https://docs.omni.co/integrations/slack/questions-commands.md) for more information on using the agent.

## Managing Slack

Organization Admins can configure the Omni Slack Agent, reconnect or disconnect the integration, and upgrade scopes in **Settings > Integrations > Slack**. See [Omni Slack Agent settings](https://docs.omni.co/integrations/slack/settings.md) for details.

## Troubleshooting

> [accordion] Agent doesn't respond to DMs
>
> If the agent doesn't respond to direct messages, the [`im:history`](https://docs.omni.co/integrations/slack#scopes) scope may not have been granted during setup. DMs can't reach the agent without this scope.
>
> If this happens, use [`/omni ask`](https://docs.omni.co/integrations/slack/questions-commands#omni-ask) instead.

> [accordion] Received an info message after clicking Connect account
>
> If you receive an info message after clicking the **Connect account** button, an Organization Admin may have turned the Omni Slack Agent off after the agent sent you the button. You won't be able to link your account until the agent is turned on again.
