Complete Guide: Discord Integration with Core DKP

Discord integration allows your guild to get the most out of Core DKP: sync members automatically, bulk import players, configure notifications, and keep everyone informed about raids and auctions. This guide walks you through setting up each feature step by step.

Prerequisites

Before you begin, you need:

• Core DKP account with a guild created
• Login with Discord — sign in using "Sign in with Discord" (not just email/password)
• Administrator permission on the Discord server you want to connect
• Professional plan (Discord integration is available on this plan)

1. Invite the Bot to Your Server

The first step is to add the Core DKP bot to your Discord server.

1. Go to Settings in your guild's admin panel
2. Open the Discord tab
3. Click "Invite Bot to Server"
4. Select your guild's Discord server
5. Authorize the requested permissions

The bot needs permissions to read members, roles, and send messages. Without it, import and sync will not work.

2. Connect the Discord Server

After inviting the bot, link the server to your guild:

1. In Settings > Discord, find the "Connect Discord Server" section
2. Click "Reload" to list servers where you are an administrator
3. Select your guild's server from the dropdown
4. Click "Connect Server"

Once connected, Core DKP recognizes your Discord server and allows member import and integration setup.

Tip: If no servers appear, make sure you logged in with Discord and have administrator permission on at least one server.

3. Import Members from Discord

Bulk import avoids manually adding members:

1. Go to Members in the admin panel
2. Click "Import from Discord"
3. Wait for the member list from your server to load
4. Use search to filter by name or email
5. Select the members you want to import (or "Select All")
6. Configure role mapping (see section below)
7. Click "Import Selected"

Imported members will receive an invite to register on Core DKP. They need to create an account (or link an existing one) to appear in the guild.

Role Mapping

Role mapping defines which Discord role corresponds to which guild function:

• Member — regular member
• Officer — officer with management permissions

You can map each Discord role individually. Members without a mapped role receive the default role defined in settings.

4. Configure Webhook for Notifications

The webhook sends automatic messages to a Discord channel when important events occur.

Create the Webhook in Discord

1. In Discord, go to the channel where you want notifications
2. Right-click the channel > Edit Channel
3. Integrations tab > Webhooks > New Webhook
4. Give it a name (e.g., "Core DKP Notifications")
5. Copy the Webhook URL

Configure in Core DKP

1. In Settings > Discord, scroll to "Webhook and Notifications"
2. Paste the webhook URL in the field
3. Enable the notifications you want:
   • Raid created — when a new raid is registered
   • Auction started — when an auction begins
   • Auction ended — when an auction finishes
4. Click "Save Webhook"
5. Use "Send Test" to verify it works

5. Profile Sync

When you connect your account to Discord, Core DKP can sync:

• Nickname — the name you use on the Discord server
• Avatar — your profile picture (when available)

This helps keep consistency between Discord and Core DKP, especially in large guilds.

Feature Summary

Troubleshooting

"No servers found"

• Log in with Discord (not just email)
• Make sure you are an administrator of at least one server
• Try logging out and back in

"Error importing members"

• Confirm the bot was invited and is in the server
• Check that the server is connected in Settings
• Reload the page and try again

"Webhook not sending messages"

• Confirm the URL is correct and complete
• Check that the webhook still exists in Discord (wasn't deleted)
• Use "Send Test" to diagnose

Portuguese version: Guia de Integração Discord