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

# Slash commands

> Use the /rav, /help, or /support slash commands in Slack to create tickets, assign work, update status, and manage Ravenna requests from your conversations.

Ravenna's `/rav` slash command brings complete ticket management directly into your Slack workflow. Create tickets, assign work, track progress, and manage channels without leaving your conversation.

<Info>
  You can also type `/help` or `/support` anywhere in Slack as a shortcut to start the ticket creation flow. Both are aliases for `/rav` and accept the same subcommands and natural language, making Ravenna easy to discover for new teammates.
</Info>

## Overview

<CardGroup cols={2}>
  <Card title="Natural language" icon="languages">
    Type commands naturally and AI understands your intent to execute the right action.
  </Card>

  <Card title="Create tickets" icon="plus">
    Create tickets with a guided modal that respects channel configuration and forms.
  </Card>

  <Card title="Manage tickets" icon="check">
    Assign, resolve, close, and edit tickets with simple commands.
  </Card>

  <Card title="Track work" icon="eye">
    View your tickets, approvals, requests, and followed items instantly.
  </Card>

  <Card title="Context-aware" icon="brain">
    Commands adapt based on whether you're in a connected channel, triage channel, or DM.
  </Card>

  <Card title="Channel management" icon="link">
    Connect channels and check connection details directly from Slack.
  </Card>
</CardGroup>

## `/help` and `/support` shortcuts

`/help` and `/support` are top-level shortcuts that open the same ticket creation flow as `/rav`. Use whichever command is most memorable for your team when you want to ask Ravenna for help without remembering the `/rav` prefix.

```text wrap theme={"system"}
/help
/help I can't access Salesforce
/help create
/support
/support my laptop won't connect to Wi-Fi
/support mine
```

When you run `/help` or `/support` with no arguments, Ravenna opens the guided ticket creation modal — the same experience as `/rav`. When you include text, Ravenna uses it as the description for a new ticket. Subcommands like `create`, `mine`, `assign`, and `connect` also work after either shortcut.

<Note>
  `/help` and `/support` follow the same [context-aware behavior](#context-aware-behavior) as `/rav`. The channel, triage channel, or DM you run it in determines workspace and channel selection.
</Note>

## Context-aware behavior

The `/rav` command adapts based on where you use it.

<AccordionGroup>
  <Accordion title="Connected channels" icon="hashtag" defaultOpen>
    In a Slack channel connected to a Ravenna <Tooltip headline="Channels" tip="Channels organize tickets by team, topic, or workflow. Each channel has its own settings, integrations, and routing rules." cta="Learn about Channels" href="/documentation/platform/channels">channel</Tooltip>:

    * Creating tickets uses the channel's configuration automatically
    * Number-only ticket IDs work (uses channel's prefix)
    * Ticket lists show only tickets from that channel
    * All commands are available
  </Accordion>

  <Accordion title="Triage channels" icon="filter">
    In a <Tooltip headline="Triage channel" tip="A triage channel is a dedicated Slack channel where all new tickets from your workspace are mirrored for centralized monitoring." cta="Learn about triage channels" href="/documentation/tickets/slack/triage-channel">triage channel</Tooltip>:

    * Creating tickets shows workspace and channel selector
    * Full ticket IDs required (with prefix)
    * Ticket lists show all workspace tickets
    * All commands are available
  </Accordion>

  <Accordion title="DMs" icon="message-square">
    In direct messages with Ravenna:

    * Creating tickets shows workspace and channel selector
    * Ticket views require workspace context
    * Limited to personal ticket views
    * Channel management commands not available
  </Accordion>

  <Accordion title="Unconnected channels" icon="link-slash">
    In channels not connected to Ravenna:

    * Creating tickets shows workspace and channel selector
    * Use `/rav connect` to set up the channel
    * Full ticket IDs required for actions
  </Accordion>
</AccordionGroup>

## Using slash commands

Type `/rav` (or `/help` / `/support`) in any Slack channel or DM to access Ravenna commands. You can use exact command syntax or natural language.

<Tabs>
  <Tab title="Natural language">
    Ravenna understands natural language, so you can type commands conversationally.

    ```text wrap theme={"system"}
    /rav show me my tickets
    /rav create a new ticket
    /rav assign BUGZ-123 to me
    /rav what's the status of ticket 456
    /rav resolve SUPP-789
    /rav connect this channel
    ```

    <Info>
      AI intent detection makes commands intuitive. Just describe what you want to do.
    </Info>
  </Tab>

  <Tab title="Exact syntax">
    For faster execution, use exact command syntax.

    ```text wrap theme={"system"}
    /rav mine
    /rav create
    /rav assign BUGZ-123
    /rav status 456
    /rav resolve SUPP-789
    /rav connect
    ```
  </Tab>
</Tabs>

## Create tickets

Create tickets with a guided modal that respects your channel's configuration.

<AccordionGroup>
  <Accordion title="Create ticket" icon="plus" defaultOpen>
    Create a new ticket with a guided modal.

    ```text wrap theme={"system"}
    /rav create
    ```

    Opens a modal where you can:

    * Select workspace and channel (if not in a connected channel)
    * Choose <Tooltip headline="Forms" tip="Forms customize the ticket creation experience with structured fields, validation, and conditional logic." cta="Learn about forms" href="/documentation/tickets/forms/overview">form</Tooltip> (if configured)
    * Fill in ticket details
    * Add tags and assignees

    The modal respects your channel's form configuration and automatically applies channel-specific settings.
  </Accordion>
</AccordionGroup>

## Manage tickets

Take action on tickets with these commands.

<AccordionGroup>
  <Accordion title="Assign ticket" icon="user-plus" defaultOpen>
    Assign a ticket to yourself.

    ```text wrap theme={"system"}
    /rav assign TICKET-123
    /rav assign 123
    ```

    <Note>
      Use the full ticket ID (`BUGZ-123`) or just the number (`123`) if you're in the ticket's channel.
    </Note>
  </Accordion>

  <Accordion title="Resolve ticket" icon="check">
    Mark a ticket as resolved.

    ```text wrap theme={"system"}
    /rav resolve TICKET-123
    /rav resolve 123
    ```

    Changes the ticket status to resolved and notifies relevant users.
  </Accordion>

  <Accordion title="Close ticket" icon="x">
    Mark a ticket as closed.

    ```text wrap theme={"system"}
    /rav close TICKET-123
    /rav close 123
    ```

    Changes the ticket status to closed and archives the conversation.
  </Accordion>

  <Accordion title="Edit ticket" icon="pencil">
    Open a modal to edit ticket details.

    ```text wrap theme={"system"}
    /rav edit TICKET-123
    /rav edit 123
    ```

    Allows you to update:

    * Title and description
    * Priority
    * Tags
    * Assignee
  </Accordion>

  <Accordion title="Check status" icon="info">
    View detailed ticket information.

    ```text wrap theme={"system"}
    /rav status TICKET-123
    /rav status 123
    ```

    Shows ticket details with action buttons for quick updates.
  </Accordion>
</AccordionGroup>

## Track tickets

View and track tickets with these commands.

<AccordionGroup>
  <Accordion title="My tickets" icon="user" defaultOpen>
    View tickets assigned to you.

    ```text wrap theme={"system"}
    /rav mine
    ```

    Shows up to 5 tickets. If you have more, you'll get a link to view all in the web portal.
  </Accordion>

  <Accordion title="My approvals" icon="clipboard-check">
    View tickets awaiting your approval.

    ```text wrap theme={"system"}
    /rav approvals
    ```
  </Accordion>

  <Accordion title="My requests" icon="inbox">
    View tickets you created.

    ```text wrap theme={"system"}
    /rav requests
    ```
  </Accordion>

  <Accordion title="Followed tickets" icon="bookmark">
    View tickets you're following.

    ```text wrap theme={"system"}
    /rav followed
    ```
  </Accordion>

  <Accordion title="Open tickets" icon="folder-open">
    View all open tickets in the current channel.

    ```text wrap theme={"system"}
    /rav open
    ```

    <Info>
      Only works in connected channels or triage channels.
    </Info>
  </Accordion>

  <Accordion title="Today's work" icon="calendar">
    View tickets due today.

    ```text wrap theme={"system"}
    /rav today
    ```
  </Accordion>
</AccordionGroup>

## Manage channels

Manage your Slack channel connection and check details.

<AccordionGroup>
  <Accordion title="Connect channel" icon="link" defaultOpen>
    Connect the current Slack channel to a Ravenna channel.

    ```text wrap theme={"system"}
    /rav connect
    ```

    Shows instructions for connecting the Slack channel to a Ravenna channel. This enables automatic ticket creation and channel-specific configuration.

    <Info>
      You can also use `/invite @ravenna` to add Ravenna to a Slack channel.
    </Info>
  </Accordion>

  <Accordion title="Channel info" icon="info">
    View connection details for the current channel.

    ```text wrap theme={"system"}
    /rav info
    ```

    Shows:

    * Connected channel name
    * Workspace name
    * Organization name
    * Channel type (connected, triage, or unconnected)
  </Accordion>
</AccordionGroup>

## Ticket identifier formats

Ravenna supports multiple ticket identifier formats for flexibility.

| Format                | Example        | Description                                         |
| --------------------- | -------------- | --------------------------------------------------- |
| Full ID               | `BUGZ-123`     | Channel prefix + ticket number                      |
| Full ID with short ID | `BUGZ-123-abc` | Includes unique short identifier                    |
| Number only           | `123`          | Works in connected channels (uses channel's prefix) |

<Info>
  When using number-only format, you must be in the ticket's channel or triage channel.
</Info>

## Help

Get help with commands directly in Slack.

```text wrap theme={"system"}
/rav help
```

Shows an interactive help menu with:

* Quick action buttons
* Command categories
* Links to documentation