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

# Slack

> Connect Slack for real-time messaging with Duckie

Connect Slack to let Duckie respond to messages in channels and DMs.

## Capabilities

| Capability             | Supported                      |
| ---------------------- | ------------------------------ |
| **Knowledge Source**   | ✓ Search message history       |
| **Deployment Trigger** | ✓ Respond to messages          |
| **Tool Actions**       | ✓ Send messages, react, search |

## Setup

### Connect via OAuth

1. Go to **Settings → Connections** in Duckie
2. Find **Slack** and click **Connect**
3. You'll be redirected to Slack to authorize
4. Select the workspace to connect
5. Review and approve the permissions
6. You'll be redirected back to Duckie

### Permissions Granted

Duckie requests these bot permissions:

* Read messages in channels it's added to
* Send messages and reactions
* Read user profiles
* Access files shared in conversations

## Using as a Deployment Trigger

Deploy an agent to Slack:

1. Go to **Deploy**
2. Click **Create Deployment**
3. Select your agent
4. Choose **Slack** as the trigger
5. Configure the trigger:

### Trigger Options

| Option            | Description                             |
| ----------------- | --------------------------------------- |
| **Channels**      | Specific channels to monitor            |
| **@mention only** | Only respond when @Duckie is mentioned  |
| **All messages**  | Respond to every message in the channel |
| **DMs**           | Respond to direct messages              |

### Channel Setup

After creating a deployment, invite Duckie to the channels:

1. Go to the Slack channel
2. Type `/invite @Duckie` or add from channel settings
3. Duckie will now receive messages in that channel

## Available Tools

| Tool                    | Description                         |
| ----------------------- | ----------------------------------- |
| `slack_send_message`    | Send a message to a channel or user |
| `slack_add_reaction`    | Add an emoji reaction               |
| `slack_search_messages` | Search message history              |
| `slack_get_user`        | Get user profile information        |
| `slack_upload_file`     | Share a file                        |

## Using as Knowledge Source

Search your Slack history for context:

1. Go to **Train → Knowledge**
2. Click **Add Source**
3. Select **Slack**
4. Choose which channels to index
5. Click **Start Sync**

<Warning>
  Slack message history requires a paid Slack plan for full access.
</Warning>

## Best Practices

### Use @mention Mode for Busy Channels

In high-traffic channels, set the trigger to **@mention only** so Duckie only responds when directly asked.

### Create Dedicated Support Channels

Consider creating channels like `#ask-duckie` where customers or team members can ask questions.

### Thread Responses

Duckie responds in threads by default to keep channels organized.

## Example Use Cases

### Internal IT Helpdesk

Deploy an agent to `#it-help` that answers common IT questions using your internal documentation.

### Customer Support (Slack Connect)

If you use Slack Connect for customer support, deploy Duckie to those shared channels.

### Team Knowledge Bot

Create a `#ask-anything` channel where employees can ask questions about company policies, processes, and tools.

## Troubleshooting

### "Duckie not responding"

* Verify Duckie is invited to the channel
* Check if the deployment is in **Live** mode
* Ensure the trigger matches (@mention vs all messages)

### "Missing message history"

* Duckie can only see messages after it was added to the channel
* Historical search requires the Slack knowledge source to be synced

### "Permission denied"

* The workspace admin may need to approve Duckie
* Re-authenticate if permissions changed