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

# Slack

> Connect Slack channels so everyone in your organization can search their messages in Kepler.

The Slack connector syncs messages, files, and canvases into Kepler from the public Slack channels you choose. A Kepler admin connects it once for the whole organization. Kepler only reads. It never posts, changes, or deletes anything in Slack.

Slack connects through a Slack app that your organization creates from a manifest that Kepler gives you. The app belongs to your workspace, so you control it in Slack.

## Before you start

* **A Kepler organization admin.** Only admins can manage connectors.
* **A Slack account that can create and install apps** in the workspace you want to sync. If your workspace requires app approval, a Slack workspace admin must do these steps or approve the app.
* **One Slack workspace.** Each connection syncs one workspace. On Enterprise Grid, install the app to a single workspace, not to the whole organization.

> [!NOTE]
>
> If **Slack** is not listed when you add a connector, it is not yet turned on for your organization. Email [desk@kepler.ai](mailto:desk@kepler.ai) to turn it on.

## Connect Slack

**1. Open organization connectors**

In Kepler, open the account menu in the sidebar and select **Settings**. Under **Organization**, select **Org connectors**.

![Kepler Organization connectors page with an Add connector button](https://mintcdn.com/kepler-a6ccf6fc/RnlQKyo-7KmJ5tO0/images/connectors/org-connectors-page.png?fit=max\&auto=format\&n=RnlQKyo-7KmJ5tO0\&q=85\&s=0c273c43fe87f3d25fef4b51e805970d)

The Org connectors page, before any connector is added.

**2. Add Slack**

Select **Add connector**, then select **Slack**.

![Add a connector dialog with Slack selected](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/add-connector-slack.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=ce7f4a94b9574b4b9b0fab4372ca2124)

The Slack row opens and shows three setup steps. The first step shows your organization's app manifest.

![Slack row showing three steps: create the Slack app, connect the service account, and choose what syncs. The first step shows a manifest and fields for the app's credentials](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-app-setup.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=b5156688a17f93e6544c3bc3628f7770)

**3. Create the Slack app**

Select the copy button on the manifest. Then select **Your Apps** to open Slack's app page, and select **Create New App**.

In the **Create new app** dialog, select **From a manifest**, then **Continue**.

![Slack's Create new app dialog with From a manifest selected](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-create-app.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=134b14e8c973ea1b11ef54b2993506e6)

Select the workspace to sync, paste the manifest, and select **Next**. Check the summary, then select **Create**.

![Slack's Create from a manifest dialog with the pasted manifest and the workspace selected](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-manifest-workspace.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=3c470014047158d1420176efd9eaf1da)

> [!NOTE]
>
> Paste the manifest exactly as Kepler shows it. It contains your organization's own events address, which Slack checks when it creates the app. The manifest is different for each organization.

**4. Save the app's credentials**

Slack opens the new app's **Basic Information** page. Under **App Credentials**, copy the **Client ID**, the **Client Secret**, and the **Signing Secret**. Select **Show** to see each secret.

![Slack's App Credentials section with the Client ID, Client Secret, and Signing Secret](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-app-credentials.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=1a2a3fbd2f4c665e9819a512a6ff66fd)

In Kepler, paste the three values into the fields under the manifest, then select **Save credentials**. The step shows **The app's credentials are saved.**

![Slack row with the first step done and a Connect button in the second step](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-setup-steps.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=72c3f4459a42001aabd6ec9334e5bcc8)

**5. Connect the workspace**

Under **Connect the service account**, select **Connect**. Slack asks you to allow Kepler to access the workspace. Check that the workspace is the one you want to sync, then select **Allow**.

![Slack's Allow Kepler to access Slack page with the workspace selected and an Allow button](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-allow.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=8c1b402aa9ffc82490572e09320a976d)

When the connection works, the step shows **Connected as** with the workspace's name and address.

![Slack row after connecting, with the workspace connected and a Choose content button](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-connected.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=3dc23de076d5db2b3460d29c97f6900a)

**6. Choose channels**

Under **Choose what syncs**, select **Choose content**. Nothing syncs until you make a selection.

The picker lists the workspace's public channels and their member counts. Select the channels to sync, then select **Save selection**.

![Choose channels dialog listing five channels, all selected](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-picker.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=52f9bb0a59016836512060d4718b0543)

The Slack row now shows **Syncing** and the selected channels. Kepler joins each selected channel as the **Kepler** app, so the channel shows that Kepler joined.

![Slack row with the status Syncing and an Edit selection button](https://mintcdn.com/kepler-a6ccf6fc/7btB8jGIPgfWXJYs/images/connectors/slack-syncing.png?fit=max\&auto=format\&n=7btB8jGIPgfWXJYs\&q=85\&s=d277e07a714a23b876337ee5d86f4d45)

Slack is connected and syncing the selected channels.

## What Kepler syncs

* **Messages** in the selected channels, with their thread replies. Edits and deletes in Slack also change Kepler's copy.
* **Files** shared in the selected channels.
* **Canvases** in the selected channels.

New messages become searchable within minutes. Kepler groups each channel's messages by day, and answers cite the channel and the day.

Kepler syncs messages from the time you connect. To bring in older messages, email [desk@kepler.ai](mailto:desk@kepler.ai). A Slack workspace admin can export the history from Slack for Kepler to load.

> [!NOTE]
>
> Kepler manages access to a connection and access to its synced content separately. If your Slack content does not appear in the **Documents** library within 15 minutes, email [desk@kepler.ai](mailto:desk@kepler.ai).

## Permissions

The manifest asks Slack for these bot permissions. Kepler asks for no permission to post or to change anything.

| Permission | What it allows |
| - | - |
| `channels:read` | List the workspace's public channels for the picker |
| `channels:join` | Join the channels you select |
| `channels:history` | Read messages in the channels Kepler joined |
| `files:read` | Read files shared in those channels |
| `canvases:read` | Read canvases in those channels |
| `users:read` | Show the names of the people who wrote each message |

## Change or remove the connection

* **To change the channels**, select **Edit selection**. When you deselect a channel, Kepler stops syncing it. Kepler stays a member of the channel. To remove it, remove the **Kepler** app from the channel in Slack.
* **To disconnect**, select **Delete Slack connection**. Then delete the Kepler app from your workspace in Slack, if you no longer need it.

## Troubleshooting

> [accordion] Slack cannot verify the events address
>
> Slack checks the events address in the manifest when it creates the app. If Slack shows an error, make sure you pasted the whole manifest from Kepler, unchanged. If the error continues, email [desk@kepler.ai](mailto:desk@kepler.ai).

> [accordion] A channel is missing from the picker
>
> The picker lists only public channels. Kepler cannot sync private channels or direct messages. An archived channel is not listed either.

> [accordion] The picker says Kepler was removed from a channel
>
> Someone removed the Kepler app from the channel in Slack, so Kepler cannot read it. To sync it again, add the **Kepler** app to the channel in Slack.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.