AI Live Support Chat

⚡ LiveSupportAI Pro — AI-Powered Live Chat & Helpdesk for Botble Marketplace

Plugin Name: LiveSupportAI Pro
Version: 1.0.0
Author: Maryam International LLC
Website: codeupp.xyz
Compatible: Botble CMS 7.0+ · Martfury · Shofy · Nest

The most advanced, fully autonomous AI support plugin ever built for Botble CMS. Trained specifically over 60 days on Botble's ecommerce ecosystem — orders, vendors, wallets, loyalty points, payouts, commissions, marketplace policies, and more. It doesn't just answer questions — it knows your store.

Why You NEED This Plugin

Most support plugins just show a chat widget. LiveSupportAI Pro does everything — it understands your customers in real time, handles complex vendor queries, answers commission and fee questions in any language, transfers chats to live agents on demand, creates support tickets automatically, respects your business hours by timezone, and saves API tokens by handling emoji and social phrases without ever calling the AI.

Your support team can rest. The AI never sleeps. 💪

🔥 What Makes It Different🧠 60-Day Trained AI — Knows Botble Inside Out

We didn't just install GPT and call it a day. We spent 60 days training and fine-tuning the AI prompt engine to deeply understand:

• Botble's order system, statuses, and cancellation flows
• Wallet top-up, balance checking, and transaction history
• Loyalty points, tiers, redemptions, and member levels
• Marketplace vendor commissions, payouts, and withdrawal fees
• Per-category commission rules, product approval policies, digital product permissions
• Max upload limits, image limits, and platform rules — all read live from your admin settings
• All 3 major Botble themes: Martfury, Shofy, and Nest

Ask it anything about your store — no matter how complex or tricky. It answers correctly, every time.

✨ Full Feature List

FeatureDetails

🤖 Dual AI Provider

OpenAI (GPT-4o, GPT-4o-mini, GPT-4, o1, o3) + Google Gemini (2.5 Flash, 2.0 Flash, 1.5 Pro)

👤 Live Agent Transfer

"Talk to Agent" chip → checks if admin is online → instantly transfers or creates ticket

🕐 Opening Hours + Timezone

Set support hours, open days, and timezone — customer's local time checked automatically

🎫 Auto Ticket Creation

AI collects issue → creates Ticksify ticket → sends confirmation with ticket #

📊 3-Column Admin Panel

Chat list · Active conversation · Customer info — like professional live chat tools

⭐ Rating System

1–5 star ratings with comments, dashboard analytics, CSV export

🔄 Real-Time WebSockets

Laravel Echo / Pusher with 4-second polling fallback

📎 Image Upload

Customers send images directly in chat (max 5MB)

🎤 Voice Messages

Hold-to-record audio via MediaRecorder API with auto-language detection

🌍 Auto Language Detection

Responds in the customer's language automatically — Arabic, English, French, Urdu, Spanish, and more

⚡ Smart Hardcoded Replies

Greetings, thank-yous, farewells — zero AI API calls, 10+ languages covered

😊 Emoji Intelligence

Sends emoji only? AI reads the emotion (😂❤️😡) and replies appropriately — no API needed

🛒 Real-Time Store Context

AI reads orders, wallet, points, commissions, withdrawal fees, marketplace rules — all live

🏪 Full Vendor Support

Dedicated vendor AI with commission %, payout info, withdrawal fees, upload limits, approval rules

🌐 Zero Hardcoding

100% dynamic — works on any Botble store out of the box

📱 Mobile Responsive

Optimized for Martfury, Shofy, and Nest on all screen sizes

🎨 Theme Color Sync

Chat UI automatically inherits your active Botble theme's primary color

� Off-Topic Protection

Refuses coding, weather, general knowledge — stays strictly on store support

🕐 Opening Hours & Timezone Support

Set your support hours once. The AI handles the rest.

• Set opening time and closing time (e.g. 10:00 AM – 8:00 PM)
• Choose open days (Mon–Fri work, Sat–Sun holiday)
• Select your admin timezone (Asia/Dubai, Europe/London, America/New_York, etc.)
• Customer's local time is auto-converted in the browser using the Intl API

Example: Admin in UAE sets 10 AM – 8 PM (Asia/Dubai). A UK customer clicks "Talk to Agent" at 9 PM UK time → system detects it's 1 AM UAE → outside hours → AI says "No live agents available right now — support hours are 10:00 AM – 8:00 PM" → starts ticket flow automatically.

🤝 Live Agent Transfer Flow

When a customer clicks "Talk to Agent":

1. Outside support hours → AI says "No live agents now, support hours are [times]" → collects issue → creates ticket
2. Within hours + Agent Online → Chat transferred instantly to live admin → AI disabled → admin types directly
3. Within hours + Agent Busy → AI says "Our support team is currently busy" → collects issue → creates ticket

🏪 Vendor Marketplace Intelligence

Vendors get a dedicated AI experience with full awareness of:

DataSource

Platform Commission %

Live from marketplace settings

Per-category commission rates

Auto-detected if enabled

Withdrawal fee (fixed or %)

Live from marketplace settings

Minimum withdrawal amount

Live from marketplace settings

Product approval requirement

Live from marketplace settings

Digital products allowed

Live from marketplace settings

Max upload filesize (MB)

Live from marketplace settings

Max product images

Live from marketplace settings

Vendor balance & total revenue

Live from vendor store record

Vendor's recent orders

Live from database

Pending withdrawals

Live from withdrawal requests

Ask it anything: "What is the current commission?", "How much does the platform charge per sale?", "What is the withdrawal fee in UAE?" — the AI reads your live settings and answers directly.

⚡ Zero-Token Smart Replies

Save AI API costs on common messages:

Social Phrases (10+ languages): Hi, Hello, Salam, مرحبا, Bonjour, Hola → instant reply, no API call Thank you, Shukran, Merci, Gracias → instant reply Sorry, Goodbye, OK, You're welcome → instant reply

Emoji-Only Messages: 😂 → "Haha! Glad to bring a smile!" ❤️ → "Aww, thank you! We love our customers!" 😡 → "I'm really sorry if something went wrong — please tell me what happened" 😢 → "I'm sorry you're upset — let me help you right away" 👍 → "Great! Is there anything else I can help you with?" 🙏 → "Of course! Happy to help!"

🧠 AI Context — What the AI Knows Automatically

For Customers:

• ✅ Store name, email, phone, address, website
• ✅ Currency (dynamic)
• ✅ Customer name, email, phone
• ✅ Last 5 orders with status, amount, items, date
• ✅ Wallet balance
• ✅ Loyalty points, tier level, lifetime points
• ✅ Affiliate program status
• ✅ Active discount codes and promotions
• ✅ Policy pages (Terms, Refund, Privacy, FAQ, Shipping)
• ✅ All installed plugin features

For Vendors:

• ✅ Everything above plus full vendor store profile
• ✅ Platform commission rate (global + per-store)
• ✅ Withdrawal fee amount and type
• ✅ Minimum withdrawal threshold
• ✅ Product approval, digital product, upload rules
• ✅ Vendor store name, slug, status
• ✅ Recent vendor orders
• ✅ Available payout balance and total revenue
• ✅ Vendor policy pages and FAQ

Zero hardcoding — all data fetched live and cached per user for 5 minutes.

🚀 Installation1. Upload Plugin

platform/plugins/live-support-ai/

2. Activate Plugin

Admin → Plugins → Find "LiveSupportAI Pro" → Click Activate

3. Run Migrations

Auto-runs on activation. Creates:

• ls_support_sessions
• ls_support_messages
• ls_support_ratings

4. Publish Assets

php artisan vendor:publish --tag=live-support-ai-assets

5. Configure AI

Admin → Live Support → Settings:

• Select OpenAI or Gemini
• Paste your API key → click Test Connection ✅
• Select model (GPT-4o Mini recommended)
• Set agent name, welcome message, tone
• Configure opening hours (optional)
• Save

🎛️ Settings Reference

SettingDescription

AI Provider

openai or gemini

OpenAI API Key

Your sk-... key

OpenAI Model

gpt-4o-mini (default), gpt-4o, gpt-4, o1, o3-mini

Gemini API Key

Your AIza... key

Gemini Model

gemini-2.5-flash (default), gemini-2.0-flash, gemini-1.5-pro

Agent Status

Online / Offline — affects live agent availability

Agent Display Name

Name shown when admin joins chat

Welcome Message

First message sent to every new session

AI System Instructions

Custom instructions appended to AI context

Auto-ticket after N messages

Create ticket after N unresolved AI exchanges

AI Tone

Friendly / Formal

Opening Hours Enabled

Toggle on/off support hour restrictions

Opening Time

e.g. 09:00

Closing Time

e.g. 20:00

Admin Timezone

e.g. Asia/Dubai — customer's local time auto-converted

Open Days

Checkboxes Mon–Sun — unchecked = holiday/closed

🔌 Plugin Integrations

PluginIntegration

Botble Ecommerce

Order tracking, cancel instructions, product info

Marketplace

Commission %, withdrawal fees, vendor rules — all live

Wallet / E-Wallet

Balance display, top-up guidance

Loyalty Points

Points balance, tier level, redemption instructions

Affiliate / Referral

Program info and referral links

FOB Ticksify

Auto-ticket creation from chat sessions

Subscription

Subscription plan info

Wholesale

Wholesale account guidance

All integrations are optional and auto-detected. No errors if a plugin isn't installed.

📊 Ratings Dashboard

Admin → Live Support → Ratings

• 4 stat cards: Avg Rating · Total Chats · % Satisfied · Tickets Created
• Star distribution bar chart
• Ratings table with customer name, rating, comment, session link
• Red row highlight for 1–2 star ratings
• Contact Customer button (mailto)
• Export CSV button

🌐 Real-Time WebSockets

Private channel: ls-session.{sessionId}   — per-chat messages Private channel: ls-admin-support         — new session notifications

Events: MessageSent · AgentJoined · ChatEnded · NewSessionStarted

Fallback: Auto-polls every 4 seconds if WebSocket unavailable.

📱 Mobile Responsiveness

BreakpointBehavior

≥ 1100px

Full 3-column admin layout

900–1100px

2-column (info panel hidden)

640–900px

2-column (list + chat)

< 640px

Single column stack

User chat < 576px

Full-screen chat

🎨 Theme Compatibility

ThemeStatus

Martfury

✅ Full

Shofy

✅ Full

Nest

✅ Full

Any Botble theme

✅ Supported

🔒 Security

• All endpoints protected by auth('customer') or admin middleware
• File uploads: type whitelist, size limits enforced
• HTML stripped from all user messages before AI
• AI API keys stored in setting() table, never exposed to frontend
• CSRF protection on all POST routes

API Keys

• OpenAI: https://platform.openai.com/api-keys
• Google Gemini: https://aistudio.google.com/app/apikey

📞 Support

Maryam International LLC
🌐 codeupp.xyz Email ; maryaminternationalllc@gmail.com whatsapp; +971553682656