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

# Set up the platform Slack app

> Register one Slack app for your self-hosted Tracecat deployment.

Enterprise Edition

On self-hosted Tracecat, a platform superuser registers the app once. Each organization that installs it needs the Agent Channels preview entitlement (`agent_channels_preview`). On Tracecat Cloud, start with the [Slack quickstart](https://docs.tracecat.com/agents/ai-slackbot.md).

## Prepare your deployment

Set `TRACECAT__PUBLIC_API_URL` on the API service before creating the app, for example `https://tracecat.example.com/api`. The installer's browser must reach this URL. With HTTP (the default), Slack must reach it too.

> [accordion] Use Socket Mode
>
> Set `TRACECAT__SLACK_INGRESS_MODE=socket` on the API service and apply the change before creating the app. Tracecat connects to Slack over an outbound socket.
>
> After creating the app, open `Basic Information → App-Level Tokens` in Slack. Generate a token with `connections:write` and copy the access token (`xoxe.xapp-…`) and refresh token into Tracecat.

## Register the app

1. Open `Admin → Agent → Slack App` and click `Create in Slack`. Choose a workspace where you can manage apps and click `Create`.
2. In Slack, open `Basic Information → App Credentials`. Copy the app ID, client ID, client secret, and signing secret into Tracecat.
3. Click `Save` in Tracecat. The card shows `Registered`.

![Slack app registration and credentials](https://mintcdn.com/tracecat/-ilsbB1LpeF6wwGm/img/manage-platform/slack-app-setup.png?fit=max\&auto=format\&n=-ilsbB1LpeF6wwGm\&q=85\&s=6ec210c13cac4d61e6db0b5b0ad15e39)

> [accordion] Manual app setup
>
> For an unused app dedicated to this deployment, copy the manifest under `Create the app by hand instead`, apply it in Slack, and select `I already have the app` in Tracecat.
>
> For HTTP, use the manifest's request URL for both events and interactivity. If verification fails, save the signing secret in Tracecat and retry in Slack.

> [accordion] Allow other Slack workspaces (optional)
>
> Skip this unless Slack workspaces other than the one where you created the app need to add Tracecat. Until you turn on public distribution, only that workspace can add it.
>
> 1. Click `Open Manage Distribution`. In Slack, complete the checklist and click `Activate Public Distribution`.
> 2. Return to Tracecat and click `Mark done` next to `Turn on public distribution`.
>
> ![Public distribution checklist](https://mintcdn.com/tracecat/-ilsbB1LpeF6wwGm/img/manage-platform/slack-app-distribution.png?fit=max\&auto=format\&n=-ilsbB1LpeF6wwGm\&q=85\&s=7b68ef8fd99c293a0a536e50bf8c1e58)
>
> Each organization then adds Tracecat from the [Slack quickstart](https://docs.tracecat.com/agents/ai-slackbot.md).
>
> Slack Marketplace listings require HTTP. See [Slack's distribution requirements](https://docs.slack.dev/app-management/distribution/), [Socket Mode limitations](https://docs.slack.dev/apis/events-api/using-socket-mode/), and [API rate limits](https://docs.slack.dev/apis/web-api/rate-limits/).


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