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

# Slack integration

Connect Slack to your Tracevell workspace to get [signal](https://tracevell.com/docs/signals/introduction.md) alerts in your channels and to talk to [Tracevell Agent](https://tracevell.com/docs/platform/tracevell-agent.md) where your team already works. Once connected, Slack works across every project in the workspace.

## Connect Slack

1. Go to the **Settings** page and select **Integrations** under *Workspace settings* in the sidebar. You can also connect from the **Slack** card in any Signal's **Settings > Alerts** section (see [Alerts](https://tracevell.com/docs/signals/alerts.md#slack)).
2. Find the **Slack** card and click **Connect to Slack**.
3. You will be redirected to Slack's authorization page. Select the Slack workspace you want to connect and click **Allow**.
4. After authorization, you will be redirected back to Tracevell. The Slack card will show a **Connected** badge.

![Workspace integrations page showing Slack connection card](https://mintcdn.com/laminarai/hZlXit1qqSW34aVt/images/integrations/workspace-integrations.png?fit=max\&auto=format\&n=hZlXit1qqSW34aVt\&q=85\&s=a2e5bf2c1fa65d7d1f0e985b020252a7)

Workspace settings: Integrations, with the Slack card

## Tracevell Agent

[Tracevell Agent](https://tracevell.com/docs/platform/tracevell-agent.md) answers questions about your project's data in plain language, and Slack is one of the places it lives. Mention `@Tracevell` in a connected channel and it replies in the thread:

![Slack thread where a user asks Tracevell about recent event clusters and how to fix them, and the Tracevell app replies with the top clusters, what to fix next, and a recommended fix for file path resolution errors](https://mintcdn.com/laminarai/d9XjS_AxLkd_3ZV5/images/integrations/slack-agent-thread.png?fit=max\&auto=format\&n=d9XjS_AxLkd_3ZV5\&q=85\&s=707c3254ec1abc6f039002f426c677f5)

The agent runs SQL and reads trace context to ground its answer, then posts the reply back into the thread as a Slack message. Follow-up mentions in the same thread continue the conversation.

See how else you can interact with [Tracevell Agent](https://tracevell.com/docs/platform/tracevell-agent.md).

### Respond to an alert for more context

When an alert posts to a Slack channel, reply in that thread and mention `@Tracevell` to dig into what happened. The agent picks up the alert's signal event and trace from the thread, so you can ask it to explain the root cause, pull the full trace, or run a follow-up query without leaving Slack:

> @Tracevell why did this fire? Walk me through the trace.

### Connect a channel to a project

The agent answers about one Tracevell project per channel, so each channel is connected to a project before the agent can query its data. There are two ways to connect one:

* **From Slack.** Mention `@Tracevell` in a channel that is not yet connected. The agent replies with a project picker listing the projects available to your workspace. Choose one, and the channel is connected. Mention the agent again and it answers from that project's data.
* **From Tracevell.** A workspace admin can connect a channel to a project from **Workspace → Integrations**.

![Workspace integrations page showing Slack channels connected to Tracevell projects](https://mintcdn.com/laminarai/d9XjS_AxLkd_3ZV5/images/integrations/slack-channel-projects.png?fit=max\&auto=format\&n=d9XjS_AxLkd_3ZV5\&q=85\&s=1a74de8f62f4d2de30a1ae3e9e2b272b)

Connecting Slack channels to projects from Workspace Integrations

Each channel maps to a single project, so pick the project whose traces the people in that channel care about.

## Alerts

Create [alerts](https://tracevell.com/docs/signals/alerts.md) on any Signal that post to a Slack channel of your choice whenever a signal event is detected. Each message contains the signal name, the extracted payload fields, and a link to the trace, so you find out the moment something you care about happens and can jump straight to the run.

![Slack message from Tracevell showing a critical Failure Detector event with category, description, and recommendation fields and Open trace, View similar events, and Manage alerts buttons](https://mintcdn.com/laminarai/d9XjS_AxLkd_3ZV5/images/integrations/slack-alert-notification.png?fit=max\&auto=format\&n=d9XjS_AxLkd_3ZV5\&q=85\&s=ebb0538efd5f6624bd3fe4b8a4453aef)

A critical Failure Detector alert in Slack, with the event details and a link to the trace

Pick the Slack channels for an alert in the Signal's **Settings > Alerts** section. That section also has its own **Slack** card, so you can connect Slack from there without opening workspace settings; both cards manage the same workspace connection. [Reports](https://tracevell.com/docs/signals/reports.md) can post to Slack the same way for scheduled rollups.

## Remove Slack integration

1. Go to the **Settings** page and select **Integrations** under *Workspace settings* in the sidebar.
2. On the connected Slack card, click the dropdown menu (three dots).
3. Select **Remove**.
4. Confirm the removal in the dialog.

> [!WARNING]
>
> Removing the integration deletes all alert subscriptions connected to that Slack workspace. This action cannot be undone.


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