AI-Powered Features — Complete Guide
14 built-in AI features powered by the Claude API. Eleven of them have their own on/off switch on the AI Settings page, under one master switch. No coding required.
Phase 1 — Product AI Tools
AI tools integrated directly into admin and vendor product add/edit forms. Available on web panel and Flutter vendor/store apps.
AI Product Descriptions
Click "Generate with AI" next to the description field. Claude generates an SEO-optimized 80-150 word description from the product name, category, and price.
| Trigger | Button on product add/edit form |
| Input | Product name, category, price |
| Output | Plain text description (2-3 paragraphs) |
| Meta description | A second button next to the SEO meta description field runs the same generator and trims the result to 160 characters |
| API Key Required | Yes (Claude) |
| Platforms | Admin Panel, Vendor Panel, Vendor App (v3), Store App (v4) |
Auto-Categorization
Click "AI Suggest" next to the category dropdown. Claude analyzes the product name against all available categories and auto-selects the best match.
| Trigger | Button on product form, next to category |
| Input | Product name + category tree |
| Output | category_id + sub_category_id (auto-selects dropdowns) |
| API Key Required | Yes (Claude) |
| Platforms | Admin Panel, Vendor Panel, Vendor App (v3), Store App (v4) |
Auto Image Tagging
Click "AI Tags" in the SEO section after uploading a product thumbnail. Claude Vision analyzes the image and generates 5-10 relevant SEO keywords.
| Trigger | Button in SEO section of product form |
| Input | Product thumbnail image + name |
| Output | Array of SEO tags → populates meta fields |
| API Key Required | Yes (Claude Vision) |
| Platforms | Admin Panel, Vendor Panel, Vendor App (v3), Store App (v4) |
Phase 2 — Customer Experience
AI features that enhance the shopping experience for customers on the website and mobile app.
Shopping Assistant Chatbot
Floating chat widget on the storefront (bottom-left corner). Customers can search products, track orders, and get store info via natural conversation.
| Location | Website — all 3 themes (Classic, Modern, Semi-Classic) — and the customer app, where a floating assistant button on the main screens opens the chat while the chatbot is switched on. |
| Intent Detection | product_search, order_tracking, store_info, greeting, general |
| Product Search | Returns product cards with images, prices, and links |
| Order Tracking | Shows order status, payment, amount, date — for a shopper signed in on the website |
| API Key Required | Yes (Claude) |
| API Endpoint | POST /api/v1/ai/chatbot — answers as a guest, so order tracking is website-only |
Review Summarization
AI generates a 2-3 sentence summary of all customer reviews, shown at the top of the Reviews tab. Cached for 24 hours, and cleared as soon as a review is added, edited, or hidden.
| Minimum Reviews | 3 reviews required to generate summary |
| Cache Duration | 24 hours, refreshed on the next review change |
| Display | Summary card above the individual reviews, on all 3 themes and in the customer app |
| API Key Required | Yes (Claude) |
| API Endpoint | GET /api/v1/ai/review-summary/{productId} |
Background Removal
Product image background removal through the remove.bg API — a busy background is replaced with clean white. It ships as an endpoint and a setting: there is no button for it in the admin or vendor panel and none in the apps, so today it is reachable only from your own code.
| Available in | API only — no button in any panel or app yet |
| External API | remove.bg (API key required) |
| Max Image Size | 5MB |
| Output | PNG with white background |
| Setup | Enter remove.bg API key in AI Settings |
Phase 3 — Smart Commerce
Intelligent search and recommendation systems that boost discovery and conversions.
Smart NLP Search
A natural-language query — "blue cotton shirt under 500 for men" — is parsed by Claude into structured filters (keywords, price range, color, brand, category, sort order) and run against the catalogue. The parser ships as an endpoint: the theme search bars and the app's search screen still use the ordinary keyword search, so you reach it through the API or your own wiring.
| Available in | API only — not wired into the theme search bars or the app search screen |
| Input | Natural language search query (max 200 chars) |
| Parsed Filters | keywords, min_price, max_price, color, brand, category, sort |
| Prices | Read in your store's default currency — "under 500" means 500 of whatever the catalogue is priced in |
| Cache | 5 minutes per unique query |
| Fallback | Regular keyword search if AI disabled |
| API Key Required | Yes (Claude) |
| API Endpoint | POST /api/v1/ai/smart-search |
Product Recommendations Engine
Four recommendation algorithms — all database-driven (no AI API calls).
| Frequently Bought Together | Co-purchase analysis from order history — product detail pages on all 3 themes, and the customer app |
| Similar Products | Same category + similar price range — product detail pages on all 3 themes, and the customer app |
| Trending Now | Most ordered products in the last 30 days — homepage on the Classic theme and in the customer app |
| Personalized | Based on the customer's purchase history categories. It needs a signed-in shopper, so it is served by the website endpoint only; no theme places it on a page yet, and the app's request is unauthenticated and comes back as the last 14 days' trending products. |
| Cache | 60 minutes (frequently bought together), 30 minutes (trending, personalized); similar products is computed per request |
| API Key Required | No (database queries only) |
| API Endpoints | GET /api/v1/ai/recommendations/fbt/{id}GET /api/v1/ai/recommendations/similar/{id}GET /api/v1/ai/recommendations/trendingGET /api/v1/ai/recommendations/personalized |
Phase 4 — Business Intelligence
AI-powered pricing, delivery prediction, and discount optimization tools for smarter business decisions.
Smart Delivery ETA
Predicts delivery time from the store's own past deliveries, adjusted by haversine distance, vendor performance, and the day of the week. It is arithmetic on your order history, not a trained model.
| Shown on | Product detail page on the Classic and Modern themes; on Semi-Classic only for a signed-in shopper with a saved address (it has no guest location prompt). The customer app shows it on product pages too. It is on unless Delivery ETA is switched off on the AI Settings page, and the storefront and the app both follow that switch. |
| Logged-in Users | Uses saved shipping address (server-side, instant) |
| Guest Users | Browser geolocation prompt (client-side AJAX) |
| Distance Factors | <5km: 0.8x, <20km: 1.0x, <50km: 1.3x, <200km: 1.6x, >200km: 2.0x |
| Weekend Factor | Saturday/Sunday: 1.15x slower |
| Display | "1-2 Days (18.6 km away)" in green |
| API Key Required | No (historical data + math) |
| On/off switch | None — it has no toggle on the AI Settings page |
Pricing Suggestions
Click "AI Price" on the admin Add Product form. Analyzes all products in the same category and returns median price, average, min/max range, and competitive range (P25-P75).
| Trigger | Button next to the unit price field on the admin Add Product form — it is not on the edit form or in the vendor panel |
| Platforms | Admin Add Product form, Vendor App, Store App, and the API |
| Output | Suggested price, average, range, competitor count |
| Auto-fill | Fills unit price field if empty |
| API Key Required | No (database queries only) |
| On/off switch | None of its own — the button appears only while AI Product Descriptions is switched on |
Discount Optimizer
Analyzes product metrics (views, sales, conversion rate, stock levels, days since last sale) and suggests an optimal discount percentage. Uses Claude API or falls back to rule-based engine.
| Available in | Vendor App and Store App, and over the API — there is no button in the admin or vendor web panel |
| Metrics Analyzed | Views, sales, conversion %, stock, days listed, days since last sale |
| Output | Suggested discount (0-50%), reasoning, urgency level |
| Fallback | Rule-based engine if no API key |
| API Key Required | Optional (works without, better with) |
| On/off switch | None — it has no toggle on the AI Settings page |
Phase 5 — Advanced Features
Visual search, sales forecasting, and fraud detection for enterprise-grade intelligence.
Visual Search
A mobile-app feature: the shopper taps the scan icon in the customer app's search screen and picks a photo → Claude Vision identifies the product type, color, material, and style → the catalog is searched for matching products. There is no photo search on the website in any theme.
| Available in | Customer app (scan icon in the search screen), and over the API |
| Input | Product photo (JPEG/PNG/WebP, max 5MB) |
| AI Analysis | Product type, color, material, style, search query |
| Output | Up to 12 matching products |
| API Key Required | Yes (Claude Vision) |
| API Endpoint | POST /api/v1/ai/visual-search |
Sales Forecasting Dashboard
Admin page showing 7-day revenue and order predictions with growth trends, daily breakdown table, and low-stock alerts. Built from a trailing average of the last 30 days, a weekday pattern, and a damped growth rate.
| Location | Admin Panel → System Settings → Sales Forecast |
| Predictions | Revenue, orders, growth rate per day |
| Stock Alerts | Products predicted to run out within 7 days |
| Data Source | Last 30 days of order history |
| Cache | 30 minutes |
| API Key Required | No (historical data analysis) |
Fraud Detection
Scores every order on 7 risk factors and flags suspicious orders for admin review. Accessible from Admin Panel sidebar; the page is always available to the admin.
| Location | Admin Panel → System Settings → Fraud Alerts |
| Risk Factors (7) | New account + high value, multiple addresses, amount anomaly, unusual hours (2-5AM), guest + high value, rapid repeat orders, mismatched billing/shipping |
| Scoring | 0-100 score → Low (<25), Medium (25-49), High (50+) |
| Scan Range | Last 72 hours of orders |
| API Key Required | No (rule-based scoring) |
API Reference
The AI features the mobile apps use are exposed over REST. The tables below list exactly what each app can call.
Customer App (v1) — /api/v1/ai/
| Method | Endpoint | Auth | Purpose |
|---|---|---|---|
POST | /ai/chatbot | No | Shopping assistant chat (answers as a guest — no order tracking) |
GET | /ai/review-summary/{productId} | No | AI review digest |
POST | /ai/smart-search | No | Natural language search |
POST | /ai/visual-search | No | Image-based product search |
GET | /ai/recommendations/fbt/{id} | No | Frequently bought together |
GET | /ai/recommendations/similar/{id} | No | Similar products |
GET | /ai/recommendations/trending | No | Trending products |
GET | /ai/recommendations/personalized | No | Personalized picks |
POST | /ai/delivery-eta | No | Delivery estimate for a location |
Which features the customer app shows
A feature switched off is refused with 403, so the app asks first: GET /api/v1/config carries ai_features — chatbot, delivery_eta, review_summary, smart_search and visual_search, each true or false. The app shows the assistant button, the delivery estimate, the review summary and the visual-search scan button only while theirs is on. A backend that sends no ai_features counts as everything on.
Vendor App (v3) — /api/v3/seller/ai/
| Method | Endpoint | Auth | Purpose |
|---|---|---|---|
GET | /ai/status | Seller | Get AI feature toggles |
POST | /ai/generate-description | Seller | Generate product description |
POST | /ai/suggest-category | Seller | Auto-categorize |
POST | /ai/generate-tags | Seller | Generate tags from image |
POST | /ai/suggest-pricing | Seller | Competitive pricing |
POST | /ai/suggest-discount | Seller | Discount recommendation |
Store App (v4) — /api/v4/ai/
| Method | Endpoint | Auth | Purpose |
|---|---|---|---|
GET | /ai/status | No | Get AI feature toggles |
POST | /ai/generate-description | Store | Generate product description |
POST | /ai/suggest-category | Store | Auto-categorize |
POST | /ai/generate-tags | Store | Generate tags from image |
POST | /ai/suggest-pricing | Store | Competitive pricing |
POST | /ai/suggest-discount | Store | Discount recommendation |
AI Settings Configuration
| Setting | Default | Description |
|---|---|---|
ai_features_enabled | ON | Master switch — off stops every feature that calls Claude |
ai_anthropic_api_key | — | Claude API key from console.anthropic.com |
ai_removebg_api_key | — | remove.bg API key (background removal only) |
ai_product_description | ON | AI product descriptions (and the meta description button) |
ai_auto_categorization | ON | Auto-categorization |
ai_auto_tagging | ON | Auto image tagging |
ai_review_summary | ON | Review summarization |
ai_background_removal | OFF | Background removal |
ai_chatbot | ON | Shopping assistant chatbot |
ai_smart_search | ON | NLP smart search |
ai_recommendations | ON | Product recommendations (no API key needed) |
ai_visual_search | ON | Visual search |
ai_delivery_eta | ON | Smart delivery ETA (on until switched off; no API key needed) |
ai_fraud_detection | ON | Listed on the settings screen; the Fraud Alerts page is available to the admin either way |
A fresh install ships with the master switch and ten of the eleven features on, and Background Removal off — nothing calls Claude until you save an API key. Pricing Suggestions, the Discount Optimizer and Sales Forecasting have no switch on this screen; they read your own data and are always available.
Cost Estimation
| Feature | API Calls/Day (Est.) | Monthly Cost (Est.) |
|---|---|---|
| Product Descriptions (each meta description is a second call) | 10-50 | $2-10 |
| Auto-Categorization | 10-50 | $1-5 |
| Auto-Tagging (Vision) | 10-50 | $3-15 |
| Review Summarization | 5-20 | $2-8 |
| Chatbot | 50-500 | $10-100 |
| Smart Search | 50-500 | $5-50 |
| Visual Search (Vision) | 10-50 | $3-15 |
| Discount Optimizer | 5-20 | $1-3 |
| Recommendations | — | $0 (no API calls) |
| Delivery ETA | — | $0 (no API calls) |
| Sales Forecast | — | $0 (no API calls) |
| Fraud Detection | — | $0 (no API calls) |
| Total | $27-206/month |
Background Removal uses remove.bg API: $0.20/image (first 50 free/month).