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

# Slack

> Investigate incidents, triage alerts, and explore system behavior directly from Slack.

With the Traversal Slack bot, you can start investigations, receive reports, and ask follow-up questions without leaving Slack. Mention `@Traversal` in any channel the app has been added to, or DM it directly.

## SaaS Slack installation

<Steps>
  <Step title="Go to the Slack Marketplace">
    Visit the [Traversal Slack app](https://slack.com/marketplace/A07Q5AMJ0S3-traversal) in the Slack Marketplace.
  </Step>

  <Step title="Install the app">
    A Slack workspace administrator installs the Traversal app to your workspace.
  </Step>

  <Step title="Contact Traversal for provisioning">
    Reach out to the Traversal team to correctly provision your Slack app for your organization.
  </Step>

  <Step title="Start using Traversal">
    Once provisioned, you can begin using the Traversal Slack bot in your workspace.
  </Step>
</Steps>

## BYOC Slack installation

For [BYOC](/architecture/byoc) customers, Traversal creates a dedicated Slack app for your organization.

<Steps>
  <Step title="Request your install link">
    Contact the Traversal team to receive a custom Slack app installation URL for your organization.
  </Step>

  <Step title="Install the app">
    A Slack workspace administrator opens the provided link and installs the Traversal app to your workspace.
  </Step>

  <Step title="Provision with Traversal">
    Reach out to the Traversal team to provision your app and start using it.
  </Step>
</Steps>

## Verify it works

Once your app is provisioned, tag `@Traversal` in any channel it's been added to and say hello.

<img src="https://mintcdn.com/traversal-ff380fca/HiU6YBS9FvttONeD/images/slack-traversal-hello.png?fit=max&auto=format&n=HiU6YBS9FvttONeD&q=85&s=5468e025bd68aa1e34d55784f4bf5eef" alt="Traversal responding to a greeting in Slack" width="1084" height="524" data-path="images/slack-traversal-hello.png" />

## Commands

Traversal provides the following slash commands in Slack:

| Command                            | Description                                                                        |
| :--------------------------------- | :--------------------------------------------------------------------------------- |
| `/traversal help`                  | Get documentation and instructions on how to use Traversal in Slack.               |
| `/traversal register-trigger`      | Create a new message trigger or channel join trigger for automatic investigations. |
| `/traversal show-triggers`         | View and delete all triggers configured for your organization.                     |
| `/traversal show-channel-triggers` | View all triggers configured for the current channel.                              |

## Triggers

Triggers let Traversal automatically start investigations when certain conditions are met. There are two types.

### Message triggers

Message triggers fire when a message in a configured channel matches certain conditions — for example, a keyword match or a message from a specific user. Use `/traversal register-trigger` to create one. You'll provide:

* A **channel ID** for the channel to monitor

<Tip>
  To find a channel ID, click on the channel name in Slack to open channel details. The channel ID is near the bottom.
</Tip>

* **Conditions** such as keyword matches or sender filters
* The **type of context** Traversal should pull into the investigation

### Channel join triggers

Channel join triggers fire when Traversal is added to a channel that matches a pattern you define. The pattern can match against the channel **name**, **topic**, or **description** — for example, channels whose name starts with `inci-` or whose topic contains `alert`. If the condition is met when Traversal is added to a channel, we will automatically run an investigation.

You can also specify the context source Traversal pulls into the investigation:

* Channel topic
* Channel description
* Message content
* Message thread content

### Managing triggers

Use `/traversal show-triggers` to view and delete triggers across your organization. Use `/traversal show-channel-triggers` to see only the triggers configured for the current channel.

## DM Traversal

You can message Traversal directly to start an investigation. Open the Traversal app in Slack and send it a message — no need to be in a specific channel.

## Investigation output

When Traversal completes an investigation, it renders the report directly in Slack. The report includes:

* **Citations** with links to the observability sources referenced in the investigation, bringing you directly to the relevant data in your primary observability tool
* A link to **open the investigation in the Traversal UI** for more detail
* A **feedback** option so Traversal can learn about your system over time

## Follow-ups

Tag `@Traversal` in the same thread as an investigation report to ask follow-up questions or trigger additional analysis.

```text theme={null}
@Traversal what services were impacted?
```

```text theme={null}
@Traversal re-run this with the last 6 hours of data
```

## Cross-channel context

Traversal can pull context from any channel it has been added to. You can reference other channels to enrich an investigation or summarize activity across channels — both in channels and in DMs with Traversal.

```text theme={null}
@Traversal please summarize the alerts in #alerts-prod and #alerts-staging over the last 24 hours
```

```text theme={null}
@Traversal summarize the alerts over the last 24 hours in this channel
```

```text theme={null}
@Traversal check #incidents-payments for related issues
```

<Note>
  Traversal can only read channels it has been added to. Make sure Traversal is a member of any channel you want it to reference.
</Note>

## FAQ

<AccordionGroup>
  <Accordion title="I'm tagging @Traversal but it's not responding">
    This likely means your Slack app isn't provisioned correctly. Reach out to a Traversal team member to verify your app is properly set up.
  </Accordion>

  <Accordion title="My message triggers aren't firing investigations">
    Run `/traversal show-channel-triggers` to confirm the trigger is enabled in the intended channel. Note that trigger conditions are case-sensitive — the message content must match your configured conditions exactly.
  </Accordion>

  <Accordion title="Who can set up triggers?">
    Only organization admins can register, view, or delete triggers. If you run `/traversal register-trigger`, `/traversal show-triggers`, or `/traversal show-channel-triggers` and see a message that the command is restricted, ask your admin to configure the trigger for you.
  </Accordion>
</AccordionGroup>