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

# Slack Integration — Search Team Conversations with AI

> Connect Slack to Hyper to index channel threads across workspaces and search conversations using native Slack syntax through any AI agent.

Slack is where your team thinks out loud — decisions get made, context gets shared, and institutional knowledge flows freely through channel threads. When you connect Slack to Hyper, those conversations become part of your shared AI memory layer. Agents can search across all your channels using native Slack syntax, retrieve full thread context, and surface relevant discussion history exactly when you need it. Hyper supports multiple Slack workspaces, so teams working across organizations can connect everything in one place.

## Connect Slack

<Steps>
  <Step title="Open Settings in the Hyper desktop app">
    Launch the Hyper desktop app and click **Settings** in the navigation, then select **Connections**.
  </Step>

  <Step title="Click Connect next to Slack">
    Find Slack in the list of available integrations and click **Connect**. If you want to add multiple workspaces, you'll repeat this step for each one.
  </Step>

  <Step title="Authorize with Slack OAuth 2.0">
    A Slack authorization window opens. Sign in to the workspace you want to connect and approve the requested permissions. Hyper uses a **user token** (not a bot token), which enables the `search:read` scope required for full message search. Your Slack password is never stored by Hyper.
  </Step>

  <Step title="Wait for the initial sync to complete">
    Hyper fetches recent threads from your channels and begins indexing them. Progress is visible in **Settings → Connections**.
  </Step>

  <Step title="Add more workspaces (optional)">
    To connect additional Slack workspaces, return to **Settings → Connections** and click **Connect** next to Slack again. Each workspace appears as a separate connection entry.
  </Step>
</Steps>

<Info>
  Hyper uses a Slack **user token**, not a bot token. This means it searches as you and can only access channels your account can already see — no elevated permissions are granted.
</Info>

## What Hyper Syncs

| What's synced           | Details                                                                        |
| ----------------------- | ------------------------------------------------------------------------------ |
| **Channel threads**     | Recent threads from channels your account has access to                        |
| **Multiple workspaces** | Each connected workspace is synced independently                               |
| **Deduplication**       | Content-hash dedup prevents duplicate threads from appearing in search results |
| **Source links**        | Each message links back to its Slack permalink                                 |

<Note>
  Hyper reads Slack message content only — it never posts, reacts, edits, or deletes any messages on your behalf.
</Note>

## Search Slack with AI Agents

Once connected, your AI agents can query Slack using native Slack search syntax or natural language. Hyper translates your intent into the right search query and returns relevant threads.

**Supported search operators:**

| Operator    | Example             | What it does                   |
| ----------- | ------------------- | ------------------------------ |
| `from:`     | `from:@alice`       | Messages from a specific user  |
| `in:`       | `in:#engineering`   | Messages in a specific channel |
| `before:`   | `before:2024-06-01` | Messages sent before a date    |
| `after:`    | `after:2024-01-01`  | Messages sent after a date     |
| `has:link`  | `has:link`          | Messages containing a URL      |
| `is:thread` | `is:thread`         | Threaded replies only          |

**Example agent queries:**

```text theme={null}
Find the Slack discussion about the API migration in #engineering
Search Slack: from:@bob in:#product has:link
Show me threads about the new design system from last month
Read the full thread about the incident on March 5th
Find conversations mentioning "deployment freeze" in #devops
```

Agents can also read the complete content of a specific thread by providing its `channel_id:message_ts` identifier, giving full context for long discussions.

**What agents can do:**

| Action                     | Description                                                          |
| -------------------------- | -------------------------------------------------------------------- |
| **Search**                 | Query across all indexed threads with Slack operators                |
| **Read thread**            | Retrieve all replies in a specific thread by `channel_id:message_ts` |
| **Multi-workspace search** | Search across all connected workspaces simultaneously                |

## Reconnect Slack

If your Slack OAuth token expires or is revoked, Hyper will display a **Reconnect** prompt in **Settings → Connections**.

<Steps>
  <Step title="Go to Settings → Connections">
    Open the Hyper desktop app and navigate to **Settings → Connections**.
  </Step>

  <Step title="Click Reconnect next to the affected workspace">
    Each workspace has its own connection entry. Click **Reconnect** next to the workspace that needs re-authorization.
  </Step>

  <Step title="Complete the Slack OAuth flow">
    Authorize Hyper in the Slack window that opens. Your previously indexed messages are preserved — sync resumes from where it left off.
  </Step>
</Steps>

## Disconnect Slack

To remove a Slack workspace from Hyper, go to **Settings → Connections**, find the workspace entry, and click **Disconnect**. This revokes Hyper's token for that workspace and stops future syncing.

<Warning>
  Disconnecting a Slack workspace removes all indexed message data for that workspace from Hyper's memory layer. Other connected workspaces are unaffected.
</Warning>