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

# Slack

> Connect Calmo to your Slack workspace for comprehensive team communication and collaboration through AI assistance

# Slack Integration

Integrate Calmo with your Slack workspace to transform how your team handles production incidents, alerts, and collaborative troubleshooting. This integration provides access to **8 specialized tools** across **4 categories** for complete team communication workflows.

## Overview & Value Proposition

The Slack integration transforms how your team handles incidents and collaboration by providing:

* **Engineer-Level Debugging** - AI brings senior engineer expertise directly into your Slack channels
* **Real-Time Incident Response** - Automatic alert analysis and comprehensive RCA in under 60 seconds
* **Intelligent Communication** - Context-aware messaging, channel management, and user interaction
* **Seamless Workflow Integration** - Native Slack tools for channel discovery, message history, and thread management
* **Reduced Alert Fatigue** - Automated routine investigations with human escalation when needed
* **Knowledge Preservation** - Historical context maintenance across incidents for pattern recognition

## Key Capabilities

When connected, Calmo gains access to **8 Slack tools** across **4 categories**:

| Category               | Tools   | Capability                                      |
| ---------------------- | ------- | ----------------------------------------------- |
| **Channel Management** | 1 tool  | Discover and manage workspace channels          |
| **Messaging**          | 3 tools | Send messages, reply to threads, add reactions  |
| **Data Retrieval**     | 2 tools | Access channel history and thread conversations |
| **User Management**    | 2 tools | Identify users and access profile information   |

## Prerequisites

* Slack workspace with admin permissions for app installation
* Appropriate workspace permissions for target channels
* Calmo account with team or personal workspace

## Setup Process

### Step 1: OAuth Connection (Recommended)

**Quick and secure workspace integration**

1. Navigate to **Integrations** in your Calmo dashboard
2. Click **Slack** integration
3. Choose **Connect with Slack**
4. Review and customize tool permissions:
   * ✅ **Read-only operations** enabled by default
   * ❌ **Write operations** disabled for safety
5. Click **Add to Slack**
6. Authorize Calmo in Slack OAuth flow
7. Select channels to grant access (optional)

### Step 2: Channel Configuration

**After connection, configure channel access:**

1. **Invite @Calmo** to relevant channels where you want AI assistance
2. **Set channel preferences** for automated responses vs manual triggers
3. **Configure notification settings** for different alert types
4. **Test integration** with a simple mention: `@Calmo help`

## Tool Categories & Configuration

### 📋 Channel Management (Safe)

**Default: Enabled** - Essential for workspace navigation

* **slack\_list\_channels** - Discover available channels and their metadata

*Use Cases: Channel discovery, workspace organization, access management, bot deployment planning*

### 💬 Messaging (Write Operations)

**Default: Disabled** - Direct communication capabilities

* **slack\_post\_message** - Send messages to channels (⚠️ Write operation)
* **slack\_reply\_to\_thread** - Reply to existing message threads (⚠️ Write operation)
* **slack\_add\_reaction** - Add emoji reactions to messages (⚠️ Write operation)

*Use Cases: Automated incident updates, RCA delivery, alert acknowledgments, status communication*

### 📚 Data Retrieval (Safe)

**Default: Enabled** - Historical context and conversation access

* **slack\_get\_channel\_history** - Retrieve channel message history with filtering
* **slack\_get\_thread\_replies** - Access complete thread conversations

*Use Cases: Incident timeline reconstruction, context gathering, troubleshooting history, pattern analysis*

### 👥 User Management (Safe)

**Default: Enabled** - Team member identification and interaction

* **slack\_get\_users** - List workspace members and their information
* **slack\_get\_user\_profile** - Access detailed user profiles and contact information

*Use Cases: Team identification, escalation routing, expertise location, contact management*

## Integration Workflows

### Automated Incident Response

**Real-Time Alert Analysis:**

1. **Alert Detection** - Calmo monitors configured channels for alerts
2. **Immediate Analysis** - Comprehensive investigation begins automatically
3. **RCA Delivery** - Detailed root cause analysis delivered in under 60 seconds
4. **Thread Management** - Organized discussion threads for incident resolution
5. **Status Updates** - Automated status communication to stakeholders

### Manual Investigation Support

**On-Demand Assistance:**

1. **@Calmo Mention** - Trigger AI analysis with direct mentions
2. **Context Gathering** - Automatic channel history and thread analysis
3. **Expert Investigation** - Senior engineer-level debugging approach
4. **Collaborative Resolution** - Interactive problem-solving with team members

### Knowledge Management

**Continuous Learning:**

* **Pattern Recognition** - Identify recurring issues across incidents
* **Historical Analysis** - Learn from past incident responses
* **Team Training** - Educational insights for junior team members
* **Documentation** - Automatic incident documentation and knowledge base updates

## Team vs Personal Configuration

### Team/Organization Setup

* Organization-wide Slack workspace integration
* Shared channel access and monitoring configurations
* Team-level escalation policies and notification settings
* Administrators control messaging and response permissions

### Personal Setup

* Individual workspace connections (for multiple workspaces)
* Personal channel preferences and notification settings
* Private direct message capabilities with Calmo
* Individual tool access and permission controls

## Security & Best Practices

### ⚠️ Safety Recommendations

1. **Read-First Approach** - Begin with read-only tools, add messaging capabilities gradually
2. **Channel Scope** - Invite Calmo only to relevant channels initially
3. **Permission Auditing** - Regularly review channel access and tool permissions
4. **Response Policies** - Establish clear guidelines for automated vs manual responses
5. **Escalation Procedures** - Define when to escalate from AI to human intervention

### 🔒 Permission Levels

| Risk Level | Operations                                 | Recommendation                |
| ---------- | ------------------------------------------ | ----------------------------- |
| **Low**    | List channels, read history, get user info | ✅ Safe to enable              |
| **Medium** | Add reactions, reply to threads            | ⚠️ Enable with review         |
| **High**   | Post messages to channels                  | ⚠️ Enable only when necessary |

## Advanced Features

### Intelligent Channel Monitoring

* **Multi-Channel Support** - Monitor multiple channels simultaneously
* **Context Switching** - Maintain separate conversation contexts per channel
* **Alert Correlation** - Cross-reference alerts across different channels
* **Priority Detection** - Automatic identification of high-priority incidents

### Real-Time Collaboration

* **Thread Organization** - Structured incident response threads
* **Expert Summoning** - Intelligent escalation to relevant team members
* **Status Broadcasting** - Automated status updates to stakeholder channels
* **Resolution Tracking** - Follow incident resolution to closure

### Workspace Integration

* **Bot User Management** - Comprehensive bot user identity and permissions
* **Custom Emoji Support** - Leverage workspace-specific emoji for reactions
* **Channel Archival** - Access to archived channel history when needed
* **Cross-Workspace Support** - Multiple workspace connections for large organizations

## Configuration Management

### Updating Slack Integration

1. Navigate to **Integrations** → **Slack**
2. Click **Edit Configuration**
3. Modify tool permissions and channel access
4. Update notification preferences and response settings
5. Test changes with low-risk operations
6. Save configuration changes

### Managing Channel Access

* **Add Channels** - Invite @Calmo to additional channels as needed
* **Remove Access** - Remove Calmo from channels when no longer needed
* **Permission Review** - Regular audits of channel access and capabilities
* **Workspace Policies** - Align with organization Slack governance policies

## Troubleshooting

### Common Issues

**Bot Not Responding**

* Verify @Calmo is invited to the channel
* Check that messaging tools are enabled in integration settings
* Ensure proper workspace permissions for the bot user

**Missing Channel History**

* Confirm Calmo was invited before the messages you're trying to access
* Check that data retrieval tools are enabled
* Verify channel permissions allow history access

**Permission Denied**

* Review Slack workspace app permissions
* Check individual channel permissions for the bot user
* Ensure OAuth scopes include required permissions

### Getting Help

1. **Test Commands** - Use `@Calmo help` to verify basic functionality
2. **Reconnect Integration** - Use reconnection flow to refresh permissions
3. **Contact Support** - Reach out to [support@getcalmo.com](mailto:support@getcalmo.com) for assistance

## Best Practices for Teams

### Incident Response Setup

1. **Dedicated Channels** - Create specific channels for incident response
2. **Clear Escalation** - Define when to escalate from AI to human experts
3. **Documentation Standards** - Establish consistent incident documentation
4. **Training Programs** - Regular team training on AI-assisted workflows

### Operational Excellence

* **Monitor AI Performance** - Track response quality and accuracy
* **Feedback Loops** - Provide feedback to improve AI responses
* **Process Optimization** - Continuously improve incident response workflows
* **Knowledge Sharing** - Leverage AI insights for team learning

The Slack integration provides comprehensive incident response and team collaboration capabilities, enabling your team to handle production issues efficiently through AI-powered assistance while maintaining human oversight and control.

***

*For assistance with setting up Calmo in your Slack workspace, contact our support team at [support@getcalmo.com](mailto:support@getcalmo.com).*