Skip to content

Getting Started

Add the Lingu chat widget to your website in under 5 minutes.

Prerequisites

Before you begin, make sure you have:

  1. A Lingu account (Sign up here)
  2. At least one chatbot configured with FAQs or documents
  3. Your Widget API Key (found in Dashboard → Settings → Widget Integration)

Quick Installation

Add this code snippet before the closing </body> tag of your HTML:

html
<!-- Lingu Widget Configuration -->
<script>
  window.linguConfig = {
    apiKey: 'your-api-key-here'
  };
</script>

<!-- Lingu Widget Script -->
<script src="https://widget.uselingu.app/widget.js"></script>

That's it! The widget will appear in the bottom-right corner of your website.

Getting Your API Key

  1. Log in to your Lingu Dashboard
  2. Navigate to SettingsWidget Integration
  3. Copy your Widget API Key
  4. Replace 'your-api-key-here' in the code above

Keep Your API Key Secure

While your API key is designed to be used on public websites, avoid sharing it unnecessarily. Each key is tied to your account and subscription.

Verify Installation

After adding the code to your website:

  1. Refresh your page
  2. Look for the chat button in the bottom-right corner
  3. Click it to open the chat window
  4. Try asking a question!

Not Seeing the Widget?

Open your browser's Developer Console (F12) and check for any error messages. Common issues include incorrect API keys or script loading errors.

Configuration Options

You can customize the widget behavior with additional options:

html
<script>
  window.linguConfig = {
    apiKey: 'your-api-key-here',
    baseURL: 'https://api.uselingu.app/api', // Optional: Custom API endpoint
    autoOpen: false                           // Optional: Auto-open on page load
  };
</script>

See the full Configuration Reference for all available options.

Next Steps

Choose your integration guide based on your platform:

PlatformGuide
Plain HTMLHTML Integration
ReactReact Integration
Next.jsNext.js Integration
ViteVite Integration

Or learn about all configuration options and customization.

Powered by Lingu