Advanced AI Live Support Chat By Codeupp "Openai, Gemini, Open Router"

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

Plugin Name: LiveSupportAI Pro
Version: 1.1.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

Feature

Details

🤖 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":

Outside support hours → AI says "No live agents now, support hours are [times]" → collects issue → creates ticket

Within hours + Agent Online → Chat transferred instantly to live admin → AI disabled → admin types directly

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:

Data

Source

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

Setting

Description

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-3.8-flash (default), 3.6 Flash, 3.5/3.1 Flash-Lite, 3.1 Pro Preview, 3 Flash Preview; 2.5 models for eligible existing users

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

Plugin

Integration

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

Breakpoint

Behavior

≥ 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

Theme

Status

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

Built with ❤️ for Botble CMS ecommerce stores worldwide.

Gemini update — October 10, 2026

Added all current general-purpose Gemini text-chat models from https://ai.google.dev/gemini-api/docs/models. Audio/Live/TTS, image, video and embedding models require separate interfaces and are excluded from this text-chat selector.

Default is Gemini 3.8 Flash. Existing selections remain saved; choose a current model explicitly if your project cannot access 2.5.

Fixed Test ignoring the chosen model and always calling Gemini 2.5 Flash.

Chat and Test use the documented v1beta generateContent API with API-key headers. Chat uses systemInstruction and ignores thought parts in responses.

Corrected quota/request error messages. Local mocked-request tests and PHP syntax checks passed; live model access depends on your key/project.

Upload these three runtime files together within platform/plugins/AIchatsupportbycodeupp/:

src/Services/GeminiService.php

src/Http/Controllers/Admin/LiveSupportSettingsController.php

resources/views/admin/settings.blade.php

Clear compiled views, select Gemini 3.8 Flash, save settings, and click Test. No database migration is needed. The Interactions API is recommended by Google for new integrations; this update retains its documented generateContent API for the existing chat flow.

🔄 Changelogv1.1.0 — 10 October 2026

Added: OpenRouter provider for support chat and connection tests, using the selected model through the Chat Completions API.

Added: Dynamic OpenRouter catalogue loading when selected, plus Refresh models, name/ID search and free/paid filters for models supporting text input and output. Saved model selections survive catalogue failures and filtering.

Improved: Saved OpenAI, Gemini and OpenRouter API keys remain visible in admin settings, with show/hide, copy, edit and remove controls. Remove followed by Save Settings deletes the saved key; omitted key fields preserve existing credentials.

Improved: OpenRouter request failures and empty responses are handled without switching to another paid model. Settings responses use private, no-store caching.

Added: Gemini 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, 3.1 Pro Preview and 3 Flash Preview to the text-chat model selector.

Changed: Default Gemini model to gemini-3.8-flash for new configurations. Existing saved selections are preserved.

Fixed: Test Connection ignoring the selected model and always calling gemini-2.5-flash.

Changed: Chat and connection tests use Google's documented v1beta generateContent endpoint.

Improved: System instructions use the dedicated systemInstruction field, and API keys are sent in request headers instead of URLs.

Improved: Response handling combines text parts while excluding thought parts.

Improved: Model validation and quota/request error messages; quota errors no longer claim the key is confirmed valid.

Preserved: Gemini 2.5 options for eligible existing users, saved credentials, chat history and other provider settings.

Documented: Upload instructions and model compatibility. Specialized audio, Live, image, video and embedding models are not included in the text-chat selector.

Verified: PHP syntax and mocked model-selection, request, response and error-handling tests. Live access must be tested with your Google project credentials.

v1.0.0

Initial release of AI Live Support Chat.

OpenRouter setup and upload instructions (v1.1.0)

This update stays on version 1.1.0. Upload the complete plugin, or replace these runtime files together (including the new service):

src/Services/OpenRouterService.php (new)

src/Services/AIProviderService.php

src/Http/Controllers/Admin/LiveSupportSettingsController.php

resources/views/admin/settings.blade.php

routes/web.php

src/Plugin.php

Upload this README too to retain the release notes. Clear the application's route and compiled-view caches after uploading. No database migration is required.

In Live Support settings, choose OpenRouter, enter your key, select a model from the automatically loaded catalogue, and save. Search or filter by Free/Paid; Refresh models fetches the latest catalogue. Test uses the selected model and may incur its normal usage charges. Free models remain subject to OpenRouter quotas and availability; a catalogue listing does not guarantee account access. Only models supporting text input and output are listed for this chat interface.

All three providers show their saved API key in the admin settings field. Copy copies that key, Show/Hide changes its visibility, and Remove clears it; click Save Settings to apply edits or removal.

References: OpenRouter model catalogue and Chat Completions API.