Skip to main content

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.

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

1

Go to the Slack Marketplace

Visit the Traversal Slack app in the Slack Marketplace.
2

Install the app

A Slack workspace administrator installs the Traversal app to your workspace.
3

Contact Traversal for provisioning

Reach out to the Traversal team to correctly provision your Slack app for your organization.
4

Start using Traversal

Once provisioned, you can begin using the Traversal Slack bot in your workspace.

​
BYOC Slack installation

For BYOC customers, Traversal creates a dedicated Slack app for your organization.
1

Request your install link

Contact the Traversal team to receive a custom Slack app installation URL for your organization.
2

Install the app

A Slack workspace administrator opens the provided link and installs the Traversal app to your workspace.
3

Provision with Traversal

Reach out to the Traversal team to provision your app and start using it.

​
Verify it works

Once your app is provisioned, tag @Traversal in any channel it’s been added to and say hello. Traversal responding to a greeting in Slack

​
Commands

Traversal provides the following slash commands in Slack:
CommandDescription
/traversal helpGet documentation and instructions on how to use Traversal in Slack.
/traversal register-triggerCreate a new message trigger or channel join trigger for automatic investigations.
/traversal show-triggersView and delete all triggers configured for your organization.
/traversal show-channel-triggersView 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
To find a channel ID, click on the channel name in Slack to open channel details. The channel ID is near the bottom.
  • 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. 
@Traversal what services were impacted?

@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. 
@Traversal please summarize the alerts in #alerts-prod and #alerts-staging over the last 24 hours

@Traversal summarize the alerts over the last 24 hours in this channel

@Traversal check #incidents-payments for related issues
Traversal can only read channels it has been added to. Make sure Traversal is a member of any channel you want it to reference.

​
FAQ

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.
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.
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.