> ## 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.

# Discord

> Add the Duckie bot to your Discord server

Add Duckie to your Discord server to provide AI-powered support in your community.

## Capabilities

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

## Setup

### Add Bot to Server

1. Go to **Settings → Connections** in Duckie
2. Find **Discord** and click **Connect**
3. You'll be redirected to Discord
4. Select the server to add Duckie to
5. Review and approve the bot permissions
6. You'll be redirected back to Duckie

<Info>
  You need **Manage Server** permission on the Discord server to add bots.
</Info>

### Bot Permissions

Duckie requests these permissions:

* Read messages and message history
* Send messages
* Add reactions
* Read member information

## Using as a Deployment Trigger

Deploy an agent to Discord:

1. Go to **Deploy**
2. Click **Create Deployment**
3. Select your agent
4. Choose **Discord** 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               |

### Channel Permissions

Ensure Duckie has access to the channels:

1. Go to channel settings in Discord
2. Check that the Duckie role can view and send messages
3. Adjust permissions if needed

## Available Tools

| Tool                   | Description                 |
| ---------------------- | --------------------------- |
| `discord_send_message` | Send a message to a channel |
| `discord_add_reaction` | React to a message          |
| `discord_get_user`     | Get user information        |

## Best Practices

### Create a Dedicated Support Channel

Set up a `#support` or `#help` channel specifically for Duckie:

* Users know where to ask questions
* Keeps other channels clean
* Easy to manage and monitor

### Use @mention in Busy Channels

For active community channels, use **@mention only** mode so Duckie doesn't respond to every message.

### Set Up Roles

Create a Duckie role in Discord with appropriate permissions:

* Can see support channels
* Cannot see private/admin channels

## Example Use Cases

### Community Support

Deploy Duckie to answer common questions in your community server — product questions, troubleshooting, how-tos.

### Developer Documentation Bot

Let developers ask questions about your API or SDK in a `#dev-help` channel.

### Gaming Community

Answer questions about game mechanics, server rules, or events.

## Troubleshooting

### "Bot not responding"

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

### "Missing permissions"

* Go to Server Settings → Roles
* Find the Duckie role and grant needed permissions
* Make sure channel-specific permissions don't override

### "Can't add bot to server"

* You need **Manage Server** permission
* Ask a server admin to add the bot