Skip to main content

Web Widget Integration

Add your Discord AI assistant to any website with the Wallu Web Widget. Same knowledge, zero extra setup or "training" needed.

Quick Setup​

Option 1: CDN (Recommended - updates automatically)​

  1. Get your public API key from Wallu Panel - Addons
  2. Add to your website:

<script>
    window.WALLU_CONFIG = {
        apiKey: 'pk_your_actual_key_here',
        // Built in themes are: 'discord', 'corporate', 'tech', 'gaming', 'minimal'
        theme: 'discord'
    };
</script>
<script defer src="https://wallubot.com/wallu-widget.js"></script>

Option 2: Download & Configure (In case you want to customize the Wallu's web widget)​

  1. Download wallu-widget.js from the GitHub repository
  2. Edit the WALLU_CONFIG section in the file
  3. Upload to your website and include:

<script defer src="./wallu-widget.js"></script>

Configuration Options​

window.WALLU_CONFIG = {
    apiKey: 'pk_your_key_here',           // Required
    theme: 'discord',                     // discord, corporate, tech, gaming, minimal
    botName: 'AI Assistant',
    welcomeMessage: 'How can I help?',
    position: 'bottom-right',             // or bottom-left
    discordWebhook: true                  // Log conversations to Discord
};

Platform-Specific Setup​

WordPress - Install Wallu web widget​

Use "Insert Headers and Footers" plugin and add the CDN code to the footer.

Shopify - Install Wallu web widget​

Upload the widget file to theme assets and reference it in layout/theme.liquid.

React/Next.js - Install Wallu web widget​

useEffect(() => {
    window.WALLU_CONFIG = { apiKey: 'pk_your_key_here', theme: 'discord' };
    const script = document.createElement('script');
    script.src = 'https://wallubot.com/wallu-widget.js';
    script.defer = true;
    document.body.appendChild(script);
}, []);

Customization​

Custom Instructions​

Configure different behavior for your website in Wallu Panel - Channels. The web widget channel appears after the first message is sent.

Example web-specific instructions:

- You are responding on our WEBSITE, not Discord
- If you cannot help, refer users to join our Discord: https://discord.gg/yourserver

Security​

  • Use public API keys (starting with pk_) - safe for frontend use
  • Public keys only allow sending messages, not modifying bot settings
  • Built-in rate limiting protects against abuse

Getting Help​