Skip to main content
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.

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.
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
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.
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 checklistEach organization then adds Tracecat from the Slack quickstart.Slack Marketplace listings require HTTP. See Slack’s distribution requirements, Socket Mode limitations, and API rate limits.