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

# Slack Connector

> Send review notifications to Slack channels and DMs

The Slack connector allows Humancheck to send rich formatted messages to Slack channels and DMs when reviews are created or decisions are made.

## Setup

### 1. 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 your app (e.g., "Humancheck")
5. Select your workspace

### 2. Add Bot Token Scopes

1. Go to "OAuth & Permissions"
2. Add the following scopes:
   * `chat:write` - Post messages
   * `chat:write.public` - Post to public channels without joining

### 3. Install to Workspace

1. Click "Install to Workspace"
2. Authorize the app
3. Copy the "Bot User OAuth Token" (starts with `xoxb-`)

### 4. Configure Connector

```python theme={null}
from humancheck.connector_manager import ConnectorManager

async with db.session() as session:
    manager = ConnectorManager(session)
    
    # Create Slack connector
    connector = await manager.create_connector(
        connector_type='slack',
        name='Team Slack Workspace',
        config_data={
            'bot_token': 'xoxb-your-bot-token-here'
        }
    )
```

### 5. Invite Bot to Channels

In each Slack channel where you want notifications:

```
/invite @your-bot-name
```

## Creating Routing Rules

```python theme={null}
# Route SQL reviews to #database-team
await manager.routing_engine.create_rule(
    connector_id=connector.id,
    name="SQL Reviews to DB Team",
    conditions={
        "task_type": "sql_execution",
        "urgency": ["high", "critical"]
    },
    recipients=["#database-team"],
    priority=100
)

# Route critical reviews to #urgent-reviews
await manager.routing_engine.create_rule(
    connector_id=connector.id,
    name="Critical Reviews",
    conditions={
        "urgency": "critical"
    },
    recipients=["#urgent-reviews", "@oncall"],
    priority=200
)
```

## Notification Format

Slack notifications include:

* Review title and description
* Urgency indicator
* Proposed action
* Dashboard link
* Quick actions (if configured)

## Next Steps

* Learn about [Custom Connectors](/connectors/custom-connectors)
* Explore [Routing Rules](/configuration/routing-rules)