Installing the Discord Bot

Installing the Discord Bot

Add Wallu to your Discord server

Installing the Discord Bot

Add the Wallu AI bot to your Discord server in minutes.

Prerequisites

• A Discord account with server admin permissions
• A Wallu account (free tier works)

Installation Steps

Step 1: Authorize the Bot

• Log in to your Wallu dashboard
• Go to Integrations → Discord
• Click "Add to Discord"
• Select your server from the dropdown
• Review permissions and click "Authorize"

Step 2: Configure Permissions

The bot needs these permissions:

• Read Messages
• Send Messages
• Embed Links
• Read Message History
• Add Reactions

Step 3: Set Up Channels

Choose which channels the bot monitors:

/wallu setup #support-channel

Or configure in the dashboard under Discord Settings.

Step 4: Train Your AI

Upload your knowledge base:

• Go to Knowledge → Add Source
• Upload documents, paste URLs, or enter FAQs
• Click "Train AI"

Verification

Test the bot is working:

@Wallu Hello, can you help me?

The bot should respond within 2 seconds.

Troubleshooting

Bot not responding?

• Check the bot has permissions in the channel
• Verify the channel is in your monitored list
• Ensure your knowledge base has relevant content

Slow responses?

• Check your internet connection
• Large knowledge bases may take longer to search

Bot Configuration

Customize your Discord bot behavior

Bot Configuration

Customize how your Discord bot behaves and responds.

Response Settings

Tone & Personality

Set the bot's communication style:

• Professional: Formal, business-appropriate
• Friendly: Casual, approachable
• Technical: Detailed, precise
• Custom: Define your own guidelines

Response Length

• Concise: 1-2 sentences
• Standard: 2-4 sentences
• Detailed: Full explanations

Language

Set primary and secondary languages for responses.

Trigger Settings

Mention Triggers

@Wallu - Direct mention
wallu - Keyword trigger
? at end - Question detection

Auto-Response

Enable automatic responses without mentions in designated channels.

Moderation

Content Filters

• Profanity filter
• Spam detection
• Link filtering
• Custom word blocks

Escalation Rules

Route conversations to humans when:

• Sentiment is negative
• Keywords are detected (refund, manager, etc.)
• User requests human
• AI confidence is low

Slash Commands

Available commands:

API Integration

Integrate Discord bot with your systems

API Integration

Connect your Discord bot to external systems via API.

Webhooks

Receive events when conversations happen:

{
  "event": "message.received",
  "channel_id": "123456789",
  "user_id": "987654321",
  "content": "How do I reset my password?",
  "ai_response": "To reset your password...",
  "timestamp": "2024-01-15T10:30:00Z"
}

Setting Up Webhooks

• Go to Settings → Webhooks
• Click "Add Webhook"
• Enter your endpoint URL
• Select events to receive
• Copy the signing secret

Verifying Webhooks

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return signature === expected;
}

REST API

Get Conversations

curl -X GET https://api.wallu.ai/v1/discord/conversations \
  -H "Authorization: Bearer YOUR_API_KEY"

Send Message

curl -X POST https://api.wallu.ai/v1/discord/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel_id": "123", "message": "Hello!"}'

Custom Actions

Trigger custom actions from Discord:

// Register a custom action
wallu.registerAction('create_ticket', async (context) => {
  const ticket = await yourTicketSystem.create({
    user: context.user,
    message: context.message
  });
  return `Ticket #${ticket.id} created!`;
});