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

# Slack AI integration

> Extend the Omni Agent with Slack messages, threads, and files so you can reference team discussions and shared documents alongside your data analysis.

export const integration_1 = "Slack"

export const integration_0 = "Slack"

<Note>
  **Looking to use Omni in Slack?** See the [Omni Slack Agent](/integrations/omni-slack-agent) guide.
</Note>

Omni's Slack AI integration extends the Omni Agent with the ability to search messages, threads, and files across your Slack workspace. This allows you to reference team conversations, decisions, and shared documents alongside your data analysis. Using the Slack integration, you could:

* **Pull context from discussions** - Reference past conversations about a metric or definition while analyzing the corresponding data in Omni
* **Cross-check decisions** - Find the thread where a KPI target or reporting change was agreed on and incorporate it into your analysis
* **Locate shared files** - Surface spreadsheets, screenshots, or documents that were shared in channels relevant to your question

For example, you could ask: *"Find the thread where we discussed last quarter's churn target and compare it to this quarter's actuals"* - combining team context with data analysis in a single conversation.

## Common questions

<AccordionGroup>
  <Accordion title="What can the Omni Agent access?">
    Every Omni user that wants to use the Slack AI integration must connect their Slack account. This means that the Omni Agent will have the same permissions as the prompting user, accessing only the channels, messages, and files they have access to in Slack.
  </Accordion>

  <Accordion title="What Slack scopes does the integration need?">
    When individual users connect their Slack accounts, Omni will request the following scopes:

    | Scope              | Purpose                                                                |
    | ------------------ | ---------------------------------------------------------------------- |
    | `search:read`      | Search messages and files                                              |
    | `users:read`       | Get user info for metadata                                             |
    | `team:read`        | Get team info for workspace domain (used in permalinks)                |
    | `channels:read`    | Read channel info                                                      |
    | `channels:history` | Read message history in public channels (for `conversations.replies`)  |
    | `groups:read`      | Read private channel info (if user has access)                         |
    | `groups:history`   | Read message history in private channels (for `conversations.replies`) |
  </Accordion>

  <Accordion title="How are messages and file contents processed?">
    Slack messages, threads, and file contents are processed the same way as other AI features in Omni. Refer to [AI data privacy](/ai/security) for more information.
  </Accordion>

  <Accordion title="Is this the same as the Omni Slack Agent?">
    No. The Slack AI integration is different than the [Omni Slack Agent](/integrations/omni-slack-agent).

    This integration allows the Omni Agent to use Slack messages, files, and threads as context, whereas the Omni Slack Agent enables your team to ask questions about your Omni data from within Slack.
  </Accordion>
</AccordionGroup>

## Setting up the Slack integration

### Requirements

To configure the Slack integration for your Omni organization, you'll need:

* **Organization Admin** permissions in Omni
* Permissions in Slack that allow you to install or create apps in your workspace

<Steps titleSize="h3">
  <Step title="Create the Slack app" id="slack-app">
    1. In a new browser tab, open [Your Apps in Slack](https://api.slack.com/apps)
    2. Click **Create New App**.
    3. In the **Create an app** dialog, click the **From a manifest** option and then **Next**.
    4. Select the Slack workspace to install the app into and click **Next**.
    5. Copy and paste the following app manifest into the code editor:
       ```json Example Slack app manifest theme={null}
       {
           "display_information": {
               "name": "Omni AI Context"
           },
           "oauth_config": {
               "redirect_urls": [
                   "https://callbacks.omniapp.co/callback/slack-ai"
               ],
               "pkce_enabled": false
           },
           "settings": {
               "org_deploy_enabled": false,
               "socket_mode_enabled": false,
               "token_rotation_enabled": false,
               "is_mcp_enabled": false
           }
       }
       ```
    6. Click **Next**.
    7. Review the app summary, clicking **Create** when finished.
  </Step>

  <Step title="Retrieve client credentials" id="app-credentials">
    After you create the app, you should be redirected to the app's **Basic information** page.

    Locate the **Client ID** and **Client Secret** fields:

    <Frame caption="Highlighted Client ID and Client Secret fields in Slack app">
      <img src="https://mintcdn.com/omni-e7402367/2YiztRz_AEAzbvC6/integrations/images/slack-ai-app-credentials.png?fit=max&auto=format&n=2YiztRz_AEAzbvC6&q=85&s=7c01b7a4e009e5e760a581844f4d53e6" alt="Highlighted Client ID and Client Secret fields in Slack app" width="1002" height="783" data-path="integrations/images/slack-ai-app-credentials.png" />
    </Frame>

    Keep this page open - you'll need it to complete the next step.
  </Step>

  <Step title="Enable and configure the Omni integration" id="omni-integration">
    1. In Omni, navigate to **Settings > Integrations**.
    2. Click the **AI Integrations** tab.
    3. Toggle the **{integration_0} integration** to **on**.
    4. You'll be prompted for your {integration_0} credentials:

       * **OAuth Client ID** - Paste the **Client ID** from the {integration_0} app
       * **OAuth Client Secret** - Paste the **Client secret** from the {integration_0} app
    5. Click **Save**.
  </Step>
</Steps>

The integration will be available in your Omni organization. Users will need to connect their individual accounts in their [user settings](/administration/users/your-account) to use the integration.

## Connecting your Slack account

<Note>
  **This section applies to all users**, not only {integration_1} admins. Every user who wants to use the {integration_1} AI integration must connect their {integration_1} account.
</Note>

After the {integration_1} AI integration is enabled for your Omni organization, users will need to connect their individual {integration_1} accounts to use the integration:

<Steps>
  <Step noAnchor>
    In Omni, click your user icon and then [**Manage account**](/administration/users/your-account).
  </Step>

  <Step noAnchor>
    Scroll down to the **Connected Services** section.
  </Step>

  <Step noAnchor>
    Next to the **{integration_1}** integration, click **Connect**.
  </Step>

  <Step noAnchor>
    Complete the authentication flow to connect your account.
  </Step>
</Steps>

## Using Slack in the Omni Agent

<Note>
  Before users can use Slack with the Omni Agent, they will need to connect their Slack accounts in their [user settings](/administration/users/your-account).
</Note>

Once your Slack account is connected, you can ask the Omni Agent to search messages, threads, and files across the channels you have access to.

### Searching messages

The Omni Agent can search across public channels and the private channels and DMs you're a member of. To search messages, ask questions like:

* "Find messages in #analytics about the new attribution model"
* "Search Slack for discussions about Q3 revenue targets"
* "Look for messages from our finance team about budget reporting"

The Omni Agent will return matching messages in the chat, including:

* Channel name
* Sender and timestamp
* Message content with surrounding context
* Direct link to the message in Slack

### Reading threads

You can also ask the Omni Agent to pull the full contents of a specific thread for deeper context:

* "Show me the thread where we finalized the churn metric definition"
* "Get the discussion from last week's incident thread in #engineering"

The Omni Agent returns the thread contents inline, so you can review decisions and context without leaving Omni.

### Finding files

The Omni Agent can surface files shared in Slack channels you have access to:

* "Find the pricing spreadsheet that was shared in #sales last month"
* "Look for the architecture diagram shared in #platform"

## Next steps

* [Explore the Omni Agent](/ai/chat) to learn more about conversational data analysis
* [Optimize your models for AI](/modeling/develop/ai-optimization) to improve AI-generated query quality
* [Review AI security practices](/ai/security) to understand how Omni processes data