> For the complete documentation index, see [llms.txt](https://ap-buddy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ap-buddy.gitbook.io/docs/getting-started/discord-bot-guide.md).

# Discord Bot Guide

## Setting Up a Discord Bot for Webhooks & Commands

This guide walks you through creating a Discord bot, getting its token, and configuring it to send messages and receive commands in your server.

***

### Step 1: Create a Discord Bot

1. Go to the [Discord Developer Portal](https://discord.com/developers/applications).
2. Click **New Application** in the top-right.
3. Name your bot (e.g., *AP Buddy Bot*).
4. Click **Create** to proceed.
5. *(Optional)* Set an avatar for your bot.

***

### Step 2: Get the Bot Application ID and Token

1. On the **General Information** tab, copy the **Application ID** and save it for later (or add it to your AP Buddy config).
2. On the **Bot** tab, scroll to the **Token** section.
3. Click **Reset Token**, then copy and save it (or add it to your AP Buddy config).

⚠️ **Warning:** Never share your bot token! If leaked, reset it immediately.

***

### Step 3: Set Up the Bot's Permissions

Your bot needs permissions to send messages.

1. Go to the **OAuth2 → URL Generator** tab.
2. Under **Scopes**, select:
   * `bot`
3. Under **Bot Permissions**, check:
   * Send Messages
   * Embed Links
4. Copy the generated OAuth2 URL.
5. Open it in your browser and invite the bot to your Discord server.

***

### Step 4: Get a Discord Channel ID

AP Buddy needs a channel ID to know where to send messages.

1. In Discord, go to **User Settings → Advanced**.
2. Enable **Developer Mode**.
3. Right-click the channel you want AP Buddy to use.
4. Click **Copy Channel ID**.
5. Save it for AP Buddy's configuration.

***

### Step 5: Get a Discord Server ID

AP Buddy also needs a server ID for command permissions.

1. In Discord, right-click the server icon where you added your AP Buddy bot.
2. Click **Copy Server ID**.
3. Save it for later (or add it to your AP Buddy config).

***

### You're Done!

Configure AP Buddy with the Application ID, Token, Channel ID, and Server ID, and start using it!