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

Voice AI in Voice Channels

The bot can join a voice channel and hold a spoken conversation, using the same

knowledge base that answers in text. It is not text-to-speech reading out a written

reply: it listens, answers out loud, and stops the moment you start speaking.

Turning it on

• Open Integrations - Discord and switch on Voice AI.
• Pick a voice channel. The bot joins when somebody enters that channel.
• Leave the channel empty if you would rather summon it manually.

A moderator with Manage Server can also bring it into any channel with

/voice join, and dismiss it with /voice leave. Summoning needs that permission

on purpose: voice minutes are a paid resource, and without the check any member

could spend the month's allowance.

When it leaves

• As soon as the last person leaves the channel.
• After two minutes with nobody speaking.
• When the monthly voice minutes run out. It says so in the channel first.

Minutes are one shared pool

Your plan includes a number of voice minutes per month. That is **one allowance

across every surface**, not one per channel. Minutes spent talking to the widget on

your website are minutes Discord no longer has. The bot reports how many are left

when it joins, warns you as the allowance runs low, and leaves when it is gone. See

the pricing page for the minutes included with each plan.

Recordings and transcripts

Every call is recorded and transcribed, and appears in your inbox as a normal

conversation with the audio attached. That is also what makes Teach the AI work

on voice: if the bot answered badly, you can correct it from the transcript.

Voice AI is included from the Starter plan upwards.

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!`;
});