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

# Slack Channel

> Deploy your agent as a Slack bot or app. DMs and channels supported.

Deploy your agent to Slack for team collaboration.

## Setup

<Steps>
  <Step title="Create Slack App">
    1. Go to [https://api.slack.com/apps](https://api.slack.com/apps)
    2. Click **Create New App**
    3. Choose **From scratch**
    4. Name: agent name
    5. Workspace: your Slack workspace
  </Step>

  <Step title="Configure Permissions">
    1. Go to **OAuth & Permissions**
    2. Add Bot Token Scopes:
       * `chat:write`
       * `channels:read`
       * `groups:read`
       * `im:read`
    3. Install app to workspace
    4. Copy Bot Token (Xoxb-...)
  </Step>

  <Step title="Add Channel to Agent">
    1. **Agents** > Select agent
    2. **Settings** > **Channels**
    3. Click **Add Channel**
    4. Choose **Slack**
    5. Paste bot token
  </Step>

  <Step title="Test">
    1. Add bot to Slack channel or DM
    2. Send message to bot
    3. Verify response
  </Step>

  <Step title="Deploy">
    Toggle **Enabled**. Bot active in workspace.
  </Step>
</Steps>

## Features

* **Direct messages** - One-on-one with users
* **Channel messages** - Bot in public/private channels
* **Threads** - Keep conversations organized
* **Mentions** - Respond when @mentioned
* **File sharing** - Send documents and images
* **4,000 char limit** - Auto-splits long messages

## Channel Types

### Direct Message

Message bot directly. Fastest response time.

### Public Channel

Add bot to channel. Bot responds to all messages or when mentioned.

### Private Channel

Add bot to private channel. Only members can interact.

## Message Threading

Responses automatically create threads:

```
User: "What's the weather?"
Bot: "In San Francisco: 72F, sunny"
  ↳ Response in thread (keeps channel clean)
```

## Rate Limits

Slack workspace rate limits:

* Standard: \~1 message/second
* Enterprise: Higher limits
* Burst: \~10 requests allowed

Noorle queues excess requests automatically.

## Slash Commands

Create custom Slack commands (optional):

```
/agent status
/agent help
/agent analyze {file}
```

Configure in app settings.

## OAuth Scopes

Required scopes:

* `chat:write` - Send messages
* `channels:read` - See channel list
* `groups:read` - See private channels
* `im:read` - See direct messages
* `users:read` - Get user info (optional)

Request only what you need.

## User Identification

Slack identifies users by:

* **User ID** (U12345...)
* **Username** (john.doe)
* **Email** ([john@company.com](mailto:john@company.com))

Agent can personalize based on user info.

## Limitations

* 4,000 character limit
* Can't edit messages (after sent)
* No reactions
* Thread replies only

## Troubleshooting

### Bot not responding

* Check bot token
* Verify app is installed
* Check bot has permissions
* Test in Console first

### Bot not in channel

* Add bot manually to channel
* Check app permissions
* Verify scopes authorized

### Slow responses

* Slack delay (rare)
* Agent processing
* Network latency
* Check usage dashboard

## Privacy

* Messages encrypted (Slack -> Noorle -> Slack)
* User data not stored
* Config as Workspace App (not public)
* Can configure privacy levels

## Cost

For current pricing details, see [Pricing](https://noorle.com/pricing/).

## Next Steps

* [Telegram Channel](/docs/run/channels/telegram)
* [SMS Channel](/docs/run/channels/sms)
* [Creating Agents](/docs/run/agents/creating-an-agent)