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

# Slack

> Connect a Slack bot to your Pawz agents.

# Slack

Connect a Slack bot to your Pawz agents.

## Setup

1. Go to [api.slack.com/apps](https://api.slack.com/apps) and create a new app
2. Under **OAuth & Permissions**, add bot token scopes:
   * `chat:write`
   * `channels:history`
   * `im:history`
   * `im:read`
   * `im:write`
3. Install the app to your workspace
4. Copy the **Bot User OAuth Token** (starts with `xoxb-`)
5. In Pawz, go to **Settings → Channels**
6. Select **Slack**
7. Paste your bot token
8. Start the channel

## Configuration

| Field         | Required      | Description              |
| ------------- | ------------- | ------------------------ |
| Bot token     | Yes           | `xoxb-` token from Slack |
| DM policy     | Yes           | Who can message the bot  |
| Allowed users | For allowlist | Slack usernames          |

## Features

* DMs and channel mentions
* Per-user sessions with memory
* Prompt injection scanning
* Agent routing via channel routing rules
* Thread support

## Routing

Route Slack channels or users to specific agents:

* **Channel ID filter** — route messages from specific Slack channels (use the channel ID, not the name)
* **User filter** — route messages from specific Slack users

## Tips

* Invite the bot to channels where you want it to respond: `/invite @YourBot`
* The bot responds when mentioned (`@YourBot`) or in DMs
* Use the Slack skill separately if you want agents to proactively send messages