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

# Slack

> Team messaging and collaboration

## Overview

Slack is TierZero's primary communication channel. The integration enables TierZero to participate in incident channels, respond to questions, deliver investigation findings, and interact with your team directly where they work.

## Prerequisites

* Administrative access to your Slack workspace
* Permission to install Slack apps

## Setup Instructions

### Step 1: Navigate to Integration Settings

1. Log into your TierZero dashboard
2. Go to **Settings → Integrations**
3. Click **Connect** next to Slack

### Step 2: Install the Slack App

1. Click **Add to Slack**
2. You'll be redirected to Slack to authorize the installation
3. Review the permissions and click **Allow**
4. You'll be redirected back to TierZero

The integration should now show as connected.

## Permissions

The TierZero Slack App requests the following permissions:

### Communication & Responses

* **App mentions**: Respond to @TierZero mentions in channels
* **Send messages**: Post investigation findings and responses
* **Customize messages**: Respond with custom formatting
* **Slash commands**: Enable `/remember` to save context and preferences

### Channel Access

* **Join public channels**: Investigate incidents and gather context
* **Read public channels**: Access channel messages for investigation
* **Access channel history**: Gather historical context for investigations
* **Read and write to private channels**: Full functionality in private alert and incident channels

### Direct Messages & Groups

* **Read and write direct messages**: Interact with TierZero via DM
* **Read multi-party DMs**: Support group conversations with TierZero

### Context & Investigation

* **Read message metadata**: Gather context from message metadata
* **Read pinned messages**: Access pinned runbooks and important messages
* **Read and write files**: Download attachments for context, upload investigation findings

### Feedback & User Management

* **Read and add reactions**: Gather thumbs-up/down feedback, acknowledge requests with reactions
* **Read user information and groups**: Triage issues to the correct person or team

## What TierZero Uses Slack For

* **Incident Agent**: Auto-joins incident channels, posts real-time findings
* **Alert Agent**: Delivers investigation results to configured channels
* **Support Agent**: Monitors ask channels and answers questions
* **Digest Agent**: Posts scheduled reports to team channels
* **Copilot**: Interactive conversations via DM or in-channel mentions

## Security

* TierZero follows Slack's OAuth 2.0 authorization flow
* Access can be revoked at any time from your Slack workspace settings (**Settings → Manage Apps**)
* All communication is encrypted in transit

## Troubleshooting

### TierZero Not Responding in a Channel

* Ensure TierZero has been invited to the channel (for private channels)
* Check that no Slack trigger filters are excluding the channel
* Verify the Slack integration is still connected in **Settings → Integrations**

### Missing Message History

* TierZero can only access message history after being added to a channel
* For private channels, TierZero must be explicitly invited