Quofata AI Chat Infrastructure Documentation
A privacy-first, model-agnostic chatbot infrastructure allowing businesses to deploy customized AI assistants using OpenAI GPT-4o or Google Gemini models.
Core Capabilities
Model Orchestration
- Multi-Provider Support: Switch instantly between OpenAI (GPT-4o) and Google Gemini (Pro/Flash).
- Bring Your Own Key (BYOK): Users manage their own API keys for complete cost control and privacy.
- Fallback Logic: System availability architecture designed to handle provider outages.
Knowledge Management
- RAG (Retrieval-Augmented Generation): Upload PDFs to create instant subject matter experts.
- Structured Data Support: Paste JSON objects directly into the bot configuration for precise data recall (e.g., product catalogs, pricing tables).
- Context Window Management: Optimized prompt engineering to maximize token efficiency.
Customization & Branding
- Visual Editor: Real-time preview of chatbot widget.
- Shape Shifting: Choose between Round, Square, or Rectangle (Button) launcher shapes.
- Color System: Full hex-code support to match brand identity.
- Avatar Hosting: Secure upload and hosting of custom bot avatars.
Lead Generation
- Active Capture: Bots can be configured to proactively ask for Name, Email, and Phone.
- Intent Recognition: Detects purchase intent and serves conversion URLs.
- Dashboard Analytics: View captured leads in a tabular format within the user dashboard.
- Data Export: CSV export functionality for CRM integration.
- Auto-Responder: Automatically sends a confirmation email to the user upon successful lead submission.
Integration
- Universal Widget: Single line of JavaScript (<script src='...'>) works on any HTML, WordPress, Shopify, or React site.
- Domain Whitelisting: Security feature to prevent unauthorized usage of your bot on other domains.
- Webhook Events: (Planned) Server-side notifications for lead capture and conversation milestones.
Plans & Pricing
Each bot is priced individually based on the template you choose. Create a free account, pick a template, and pay per bot — no platform subscription required.
Basic Query Bot
Perfect for nonprofits, churches, and community organisations.
- Answer FAQs from knowledge base
- Collect name, email & phone
- Email notifications on new leads
- Custom avatar & branding
B2B Lead Gen Bot
Built for B2B businesses. Qualifies and scores leads automatically.
- Everything in Basic Query
- Capture organisation & intent
- Automatic lead scoring
- SMS + Email alerts
- Webhook integration
Booking Bot
The full package — lead gen plus appointment booking & WhatsApp.
- Everything in B2B Lead Gen
- Appointment booking flow
- WhatsApp integration
- Calendar sync ready
- Priority support
Supported AI Models
Bring Your Own Key (BYOK)
QuoFata does not resell API tokens. You provide your own Google Gemini API key, which is stored securely and used only for your bots. Get a free key from Google AI Studio.
Google Gemini
RequiredPowers the Vox5 voice bot engine with multimodal AI capabilities.
- Gemini 2.0 Flash (Live API)
- Real-time voice conversation
- Free tier available from Google
More Coming Soon
RoadmapAdditional model providers will be supported in future releases.
- OpenAI GPT-4o
- Anthropic Claude
- Open-source models
Quick Start Guide
Get your AI voice bot live on your website in under 5 minutes.
Create an Account
Register for free at quofata.com. Verify your email to activate your account.
Choose a Bot Template
In your dashboard, click Create New Bot and pick from Basic Query (£19/mo), B2B Lead Gen (£29/mo), or Booking Bot (£39/mo). Give it a name.
Add Your Gemini API Key
Click Edit on your bot card and paste your Google Gemini API key. Get one free from Google AI Studio.
Customise & Add Knowledge Base
Edit the system prompt and paste your organisation’s info (FAQs, services, contact details) into the knowledge base editor.
Pay & Activate
Complete the checkout to activate your bot. Once paid, toggle it to Active in your dashboard.
Embed on Your Website
Copy the embed code from your bot card and paste it into your website’s HTML, just before the closing </body> tag. That’s it — your bot is live!
Widget Installation
Add a single <script> tag to your website. Place it before the closing </body> tag. Replace YOUR_USER_ID and YOUR_BOT_TOKEN with the values shown on your bot card in the dashboard.
<script
src="https://quofata.com/bot/YOUR_USER_ID/YOUR_BOT_TOKEN/widget-loader.js"
data-bot-id="YOUR_BOT_TOKEN"
data-api-key="YOUR_GEMINI_API_KEY">
</script>Where do I find my bot token and user ID?
Go to your Dashboard, find your bot card, and look for the token at the bottom (e.g. bot_a1b2c3d4e5f6). For active bots, a ready-to-copy embed code (with the full URL including your user ID) is shown directly on the card.
Example: Full HTML Page
A minimal example showing where to place the widget script.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>My Website</title>
</head>
<body>
<h1>Welcome to My Website</h1>
<p>Your page content goes here.</p>
<!-- QuoFata Vox5 Voice Bot -->
<script
src="https://quofata.com/bot/YOUR_USER_ID/YOUR_BOT_TOKEN/widget-loader.js"
data-bot-id="YOUR_BOT_TOKEN"
data-api-key="YOUR_GEMINI_API_KEY">
</script>
</body>
</html>Best Practice: Shared Footer for Multi-Page Sites
For PHP sites with multiple pages, put the widget in a shared footer file so the bot persists across pages.
1. Create footer.php
Place the widget script here alongside your closing HTML tags.
<!-- footer.php -->
<script
src="https://quofata.com/bot/YOUR_USER_ID/YOUR_BOT_TOKEN/widget-loader.js"
data-bot-id="YOUR_BOT_TOKEN"
data-api-key="YOUR_GEMINI_API_KEY">
</script>
</body>
</html>2. Include in every page
Replace your closing </body></html> with this include.
<?php include 'footer.php'; ?>Developer API
Retrieve captured leads programmatically using your organisation’s API key. Find your API key in your dashboard settings.
Get Leads
https://quofata.com/api/get_leads.php?api_key=YOUR_API_KEY
cURL Example
curl -X GET "https://quofata.com/api/get_leads.php?api_key=YOUR_API_KEY"JavaScript Example
const response = await fetch(
'https://quofata.com/api/get_leads.php?api_key=YOUR_API_KEY'
);
const data = await response.json();
console.log(data.leads);Response Format
{
"success": true,
"leads": [
{
"id": 1,
"bot_id": 25,
"name": "John Smith",
"email": "john@example.com",
"phone": "+44 7700 900000",
"organisation": "Acme Ltd",
"note": "Interested in B2B package",
"score": 85,
"created_at": "2026-02-16 14:30:00"
}
]
}Configuration
The widget script accepts data-* attributes on the <script> tag to control behaviour.
| Attribute | Required | Description |
|---|---|---|
| data-bot-id | Yes | Your unique bot token (e.g. bot_a1b2c3d4). Found on your dashboard bot card. |
| data-api-key | Yes | Your Gemini API key. Added via the bot editor in your dashboard. Get one from Google AI Studio. |
| data-auto-open | No | Set to "true" to automatically open the chat window on page load. |
| data-auto-open-delay | No | Delay in milliseconds before auto-opening (default: 5000). |
Example with Options
<script
src="https://quofata.com/bot/YOUR_USER_ID/bot_a1b2c3d4e5f6/widget-loader.js"
data-bot-id="bot_a1b2c3d4e5f6"
data-api-key="YOUR_GEMINI_API_KEY"
data-auto-open="true"
data-auto-open-delay="3000">
</script>