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

# Slack Integration

> Send alerts and notifications to Slack channels

# Slack Integration

Connect Roboticks to your Slack workspace to receive real-time alerts, deployment notifications, and device status updates directly in your channels.

## Features

* Real-time alert notifications with severity indicators
* Interactive buttons to acknowledge/resolve alerts directly from Slack
* Slash commands for quick status checks (`/roboticks status`, `/roboticks alerts`)
* Rich message formatting with device details and metrics
* Customizable channel routing for different alert types
* Direct message notifications to specific team members

## Setup

### Step 1: Install the Slack App

1. Go to **Settings** > **Integrations** in Roboticks
2. Find **Slack** and click **Add to Slack**
3. You'll be redirected to Slack to authorize the app

<Note>
  If you have multiple Slack workspaces, select the one where you want to receive Roboticks notifications.
</Note>

### Step 2: Authorize Permissions

Review and approve the permissions requested by the Roboticks app:

* **Post messages** - Send alerts and notifications to channels
* **Respond to commands** - Handle `/roboticks` slash commands
* **Access workspace info** - List channels for routing configuration

Click **Allow** to complete the installation.

### Step 3: Configure Channels

After installation, configure which channels receive notifications:

1. Return to the Slack integration in Roboticks
2. Set the **Default Channel** (e.g., `#alerts`)
3. Optionally configure per-severity routing

## Configuration Options

| Option             | Description                                             |
| ------------------ | ------------------------------------------------------- |
| Default Channel    | Channel for all notifications (override per alert type) |
| Enabled            | Toggle the integration on/off                           |
| Enabled for Alerts | Receive alert notifications                             |

## Slash Commands

Once installed, team members can use these commands in Slack:

| Command             | Description                      |
| ------------------- | -------------------------------- |
| `/roboticks status` | Show current device fleet status |
| `/roboticks alerts` | List recent active alerts        |
| `/roboticks help`   | Show available commands          |

## Alert Message Format

Slack alerts include:

```
🔴 Critical Alert: Device Offline

Device: warehouse-robot-01
Status: Offline since 10:23 AM
Last Session: ws-123456

[View Device] [Acknowledge] [Mute]
```

## Troubleshooting

<AccordionGroup>
  <Accordion title="Not receiving notifications">
    * Verify the integration is enabled
    * Check the default channel exists and the bot has access
    * Review integration logs for delivery errors
  </Accordion>

  <Accordion title="Can't find the channel">
    The Roboticks bot needs to be invited to private channels:

    ```
    /invite @Roboticks
    ```
  </Accordion>

  <Accordion title="Slash commands not working">
    * Ensure the Slack app is installed in your workspace
    * Check that slash commands were authorized during setup
    * Try reinstalling the app
  </Accordion>

  <Accordion title="Reconnect after workspace changes">
    If your Slack workspace settings change, you may need to reauthorize:

    1. Remove the integration in Roboticks
    2. Click **Add to Slack** again
    3. Complete the authorization flow
  </Accordion>
</AccordionGroup>

## Security

* OAuth tokens are encrypted at rest
* Tokens can be revoked at any time from Slack's App Management
* Roboticks only requests minimum required permissions
* All communication uses TLS encryption