AI Cloud Suite
1. What is Visualwebs AI Cloud Suite?
Visualwebs AI Cloud Suite connects your WordPress/WooCommerce/Shopify store to the Visualwebs SaaS platform.
The plugin/App acts as a secure connector: it handles API authentication, private feed generation, chatbot embedding, and SmartPricing integration.
All advanced configuration, dashboards, and business logic now live in the SaaS dashboard.
2. Quick Start
- Install and activate the plugin in WordPress/Magento/Shopify App.
- Create an store in Saas, select the platform that matches and save changes.
- Go to AI Cloud Suite > Settings and enter your Visualwebs Store ID and API Key (get it from your the Saas store just created).
- For SmartPricing: generate your Integration Token in WordPress and copy it to your SaaS dashboard.
- In the SaaS dashboard, connect your store using the Integration Token (Rest API token). For WP sites, fill the WooCommerce REST API Credentials section.
- If you plan integrate SOS Inventory, fill the token in the saas store config, and save changes.
- Run or verify feed generation (products, pages, sales, insights) so the SaaS platform can read your data.
- Manage all advanced features, dashboards, and business rules from the SaaS dashboard.
Shopify install
- Go to Shopify markeplace and search “Visualwebs AI Cloud Suite”.
- Install, accept permissions and you can see a simple panel with a link “Go to Dashboard”. You can manage your subscription from here.
Magento
- Put your Magento in maintenance mode
bin/magento maintenance:enable
- Make a backup dumping your database
mysqldump --no-tablespaces -u username -p databasename > backup.sql
Install via composer
- If you’re installing Magento AI Cloud Suite use, run this command from Magento root installation.
composer require visualwebs/magento2-ai-cloud-suite
Final step
- Run Magento setup upgrade command
bin/magento setup:upgrade
- Re-compile Magento system
php -d memory_limit=-1 bin/magento setup:di:compile;
php -d memory_limit=-1 bin/magento setup:static-content:deploy;
- Disable maintenance mode
bin/magento maintenance:disable
AI Cloud Suite Configuration (Magento Admin)
- Path: Stores > Configuration > Visualwebs > AI Cloud Suite
- Purpose: Configure SaaS connection, workflows, chatbot, and SmartPricing features.
1) AI Cloud Suite Access
- Subscription & Dashboard: Quick access panel to open the subscription page and SaaS dashboard.
- Use case: Activate plan, manage account, and access cloud tools.
2) Visualwebs ML API
- Enable Visualwebs ML Services: Master switch for remote AI services.
- Visualwebs API Key: Authentication key used to connect Magento with SaaS.
- Store ID (SaaS): Unique store UUID used to map this Magento store in SaaS.
- Blog Source: Select which blog extension is used as blog feed source:
- Magefan Blog
- Mageplaza Blog
- Amasty Blog Pro
- Test Connection: Verifies API Key + Store ID connectivity.
3) Workflow Integration
- Enable Workflows: Enables forwarding selected Magento events to automations.
- Enabled Events: Multi-select list of events that will trigger workflows.
- Anonymize Workflow Payload: Removes personal data from event payloads for privacy/GDPR-oriented setups.
Workflow Events Available
- Order Created
- Order Updated
- Invoice Paid
- Shipment Created
- Credit Memo Created
- Customer Registered
- Customer Login
- Customer Logout
- Customer Profile Updated
- Product Saved
- Product Deleted
- Category Saved
- Category Deleted
- Cart Updated
- Product Added to Cart
- Checkout Completed
- Newsletter Subscription
- Newsletter Unsubscription
- Review Saved
- Admin User Saved
- Admin Login Failed
4) ChatGPT
- Enable Chat Widget in Frontend: Shows chatbot on storefront pages.
- Enable Chatbot in Admin: Shows chatbot inside Magento admin panel.
5) SmartPricing AI
- Enable SmartPricing AI: Activates AI-based pricing optimization.
- Auto-Apply Predicted Prices:
- Yes: Predicted prices are applied automatically.
- No: Predictions are stored; application is manual.
Recommended Setup Order
- Enable Visualwebs ML Services
- Enter API Key
- Enter Store ID
- Run Test Connection
- Select Blog Source (if blog sync is used)
- Enable Workflows and choose events (optional)
- Configure ChatGPT options (optional)
- Enable SmartPricing and choose auto-apply mode
WordPress
Visualwebs AI Cloud Suite for WordPress
Visualwebs AI Cloud Suite integrates chatbot, semantic search, SmartPricing AI, and event automation in WooCommerce/WordPress.
The plugin connects to the SaaS platform for AI processing and data synchronization.
Technical Requirements
- WordPress 6.2 or higher (tested up to 7.0).
- PHP 7.4 or higher.
- WooCommerce enabled (required for e-commerce features).
- Redux Framework enabled (required for settings panel).
- AI Cloud Suite account with API Key and Store ID.
Installation and Activation
- Upload the plugin folder to /wp-content/plugins/.
- Activate the plugin from the Plugins page in WordPress.
- Make sure Redux Framework and WooCommerce are active.
- Go to AI Cloud Suite > Settings and fill API Key + Store ID.
- Use Test Connection to validate SaaS connectivity.
WordPress Admin Structure
- Dashboard: overall status, quick links, and security checks.
- Settings: base service, API, and module configuration.
- Feed Generation: manual feed triggers and feed file protection checks.
- Integration Token: secure token for SaaS-to-WordPress prediction imports.
Recommended Configuration
- Enable Extension Options > Enabled.
- Enable API > api_enabled and provide API Key + Store ID.
- Generate Integration Token and copy it to your SaaS dashboard.
- Enable ChatGPT > chatbot_enabled for frontend widget rendering.
- Enable Workflow Integration only if you need event delivery to n8n/SaaS.
- Enable SmartPricing AI only when your environment is ready (COGS + sales data).
Available Feeds
The plugin generates and exposes private feeds for SaaS consumption:
- products: full product catalog (attributes, stock, prices, images).
- pages: published pages normalized for semantic search.
- blog: blog posts for semantic blog sync.
- sales: historical sales data for SmartPricing training.
- insights: KPI and dashboard metrics.
Automatic Feed Schedule (Cron)
- Product feed: hourly.
- Page feed: daily (around 02:00).
- Sales feed: daily (around 02:00).
- Insights feed: daily (around 03:00).
- Blog feed: daily (around 04:00).
You can also disable WP-Cron and run feed generation using system cron + WP-CLI for better production reliability.
Plugin REST API
Base namespace: /wp-json/visualwebs-ml/v1
- GET /feed/products
- GET /feed/pages
- GET /feed/blog
- GET /feed/sales
- GET /feed/insights
- POST /pricing/import (price prediction import).
- GET /chat-api/callback
- POST /chat-api/call
- POST /ml-api/call
Authentication and Security
- Feeds require a valid X-Store-API-Key header.
- Prediction import and SaaS-origin endpoints require X-Store-Token (Integration Token).
- Without valid credentials, endpoints return 401/403.
- Feeds are stored in a private uploads directory and should be protected with .htaccess.
- Recommended .htaccess rule:
Order Deny,Allow Deny from all
SmartPricing AI Workflow
- Enable SmartPricing AI in plugin settings.
- Ensure enough sales/cost data for model training.
- The system builds dataset files and requests training/prediction from AI services.
- SaaS sends predictions to the pricing import endpoint.
- If auto-apply is enabled, product prices are updated automatically.
- If auto-apply is disabled, predictions are stored but not applied to prices.
Workflow Integration (WooCommerce/WordPress Events)
If Workflow Integration is enabled, events can be dispatched to SaaS/n8n:
- New order.
- Order status changed.
- User registration.
- Product created/updated.
- Includes short-window deduplication for bursty hook activity.
- Supports GDPR-oriented payload anonymization.
- Allows enabling/disabling individual events from settings.
Chatbot Widget
- Can be rendered on frontend and optionally in wp-admin.
- Loads dynamic branding/style config from SaaS and session context from WordPress.
- Compatible with functional-consent category handling (non-marketing).
Troubleshooting
- Connection failed: check API Key, Store ID, and Test Connection button.
- 401/403 on feed endpoints: validate X-Store-API-Key header.
- 403 on pricing/import: validate X-Store-Token and Integration Token setup.
- Feeds are not generated: verify service is enabled and credentials are configured.
- Cron not running on hosting: use WP-CLI with system cron.
- SmartPricing not applying prices: verify COGS support and auto-replace setting.
Production Best Practices
- Do not expose API keys or tokens in public logs.
- Rotate Integration Token if compromise is suspected.
- Audit access attempts to private endpoints periodically.
- Monitor cron execution and feed generation consistency.
- Validate updates in staging before production rollout.
3. AI Insights
- This video showcases how Visualwebs AI Cloud Suite delivers intelligent analytics and predictive insights to enhance your business decisions.
You’ll see how to navigate key features like sales forecasts, product trends, and conversation analysis to unlock valuable data.
Click the “AI Insights” panel showing intelligent analytics and predictions powered by AI, including the 30-day sales forecast based on historical data points. This helps you anticipate future sales trends.
Click “Bestsellers Trends (4 top products)” to analyze the top-performing products and understand their sales patterns. This insight helps prioritize inventory and marketing efforts.
Click “Spam Detection” to view and manage unwanted or irrelevant messages automatically identified by the system.
Click “Sentiment Analysis” to view the trend of your customer reviews.
4. Chatbot
- The plugin embeds a customizable AI-powered chatbot on your store.
- The chatbot can answer about products, pages, categories, and order/shipping info.
- All advanced chatbot configuration (personality, context, logo, colors) is managed from the SaaS dashboard.
- For semantic search, the plugin generates and syncs product/page feeds to the SaaS.
5. SmartPricing
- SmartPricing analyzes your sales data and recommends optimal prices to maximize profit.
- Requirements:
- WooCommerce: Enable “Cost of Goods Sold” in WooCommerce > Advanced > Features and fill in product costs.
- Magento: Make sure product cost is set.
- Steps:
- Generate your Integration Token in WordPress.
- Paste the token in your SaaS dashboard (Store Settings > WordPress Integration Token).
- The SaaS will fetch your sales/products feeds and start training.
- Review and apply price recommendations from the SaaS dashboard.
6. Workflows
- First enable workflows in Magento/Woo and select the events you want to listen. In Shopify you can do from Saas->store config.
- In Saas, check the section Events and you see how the desired events are being tracked.
- Depending of your Plan, you can request to support to develop a custom workflow for your events.
7. SOS Inventory
- First get your token in the Sos Inventory website.
- In Saas, fill the token in the store config.
- Enable your preferences, sync only stock, both orders and stock or set it fully OFF.
- Orders can start sync from a given date, from Order ID or the entire history.
8. Security
- All API communication is secured with your Visualwebs API Key and Integration Token.
- Feeds are private and require a valid
X-Store-API-Keyfor access. - No sensitive data is exposed publicly.
- Only the SaaS platform can access and process your store data.
9. Feed Generation
Feed generation is automatic across all supported platforms through their connectors: WordPress plugin (WooCommerce), Magento extension, and Shopify app. In normal operation, manual execution is not required.
For technical or troubleshooting scenarios, you can run feed generation commands manually:
WordPress (WP-CLI)
- wp visualwebs-ml generate-all-feeds
- wp visualwebs-ml generate-product-feed
- wp visualwebs-ml generate-page-feed
- wp visualwebs-ml generate-blog-feed
- wp visualwebs-ml generate-sales-feed
- wp visualwebs-ml generate-insights-feed
Magento (bin/magento)
- bin/magento visualwebs:ml:generate-product-feed
- bin/magento visualwebs:ml:generate-page-feed
- bin/magento visualwebs:ml:generate-blog-feed
- bin/magento visualwebs:ml:generate-sales-feed
- bin/magento visualwebs:ml:generate-insights-feed
Shopify note: feed updates are handled automatically by the Shopify app integration.
10. Advanced / Legacy Options
- OpenAI and Pinecone API keys are only needed for advanced or legacy setups.
- Most users do NOT need to configure these; the SaaS platform handles all AI and vector operations.
- Manual semantic grid management and backend widgets are deprecated and replaced by SaaS dashboards.
- n8n integration is now managed from the SaaS dashboard.
11. WordPress vs SaaS Responsibilities
Platform Responsibilities (WordPress, Magento, Shopify) vs SaaS
Visualwebs AI Cloud Suite is not limited to WordPress.
It currently supports three e-commerce channels:
WooCommerce, Magento, and Shopify.
Supported Channels
| Channel | Integration Type | Status | Connection Scope |
|---|---|---|---|
| WooCommerce | WordPress Plugin | Available | WordPress + SaaS |
| Magento | Magento Module | Available | Magento + SaaS |
| Shopify | Shopify App | Available | Shopify + SaaS |
Responsibility Matrix
| Feature | WooCommerce (WP Plugin) | Magento (Module) | Shopify (App) | Visualwebs SaaS |
|---|---|---|---|---|
| Connector installation | Yes | Yes | Yes | No |
| Initial authentication (API Key / Token) | Yes | Yes | Yes | Yes (validation) |
| Catalog and order synchronization | Trigger / data source | Trigger / data source | Trigger / data source | Central processing |
| Business dashboards | No | No | No | Yes |
| SmartPricing rules | No | No | No | Yes |
| Automations (workflows/n8n) | No | No | No | Yes |
| AI (predictions/recommendations) | No | No | No | Yes |
| Chatbot embed in storefront | Yes | Yes | Yes | Yes (orchestration) |
| Security and credential management | Partial | Partial | Partial | Centralized |
Operational Summary
The connectors (WordPress plugin, Magento module, and Shopify app) handle store-level integration.
Business logic, analytics, AI, automations, and data governance are centralized in the Visualwebs SaaS platform.
