Discord Integration

Discord Integration

Bring your knowledge base into Discord communities with an AI-powered bot, slash commands, and server history sync.

Features

Prerequisites

• Discord account with Manage Server permissions
• Discord Developer Portal access
• LH42 organization with Discord integration enabled

Setup

Step 1: Create Discord Application

1. Go to Discord Developer Portal
2. Click New Application
3. Name it (e.g., "LH42 Assistant")
4. Note the Application ID and Public Key from General Information

Step 2: Create Bot User

1. Go to Bot section in your application
2. Click Add Bot
3. Configure bot settings:

- Disable Public Bot (unless you want anyone to add it)

- Enable Message Content Intent (required for reading messages)

- Enable Server Members Intent (for user resolution)

1. Click Reset Token and copy the Bot Token

Step 3: Configure OAuth2 & Permissions

1. Go to OAuth2 > URL Generator
2. Select scopes:

- \bot\

- \applications.commands\

1. Select bot permissions:

- Read Messages/View Channels

- Send Messages

- Send Messages in Threads

- Embed Links

- Attach Files

- Read Message History

- Add Reactions

- Use Slash Commands

1. Copy the generated URL

Step 4: Invite Bot to Server

1. Open the OAuth2 URL in your browser
2. Select your Discord server
3. Authorize the permissions
4. Bot appears in your server

Step 5: Configure in LH42

1. Go to Settings > Integrations > Discord
2. Enter your Discord credentials:

\\\`python

client.integrations.discord.configure({

"application_id": "your-application-id",

"public_key": "your-public-key",

"bot_token": "your-bot-token", # Encrypted at rest

"guild_ids": ["your-server-id"] # Optional: limit to specific servers

})

\\\`

Step 6: Register Slash Commands

\\\`bash

# Commands are auto-registered, or manually:

POST /api/integrations/discord/commands/register

\\\`

Using the Bot

Slash Commands

\\\`

/ask query:What is our refund policy?

/search query:quarterly report 2024

/summarize url:https://docs.example.com/guide

\\\`

Response includes:

• AI-generated answer
• Source citations with links
• Feedback buttons (👍/👎)

@Mentions

\\\`

@LH42 Can you explain our deployment process?

\\\`

Thread Conversations

The bot maintains context in threads:

\\\`

User: @LH42 What's our vacation policy?

LH42: Based on the Employee Handbook, you get 20 days PTO...

User: Does that include sick days?

LH42: No, sick days are separate. You have unlimited sick days...

\\\`

Data Ingestion

What Gets Indexed

Sync Configuration

\\\`python

client.connectors.configure("discord", {

"settings": {

"guild_ids": ["123456789"], # Server IDs to sync

"channel_ids": ["456789123"], # Optional: specific channels

"include_threads": True,

"include_forums": True,

"include_files": True,

"lookback_days": 90,

"sync_schedule": "0 */4 * * *" # Every 4 hours

}

})

\\\`

Embed Responses

Responses use Discord embeds for rich formatting:

\\\`json

{

"embeds": [{

"title": "Here's what I found",

"description": "Based on the Employee Handbook...",

"color": 5814783,

"fields": [

{

"name": "📄 Sources",

"value": "Employee Handbook • PTO Policy"

}

],

"footer": {

"text": "Powered by LH42"

}

}],

"components": [{

"type": 1,

"components": [

{"type": 2, "style": 2, "label": "👍 Helpful", "custom_id": "feedback_positive"},

{"type": 2, "style": 2, "label": "👎 Not helpful", "custom_id": "feedback_negative"}

]

}]

}

\\\`

Webhook Architecture

Discord uses the Interactions Endpoint:

\\\`

Discord Interaction → POST /api/gateway/discord/events

│

├── Verify Ed25519 signature

│

├── PING (type=1) → Return PONG

│

├── APPLICATION_COMMAND (type=2)

│ ├── Parse slash command

│ ├── Queue to Inngest

│ └── Return DEFERRED response

│

└── MESSAGE_COMPONENT (type=3)

└── Handle button clicks (feedback)

\\\`

Bot Configuration

\\\`python

client.integrations.discord.configure({

"bot": {

"name": "LH42 Assistant",

"response_style": "concise", # concise | detailed

"embed_color": 5814783, # Brand color

"show_citations": True,

"show_feedback_buttons": True,

"typing_indicator": True,

"error_dm": False

},

"channels": {

"mentionsOnly": True, # Only respond to @mentions

"allowed_channel_ids": [], # Empty = all channels

"excluded_channel_ids": [] # Blacklist channels

}

})

\\\`

Notifications

Set up automated notifications:

\\\`python

client.integrations.discord.create_notification({

"name": "New Document Alert",

"channel_id": "123456789",

"events": ["document.processed"],

"template": {

"embeds": [{

"title": "📄 New document indexed",

"description": "{title}\n{summary}",

"color": 3066993

}]

}

})

\\\`

Security

Troubleshooting

API Reference

List Servers

\\\`bash

GET /api/integrations/discord/guilds

# Response

{

"guilds": [

{

"id": "123456789",

"name": "My Server",

"member_count": 150,

"channels_synced": 10

}

]

}

\\\`

Send Message

\\\`bash

POST /api/integrations/discord/send

{

"channel_id": "123456789",

"content": "Hello from LH42!",

"embed": {...}

}

\\\`

Next Steps

• Slack Integration - Similar setup for Slack
• Communication Overview - Architecture deep-dive