# Slack Integration

> Note: Make sure you have the proper admin permissions in your Slack workspace to authorize this integration.

### Connect Org Wide

Note:

* This feature connects all existing Rox users to all matching users in your Slack instance
* Rox uses the email address as the key. If a user has a different email address in Rox vs. Slack (e.g. <diogo@roxhq.ai> vs. <diogo@rox.com>) this method will not connect their account.
* This feature is only available to enterprise customers. If you are an admin for your org, please contact <help@rox.com> to get this feature set up for you.

#### Connecting/Disconnecting Slack Org Wide

*Note: only available in Enterprise edition and for users given "admin" privileges.*

Head over to Slack settings and connect your individual account by following the steps above. Once done, return to Integrations page and click on the "Slack settings" icon:

Once in the settings screen, click connect Slack.

<figure><img src="/files/kxzAgZuZUF4erdeGv2ht" alt=""><figcaption></figcaption></figure>

If you workspace requires admin approval for adding new Slack apps, you will see a confirmation page after you request access.

<figure><img src="/files/ipieScmJC6P9MBIbTCBP" alt=""><figcaption></figcaption></figure>

Workspace admin will have to approve the Slack app before it can be added to the Slack workspace.

Once approved, from the Rox integration settings page(<https://run.rox.com/settings?tab=integrations>), restart the connection process. Now click connect, you'll be taken to the permissions page, and hit "Allow"

<figure><img src="/files/SNNtKVS2DJ5lZBcNyNiv" alt=""><figcaption></figcaption></figure>

After successful Slack oauth flow, you will be taken to the Rox integrations settings page where Slack will be in connecting state and will convert to connected in a few minutes.

<figure><img src="/files/GRKnI32mAagtrwjdQagT" alt=""><figcaption></figcaption></figure>

and that's it Rox Slack integration is not connected!

### Using Rox in Slack Channels

To use Rox in a Slack channel, the Rox bot must first be added to that channel.

1. Open the Slack channel where you want to use Rox.
2. Click the channel name at the top.
3. Select the Integrations.

   <div align="left"><figure><img src="/files/PfiifsolZW6gV3KcbjJb" alt="" width="375"><figcaption></figcaption></figure></div>
4. Click Add an apps.
5. Search for Rox and add the app to the channel.

<div align="left"><figure><img src="/files/wcJxJzjLiaINDu5bqDaq" alt="" width="375"><figcaption></figcaption></figure></div>

> Note: You may need Slack admin approval if your workspace restricts adding apps to channels.

### Connect Slack Channels to Rox Accounts

> Note: Rox bot must be added to the Slack channel before linking

Rox allows you to connect Slack channels to customer accounts so conversations, insights, meeting prep, and proactive updates stay tied to the right account context.

#### Option 1: Link a Channel Using the `/rox` Command

Best for: Slack users who want to quickly connect individual channels directly from Slack.

1. Open the Slack channel you want to connect.
2. Run the following Slack slash command `/rox`

<div align="left"><figure><img src="/files/znWNbvea9Ca1T37lnqcU" alt="" width="375"><figcaption></figcaption></figure></div>

3. Click the Link Accountnt button.<br>

   <div align="left"><figure><img src="/files/yLWxuML1YQeHfusaZkD9" alt="" width="375"><figcaption></figcaption></figure></div>
4. In the search modal, search for an account by either account name or company domain\
   ![](/files/Ocf4Exqo37chqGFQc5bm)
5. Select the correct account and click Link.

#### Option 2: Link Channels from Rox Settings

Best for: Rox admins managing multiple accounts to connect channels in bulk.

1. Open the Rox Integrations page:\
   <https://run.rox.com/settings?tab=integrations>
2. Go to Slack Integration Settings(gear icon) -> Channel Settings tab

   <div align="left"><figure><img src="/files/0E5ZPOprO4Lg5KJVVyjF" alt="" width="375"><figcaption></figcaption></figure></div>
3. Locate the Slack channel you want to connect.
4. Click Connect next to the channel name.
5. Search and select the appropriate account in the modal dropdown to link.

### How it Works

<div data-full-width="false"><figure><img src="/files/pw5l6RWHkbkxCkbWB8iH" alt=""><figcaption></figcaption></figure> <figure><img src="/files/aydR2Gb6Z08jFyICAewK" alt=""><figcaption></figcaption></figure> <figure><img src="/files/H10Cb0esScfgmLCbXXRW" alt=""><figcaption></figcaption></figure> <figure><img src="/files/pY14hFISkQ3rTyyXNaCV" alt=""><figcaption></figcaption></figure></div>

Rox’s Slack integration brings account research and meeting prep directly into Slack, so reps can ask questions and get actionable answers without leaving their workflow.

1. **Start with `@Rox` in any channel or DM**\
   Mention `@Rox` with a question (for example, “what changed at Acme this week?”). Rox treats that message as the start of a working thread.
2. **Rox keeps context in-thread**\
   Follow-up replies in the same thread are handled as one continuous conversation, so users can refine questions without repeating context.
3. **Get structured, actionable responses**\
   Rox responds in Slack with concise summaries, key findings, and recommended next actions.
4. **Use App Home for quick daily signal**\
   Slack App Home surfaces personalized insight and meeting panels so users can quickly scan what matters now and drill deeper when needed.
5. **Receive proactive updates where teams already work**\
   Rox can deliver pre-meeting briefings and insight digests to designated Slack channels, helping teams stay aligned without extra tools or tabs.<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rox.com/development/engineering/docs/rox-enterprise-integrations/slack-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
