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

# Slack Settings

> Configure how mixus integrates with your Slack workspace

## Overview

mixus integrates seamlessly with Slack to bring AI-powered assistance directly into your team's conversations. You can control how the integration works, including which organization context the AI uses when responding in Slack.

## Slack Organization Settings

### 🏢 **Workspace Organization Mapping**

If you're an admin, you can map your entire Slack workspace to a specific mixus organization:

1. **Workspace-level mapping** takes priority over individual preferences
2. All team members automatically use the mapped organization
3. Ideal for company-wide Slack installations
4. Optional default space configuration for channels

**Admin Setup:**

* Contact mixus support to map your workspace
* Provide your Slack workspace ID and desired organization
* All messages from your workspace will use this organization

<Callout type="info">
  **Note:** Workspace mapping is managed by mixus administrators. Contact [support@mixus.ai](mailto:support@mixus.ai) to set up your workspace mapping.
</Callout>

### 👤 **Personal Default Organization**

When your workspace isn't mapped to a specific organization, you can set your personal default:

**To set your default Slack organization:**

1. Navigate to your **Account Settings** → **Slack Preferences**
2. In the **Default Organization** section, select from your available organizations
3. Click **Save Preferences**

**Direct Link:** [Slack Settings](https://app.mixus.ai/settings/slack)

### 🔄 **How Organization Selection Works**

When you interact with mixus in Slack, the system determines which organization context to use based on:

1. **Workspace Mapping** - If your Slack workspace is mapped to an organization (highest priority)
2. **Your Default Preference** - The organization you've set in Slack settings
3. **Recent Activity** - Your most recently active organization across all channels
4. **First Organization** - If no recent activity, your first organization is used
5. **Playground** - Guest users and new users are assigned to the playground

<Callout type="success">
  **Pro Tip:** If your company uses Slack extensively, ask your admin to set up workspace mapping for the best experience.
</Callout>

## Slack Integration Features

### 💬 **Channel Integration**

Control how mixus responds in different channel types:

* **Direct Messages**: Always enabled for 1-on-1 conversations
* **Private Channels**: Responds when invited to private channels
* **Public Channels**: Responds when mentioned or in threads
* **App Home**: Access mixus directly from the app home tab

### 🔔 **Notification Settings**

Configure Slack-specific notifications:

* **Response Notifications**: Get notified when AI completes processing
* **Error Alerts**: Receive alerts if something goes wrong
* **Daily Summaries**: Optional daily digest of AI interactions
* **Thread Updates**: Follow-up notifications in active threads

### ⚡ **Response Preferences**

Customize how mixus responds in Slack:

* **Response Speed**: Balance between speed and quality
* **Thread Behavior**: Always reply in thread vs. channel
* **Mention Requirements**: Require @mention to respond
* **Typing Indicators**: Show when mixus is processing

## Advanced Settings

### 🛡️ **Privacy & Permissions**

* **Message Access**: Control which messages mixus can read
* **Data Retention**: How long Slack conversations are stored
* **User Permissions**: Who can interact with mixus in your workspace
* **Channel Restrictions**: Limit mixus to specific channels

### 🔧 **Technical Configuration**

* **Processing Model**: Choose AI model for Slack responses
* **Rate Limiting**: Prevent spam and control costs
* **Error Handling**: Configure error message behavior
* **Slash Commands**: Enable custom slash commands

## Workspace Management

### 👥 **Team Settings** (Admins Only)

* View all team members using mixus
* Set organization-wide defaults
* Manage bot permissions and access
* Configure compliance and audit settings

### 📊 **Usage Analytics**

* Track team usage and adoption
* Monitor most active channels
* Identify power users and use cases
* Export usage reports

## Troubleshooting

### Common Issues

**mixus not responding in Slack:**

* Verify mixus app is installed in your workspace
* Check if mixus has access to the channel
* Ensure you're mentioning @mixus if required
* Confirm your default organization is set

**Wrong organization context:**

* Check if workspace has an organization mapping
* Update your personal default preference
* Verify you have access to the intended organization

**Slow or missing responses:**

* Check Slack workspace connection status
* Verify rate limits haven't been exceeded
* Ensure mixus app permissions are correct
* Check for any ongoing incidents

## Frequently Asked Questions

### How do I install mixus in my Slack workspace?

1. Go to [Slack App Directory](https://slack.com/apps)
2. Search for "mixus"
3. Click "Add to Slack"
4. Authorize the required permissions
5. Start using mixus by mentioning @mixus

### Can different channels use different organizations?

Currently, organization is determined at the workspace or user level. Channel-specific organizations are planned for future releases.

### What happens to guest users in Slack?

Guest users who interact with mixus are automatically created as guest accounts in the playground organization. They can later claim their account for full access.

### Can I use mixus in multiple Slack workspaces?

Yes! You can install mixus in multiple workspaces. Each workspace can have its own organization mapping and settings.

### How secure is the Slack integration?

* All messages are encrypted in transit and at rest
* mixus only stores messages you directly interact with
* Compliance with SOC 2 and GDPR standards
* Regular security audits and penetration testing

## Best Practices

### For Individual Users

1. **Set your default organization** to avoid confusion
2. **Use threads** to keep conversations organized
3. **Be specific** in your requests for better responses
4. **Review permissions** regularly

### For Workspace Admins

1. **Set up workspace mapping** for consistent organization context
2. **Train your team** on best practices
3. **Monitor usage** to optimize settings
4. **Configure channels** appropriately for your use case

## Related Resources

* [Organization Management](/organization/overview) - Learn about managing organizations
* [Slack Integration Guide](/integrations/slack) - Advanced Slack features
* [Team Collaboration](/collaboration/overview) - Working together with mixus
* [Security Settings](/security/overview) - Slack security and compliance

***

**Need help with Slack settings?** Contact [support@mixus.ai](mailto:support@mixus.ai) or type `/mixus help` in any Slack channel.