Skip to main content

​
Overview

This guide will walk you through the fastest way to add Vaile’s AI-powered chat widget to your dealership website. By the end, you’ll have a fully functional chat assistant capturing leads 24/7.

​
Prerequisites

Before you begin, make sure you have:

Vaile Account & Organization

Complete account setup at app.vaile.ai including creating your dealership organization

Website Access

Access to add HTML code to your website
New to Vaile? Follow our Account Setup Guide first to create your dealership organization and invite team members.

​
Step 1: Get Your Widget Key

  1. Log in to your Vaile Dashboard
  2. Navigate to Setup → Installation
  3. Copy your unique widget key
Your widget key looks like: wk_1234567890abcdef

​
Step 2: Add the Widget Script

Add this script just before the closing </body> tag on every page where you want the chat widget to appear: 
<!-- Vaile Chat Widget -->
<script src="https://embed.vaile.ai/chat-widget-magic.iife.js"></script>
<script>
  initChatWidgetMagic({
    widget_key: 'YOUR_WIDGET_KEY',
    apiUrl: 'https://api.vaile.ai/api/assistant'
  });
</script>
Replace YOUR_WIDGET_KEY with the actual widget key from your dashboard

​
Example Implementation

Here’s how it looks in a typical HTML page: 
<!DOCTYPE html>
<html>
<head>
    <title>Your Dealership</title>
</head>
<body>
    <!-- Your website content -->

    <!-- Vaile Chat Widget -->
    <script src="https://embed.vaile.ai/chat-widget-magic.iife.js"></script>
    <script>
      initChatWidgetMagic({
        widget_key: 'wk_1234567890abcdef',
        apiUrl: 'https://api.vaile.ai/api/assistant'
      });
    </script>
</body>
</html>

​
Step 3: Verify Installation

After adding the script:
  1. Refresh your website - The chat widget should appear in the bottom-right corner
  2. Click the chat icon - The chat interface should open
  3. Send a test message - You should receive an AI-powered response
If the widget doesn’t appear, check your browser’s console for any error messages

​
Step 4: Customize Your Widget

Head to your dashboard’s Setup section in the left-hand panel to customize:
  • Dealership Info: Your dealership details and business information
  • Locations: Manage your dealership locations
  • AI Playbook: Configure your AI assistant’s knowledge and resources
  • Widget Styling: Colors, position, and greeting message
Navigate to Setup in the left-hand panel to access these options.

​
What’s Next?

Widget Customization

Learn how to match the widget to your brand

Managing Leads

Discover how to track and convert captured leads

Chat Settings

Configure advanced chat behavior and responses

Getting Help

Find answers to common questions

​
Need Help?

If you encounter any issues: