3D Chatbot Features¶

Product: 3D Avatar Chatbot
Type: Flagship premium offering
Target Users: Enterprise customers, premium subscribers
Business Value: Highest revenue generator, most advanced capability

🎯 Overview¶

The 3D Chatbot is MachineAvatars' flagship product - a lifelike virtual assistant powered by advanced AI that combines realistic 3D avatars with natural language processing, voice synthesis, and intelligent conversation capabilities.

What Makes It Special:

Photorealistic 3D avatars with facial animations
Natural lip-sync synchronized to speech
Emotional expressions and gestures
Context-aware conversations with memory
Multi-model AI (11 LLM options)
Enterprise-grade features (guardrails, analytics, UTM targeting)

🚀 Core Capabilities¶

1. Realistic 3D Avatars¶

What it does:
Provides lifelike 3D avatar characters that visually represent your chatbot, creating an engaging and human-like interaction experience.

Key Features:

16+ Professional Avatars: Diverse selection of male/female avatars representing different demographics
Three.js Rendering: High-quality real-time 3D graphics in the browser
Facial Animations: Eyes, eyebrows, mouth movements synchronized to speech
Emotional Expressions: Happy, neutral, thoughtful, concerned states
Responsive Design: Works seamlessly on desktop, tablet, and mobile

User Benefit:
Creates trust and engagement - users are 3× more likely to interact with a human-like avatar than text-only chat.

Technical Foundation:

Frontend: Three.js WebGL rendering
Backend: Rhubarb Lip-Sync engine (phonetic analysis)
Format: GLTF/GLB 3D models

2. Natural Voice & Speech¶

What it does:
Converts AI responses to natural-sounding speech with accurate lip synchronization to the 3D avatar.

Voice Selection:

Esther Howard (Female) - Warm, professional
Erica Rose (Female 2) - Energetic, friendly
Sophia Martinez (Female 3) - Clear, authoritative
Rose Bennett (Female 4) - Soft, empathetic
Liam Johnson (Male) - Strong, confident
Adrian Foster (Male 2) - Calm, reassuring
Benjamin Hayes (Male 3) - Dynamic, engaging
Caleb Reed (Male 4) - Smooth, sophisticated
Emily Parker (Female 5) - Professional, articulate
Female 6 - Variant option

Technology:

Azure Neural Text-to-Speech (10 premium voices)
Phonetic lip-sync animation (9 mouth shapes: A-H + X rest)
Base64 audio streaming
PCM audio encoding

User Benefit:
Natural conversations feel like talking to a real person, not a bot. Increases conversation duration by 40%.

3. Intelligent Conversations (RAG-Powered)¶

What it does:
Uses Retrieval-Augmented Generation (RAG) to provide accurate, contextual answers based on your knowledge base.

How It Works:

Knowledge Base: Upload website content, PDFs, documents, Q&A pairs
Vector Search: Finds most relevant information using Milvus vector database
AI Generation: 11 LLM models generate natural responses
Context Memory: Maintains conversation history for follow-up questions

Supported Data Sources:

Website Crawling: Up to 50 URLs, automatic sitemap parsing
File Upload: PDF, DOCX documents (multiple files)
Manual Text: Direct text input
Q&A Pairs: Predefined question-answer sets
Excel Data: Structured data import

AI Models Available:

GPT-4 (Azure OpenAI) - Complex reasoning
GPT-3.5-Turbo-16k (Default) - Balanced performance
GPT-4o-mini - Fast, cost-effective
o1-mini - Advanced reasoning
Llama 3.3-70B - Open-source alternative
DeepSeek R1 - Reasoning specialist
Ministral-3B - Lightweight
Phi-3 - Efficient
Gemini, Claude, Grok - Additional options

User Benefit:
90%+ accuracy in answering domain-specific questions. No hallucinations - answers are grounded in your actual data.

Technical Foundation:

Embeddings: BAAI/bge-small-en-v1.5 (384 dimensions)
Vector DB: Milvus with cosine similarity search
Top-K Retrieval: 5 most relevant chunks
Token Limit: 16,000 tokens (context window)

4. Advanced Customization¶

What it does:
Complete control over chatbot behavior, appearance, and functionality.

Customization Options:

A. Purpose & Personality

Sales Agent
Customer Support
Lead Generation
FAQ Assistant
Product Guide
Custom role

B. Visual Branding

Avatar selection (16+ options)
Voice selection (10 options)
Brand colors/styling
Custom backgrounds
Logo integration

C. Conversation Behavior

Custom system prompts
Personality traits
Tone of voice (professional, casual, friendly)
Response length preferences
Language style

D. Business Configuration

Lead capture forms
UTM campaign targeting
Custom greetings
Fallback responses
Contact information display rules

User Benefit:
Your chatbot aligns perfectly with your brand identity and business goals.

5. Comprehensive Admin Dashboard¶

What it does:
Full-featured control panel for managing your 3D chatbot.

7-Tab Interface:

Tab 1: Overview

Quick stats
Active sessions
Response quality metrics

Tab 2: Chat History

Complete conversation logs
User questions and bot responses
Session details
Export capabilities

Tab 3: Knowledge Base

View/edit training data
Add/remove content
Update Q&A pairs
Refresh website data

Tab 4: Analytics

Usage statistics
Popular questions
Conversation quality
User engagement metrics

Tab 5: Settings

Avatar selection
Voice configuration
System prompts
Guardrails management

Tab 6: Lead Management

Captured leads
Form submissions
Export to CRM

Tab 7: Screenshot Capture

Take chatbot screenshots
Preview how users see it
Share with team

User Benefit:
Complete visibility and control. Make data-driven improvements to your chatbot.

6. Enterprise Features¶

What it does:
Advanced capabilities for business-critical deployments.

A. Content Guardrails

Blocked keywords filtering
Topic restrictions
Response validation
Safety rules
Profanity detection
Action triggers (reject, redirect, notify)

Structure:

{
  "rules": [
    {
      "type": "blocked_keywords",
      "keywords": ["competitor", "inappropriate"],
      "action": "reject"
    },
    {
      "type": "topic_restriction",
      "allowed_topics": ["products", "support"],
      "action": "redirect"
    }
  ],
  "enabled": true
}

B. UTM Campaign Targeting

Personalized responses based on traffic source
Campaign-specific content
Dynamic prompts by marketing channel
Conversion optimization

Scoring Algorithm:

Target URL match: +10 points
Each UTM parameter match: +2 points
URL-only match: +5 points

Example Use Case:

User from Google Ads sees "20% discount" messaging
User from email campaign sees "valued customer" messaging
User from partner site sees co-branded content

C. Performance Logging

Response time tracking
Token usage monitoring
Model performance comparison
Cost analytics
Bottleneck identification

Metrics Tracked:

{
  "metrics": {
    "total_time_ms": 4500,
    "milvus_time_ms": 120,
    "llm_time_ms": 2500,
    "tts_time_ms": 1200,
    "lipsync_time_ms": 680
  },
  "tokens": {
    "input": 150,
    "output": 80,
    "total": 230
  }
}

D. Lead Collection

Smart form triggers
Custom field configuration
CRM integration ready
Lead scoring

User Benefit:
Enterprise-grade reliability, security, and insights for mission-critical applications.

7. Seamless Deployment¶

What it does:
Multiple integration options to embed your 3D chatbot anywhere.

Deployment Methods:

A. Widget SDK (Recommended)

<script
  src="https://machineavatars.com/sdk/chat-sdk.js"
  async
  data-h="[your-project-id-encoded]"
></script>

Features:

Floating chat bubble
Minimizable window
Mobile responsive
Auto-loads on page
Customizable position

B. iFrame Embed

<iframe
  src="https://app.machineavatars.com/embed/[project-id]"
  width="400"
  height="600"
  frameborder="0"
></iframe>

C. Direct Integration

React component
Vue component
Angular component
Vanilla JavaScript

D. Shared Links

Public chatbot URL
No login required
QR code support
Social media sharing

User Benefit:
Deploy in minutes. Works on any website, platform, or app.

📊 Feature Comparison by Plan¶

Feature	Free	Pro	Business	Premium
3D Avatars	3 options	8 options	16 options	All + Custom
Voices	2	5	10	All + Custom
Website URLs	10	25	50	Unlimited
File Uploads	1 MB	10 MB	50 MB	Unlimited
Chat Sessions	100/month	1,000/month	10,000/month	Unlimited
Knowledge Base	Text only	Text + Files	All sources	All + API
LLM Models	GPT-3.5	GPT-3.5, GPT-4o-mini	All 11 models	All + Custom
Analytics	Basic	Standard	Advanced	Custom dashboards
Guardrails	❌	Basic	Full	Full + Custom
UTM Targeting	❌	❌	✅	✅
Lead Collection	❌	Basic	Full	Full + CRM integration
Priority Support	❌	Email	Email + Chat	Dedicated manager
White-Label	❌	❌	❌	✅
SLA	None	99%	99.9%	99.99%

💼 Use Cases¶

1. E-Commerce Sales Assistant¶

Scenario: Online store needs 24/7 product expert

Configuration:

Purpose: Sales Agent
Avatar: Professional female (Sophia Martinez)
Voice: Clear, authoritative
Data: Product catalog, pricing, shipping info
Guardrails: No competitor mentions
Lead Form: Collect email for cart abandonment

Results:

30% increase in conversion
50% reduction in support tickets
24/7 availability

2. Healthcare Patient Support¶

Scenario: Medical practice needs appointment scheduling and FAQs

Configuration:

Purpose: Customer Support
Avatar: Empathetic female (Rose Bennett)
Voice: Soft, reassuring
Data: Services, doctor bios, insurance info
Guardrails: HIPAA-compliant responses
Lead Form: Appointment booking

Results:

40% reduction in phone calls
Improved patient satisfaction
After-hours service

3. SaaS Product Guide¶

Scenario: Software company needs onboarding assistant

Configuration:

Purpose: Product Guide
Avatar: Tech-savvy (Liam Johnson)
Voice: Professional, clear
Data: Documentation, tutorials, API docs
UTM: Different demos for free vs paid traffic
Lead Form: Trial signup

Results:

60% faster onboarding
Reduced support load
Higher trial conversions

4. Real Estate Virtual Agent¶

Scenario: Real estate agency needs property information assistant

Configuration:

Purpose: Sales + Lead Generation
Avatar: Professional (Erica Rose)
Voice: Friendly, energetic
Data: Property listings, neighborhood info, mortgage calculator
UTM: Property-specific campaigns
Lead Form: Contact for viewing

Results:

24/7 lead capture
Qualified leads increased 45%
Reduced agent workload

🔧 Configuration Best Practices¶

Optimal Avatar Selection¶

For Professional Services: Sophia Martinez, Liam Johnson
For Healthcare: Rose Bennett, Adrian Foster
For Sales/Marketing: Erica Rose, Benjamin Hayes
For Tech Support: Caleb Reed, Emily Parker

Voice Selection Tips¶

Match voice gender to avatar
Consider brand tone (formal vs casual)
Test with sample audience
Female voices: Higher engagement for service/support
Male voices: Higher authority perception for tech/finance

Data Training Recommendations¶

Start with Website: Easiest, fastest setup
Add Q&A Pairs: Cover edge cases not on website
Upload Documents: Product manuals, detailed guides
Iterate: Review chat logs, add missing content

Performance Optimization¶

Keep knowledge base focused (quality > quantity)
Use Q&A for frequently asked questions (faster retrieval)
Enable guardrails to prevent off-topic conversations
Monitor analytics to refine system prompts

🔗 Technical Integration¶

Frontend Components¶

3D Rendering: ThreeD_Chatbot.js component
Chat Interface: 3d-chatbot/page.tsx (524 lines)
Admin Dashboard: 7-tab interface with screenshot capture

Backend Services¶

Main: response-3d-chatbot-service (Port 8011) - 2,534 lines
Data Source: data-crawling-service, client-data-collection-service
State: state-selection-3dchatbot-service
Creation: create-chatbot-service

APIs Used¶

Azure OpenAI (11 models)
Azure TTS (10 voices)
Milvus Vector DB
MongoDB (6 collections)
Rhubarb Lip-Sync

Collections¶

chatbot_history - Conversation logs
chatbot_selections - User preferences
files - Knowledge base content
chatbot_guardrails - Safety rules
performance_logs - Metrics
LEAD_COLLECTION - Form submissions

📈 Performance Specs¶

Average Response Time: 4-8 seconds (including lip-sync generation)

Breakdown:

Vector search: ~120ms
LLM generation: ~2,500ms
TTS synthesis: ~1,200ms
Lip-sync creation: ~680ms
Overhead: ~1,000ms

Concurrent Users: 1,000+ (scales automatically)

Accuracy: 90%+ on domain-specific questions

Uptime: 99.9% SLA (Business/Premium plans)

🚨 Limitations & Considerations¶

Current Limitations¶

Video Upload: Not yet supported (roadmap)
Multi-Language: English optimized (other languages experimental)
Voice Cloning: Not available (uses predefined voices)
Offline Mode: Requires internet connection
Mobile Performance: Reduced quality on low-end devices

Workarounds¶

Video Content: Use YouTube links in text or convert to text transcripts
Multi-Language: Separate chatbots per language
Custom Voice: Contact for enterprise custom TTS
Mobile: Responsive design ensures functional experience

Backend Services:

Response 3D Chatbot Service - Technical details
State Selection Service
Create Chatbot Service

Frontend:

APIs:

API Documentation

Architecture:

ADR-001: LLM Selection

🎓 Training Resources¶

For Sales Teams¶

Demo video: 3D chatbot product tour
ROI calculator: Show cost savings vs human agents
Case studies: Successful customer implementations
Competitive comparison: vs Intercom, Drift, Tidio

For Support Teams¶

Setup guide: Step-by-step chatbot creation
Troubleshooting: Common issues and solutions
FAQ: Frequently asked questions from customers
Best practices: Optimization tips

For Developers¶

SDK documentation: Integration guide
API reference: Endpoint details
Code samples: React, Vue, Angular examples
Webhook guide: Custom integrations

"Lifelike conversations, powered by advanced AI - the future of customer engagement." 🤖✨

3D Chatbot Features¶

🎯 Overview¶

🚀 Core Capabilities¶

1. Realistic 3D Avatars¶

2. Natural Voice & Speech¶

3. Intelligent Conversations (RAG-Powered)¶

4. Advanced Customization¶

5. Comprehensive Admin Dashboard¶

6. Enterprise Features¶

7. Seamless Deployment¶

📊 Feature Comparison by Plan¶

💼 Use Cases¶

1. E-Commerce Sales Assistant¶

2. Healthcare Patient Support¶

3. SaaS Product Guide¶

4. Real Estate Virtual Agent¶

🔧 Configuration Best Practices¶

Optimal Avatar Selection¶

Voice Selection Tips¶

Data Training Recommendations¶

Performance Optimization¶

🔗 Technical Integration¶

Frontend Components¶

Backend Services¶

APIs Used¶

Collections¶

📈 Performance Specs¶

🚨 Limitations & Considerations¶

Current Limitations¶

Workarounds¶

📚 Related Documentation¶

🎓 Training Resources¶

For Sales Teams¶

For Support Teams¶

For Developers¶