Skip to main content
To chat with a preset agent in Slack without building workflows, use Channels (Enterprise).

Slack apps

A Slack app sends Slack activity to Tracecat webhooks. Your workflows reply with tools.slack actions. Slack expects an HTTP 200 within 3 seconds. echo=true answers the URL verification challenge. echo=true&empty_echo=true returns the empty 200 Slack expects for interactions and slash commands. empty_echo only applies together with echo=true. Use one workflow per Slack feature. Each webhook URL starts one workflow. Slack app settings pages live at https://api.slack.com/apps/<app-id>/<page>. Find the app ID in Basic Information on Slack apps.

App manifest and scopes

The manifest requests these bot token scopes. Edit scopes later in OAuth & Permissions (/apps/<app-id>/oauth). Remove the slash_commands, event_subscriptions, or interactivity block if you don’t use that feature. See the app manifest reference. Open the sample Slack app manifest. In a local copy, replace each request URL with its workflow’s webhook URL and keep the matching suffix. Treat each full webhook URL as a credential.
Add these only for the tools.slack actions you use.

Create the app

Before you start, publish each workflow, copy its webhook URL (https://<tracecat-host>/api/webhooks/<workflow-id>/<webhook-secret>), and leave webhook API key authentication off. Slack can’t send the x-tracecat-api-key header and must reach Tracecat over public HTTPS.
1

Create the app from a manifest

Open Slack apps, click Create New App > From a manifest, pick your workspace, and select JSON, and paste your configured manifest.
2

Install the app

Open Install App (/apps/<app-id>/install-on-team) and click Install to Workspace.
3

Save the bot token in Tracecat

Copy the Bot User OAuth Token (xoxb-...) from OAuth & Permissions (/apps/<app-id>/oauth). In Tracecat, set SLACK_BOT_TOKEN on the slack credential.
4

Invite the app

In each channel the app should read, run /invite @<app-name>.
Reinstall the app after you change scopes, events, or slash commands.

Event subscriptions

Run a workflow when something happens in Slack, such as a user mentioning @Tracecat.
1

Turn on events

Open Event Subscriptions (/apps/<app-id>/event-subscriptions) and turn on Enable Events.Slack Event Subscriptions toggle
2

Set the request URL

Paste the webhook URL with ?echo=true. Slack shows Verified when Tracecat echoes the challenge.Slack request URL verified
3

Subscribe to app_mention

Under Subscribe to bot events, add app_mention, then click Save Changes.
Start with app_mention. It only fires when a user mentions the app. Message events such as message.channels start a run for every message in every channel the app is in.
The event is in TRIGGER.event. The verification request also starts a run, so skip it with run_if:
Slack retries events that don’t get a 200 in 3 seconds. Deduplicate on TRIGGER.event_id.

Interactivity

Run a workflow when a user clicks or submits something in a message or modal your workflow posted.
1

Turn on interactivity

Open Interactivity & Shortcuts (/apps/<app-id>/interactive-messages) and turn on Interactivity.
2

Set the request URL

Paste the webhook URL with ?echo=true&empty_echo=true, then click Save Changes.
Slack allows one interactivity URL per app. Send every interaction to one workflow and branch on action_id or type.
Build messages and modals in Block Kit Builder.
Slack sends the interaction as a JSON string in the payload form field. Parse it with FN.deserialize_json:
See block_actions payloads for every field.

Slash commands

Let users run a workflow on demand, such as /tracecat lookup 1.2.3.4. Slack slash command
1

Create the command

Open Slash Commands (/apps/<app-id>/slash-commands) and click Create New Command.
2

Set the request URL

Enter the command, such as /tracecat, and paste the webhook URL with ?echo=true&empty_echo=true. Click Save.
3

Reinstall the app

Reinstall the app so Slack adds the commands scope.
Each command has its own URL. Slack sends form fields directly on TRIGGER:

References

  • See Webhooks for webhook URLs, payload parsing, and security options.
  • See Slack for every tools.slack action and its inputs.
  • See Channels to connect a preset agent to Slack without building workflows.