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

<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. The integration is available to all users—connect your Slack account from your [user settings](/administration/users/your-account) to start using it with the Omni Agent. 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?">
    The Slack AI integration is available to all users without requiring organization-level configuration. When you connect your Slack account, the Omni Agent will have the same permissions as you, accessing only the channels, messages, and files you have access to in Slack.
  </Accordion>

  <Accordion title="What Slack scopes does the integration need?">
    When you connect your Slack account, 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>

## Connecting your Slack account

<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}** integration, click **Connect**.
  </Step>

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

## Using Slack in the Omni Agent

Once you've [connected your Slack account](#connecting-your-slack-account), 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.

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