WeaveDesk AI — Overview & Architecture

WeaveDesk AI is an omnichannel AI customer support copilot, live chat widget, lead capture pipeline, and operational analytics desk designed for SaaS platforms, marketplaces, and digital businesses.

Key Capabilities

• Zero-Dependency 1-Line Embed: Embed into any webpage with a single script tag (widget.js).
• Hybrid AI + Human Escalation: RAG knowledge base answers FAQs instantly. Low confidence automatically hands over to live human agents.
• Lead Capture Gate: Collects visitor contact details and calculates intent scores before routing inquiries.
• White-Label & Multi-Tenant: In-app customizer for brand colors, custom bot avatars, and greeting messages.

Architectural Layers

+--------------------------------------------------------------+
|                   Client Website / App                       |
|   (Embedded widget.js: Floating Chat / Pre-Chat Lead Gate)   |
+------------------------------+-------------------------------+
                               |
                               v (HTTPS / REST)
+--------------------------------------------------------------+
|                   WeaveDesk AI Agent Desk                    |
|   - InboxView: Real-time agent conversations & macros        |
|   - KnowledgeView: FAQ vector grounding & prompt playground  |
|   - LeadsView: CRM pipeline & CSV export                     |
|   - AnalyticsView: CSAT, response latency & AI deflection    |
+------------------------------+-------------------------------+
                               |
                               v (Outbound Webhooks)
+--------------------------------------------------------------+
|            Your Application Backend (Laravel / Node)         |
|   - Captures conversation.escalated_to_human events          |
|   - Sends Slack / Telegram / SMS notifications to team       |
+--------------------------------------------------------------+

Package Structure

Path	Purpose
public/widget.js	Standalone vanilla JS embed script (~7KB)
src/components/InboxView.jsx	Unified operator desk with real-time conversations
src/components/KnowledgeView.jsx	AI prompt tuning & FAQ retrieval sandbox
src/components/LeadsView.jsx	Captured visitor CRM with intent scoring
src/components/AnalyticsView.jsx	SLA performance dashboard & deflection metrics
src/components/EmbedCustomizerView.jsx	Live appearance configurator with code generator
src/components/SetupWizardView.jsx	4-step installation wizard & license activator