Introduction

Welcome to the official documentation for the Smart AI Contact Form & Floating Chat Widget.

Thank you for choosing our product! This documentation will guide you through everything you need to know to install, configure, and get the most out of your new AI-powered support assistant.

What is the Smart AI Contact Form?

The Smart AI Contact Form is a premium, lightweight, drop-in script designed to act as the ultimate Ticket Deflection Shield for your website.

Instead of a traditional, static contact form that forces you to answer the same repetitive questions every day, this widget intercepts visitor inquiries, consults your custom knowledge base, and provides instant, highly accurate answers.

If the AI resolves the issue, your inbox stays clean. If the user still needs human assistance, the widget seamlessly captures their contact details, saves them to a secure file on your server, and routes the lead directly to your email inbox.

💡 The Core Philosophy: Zero Database We built this tool specifically to avoid the headaches of MySQL databases, phpMyAdmin, and complex server configurations. Everything runs on flat files (.csv and .json), meaning it works instantly on almost any web server in the world.

Key Features

• 🤖 Multi-LLM Engine: Easily switch between OpenAI (GPT-4o), Google Gemini, and Groq with a single line of configuration.
• ⚡ Instant CSV Lead Capture: Automatically saves user names, emails, and questions to a downloadable leads.csv file the moment they hit send.
• ✉️ Secure SMTP Routing: Powered by industry-standard PHPMailer to bypass aggressive spam filters and ensure fallback support requests actually reach your inbox.
• 🧠 Custom Knowledge Base: Train the AI on your specific business rules, pricing, and FAQs using a simple content.json file.
• 🎨 Dual UI Modes: Choose between a sleek inline HTML form or a modern floating chat widget.
• 🚀 Framework Agnostic: Built with pure Vanilla Javascript. Drops effortlessly into plain HTML, WordPress, Shopify, React, and Next.js.

How It Works (The User Flow)

1. The Question: A visitor types a question into the widget on your website.
2. Instant Capture: Their Name, Email, and Message are instantly saved to your server's leads.csv file.
3. AI Intercept: The script securely queries your chosen AI model, injecting your custom business rules into the prompt.
4. The Resolution: The AI replies to the user. If they are satisfied, the interaction ends.
5. The Fallback: If the user requests human help, the system triggers an SMTP email directly to your support team with the full chat context.

Ready to begin?

Let's get your server ready. Head over to the next section: Server Requirements.