EcomBot Docs

WooCommerce Plugin

Technical installation and operation of the WooCommerce connector.

EcomBot offers an official connector for WooCommerce. Unlike many plugins that bog down your store, our module is designed with an "Agnostic and Asynchronous" architecture (Pattern Adapter).

Why a Specific Plugin?

1. High-Performance Synchronization (Eager Sync)

The plugin performs no direct or unoptimized SQL queries on your WordPress database. It exposes a REST API (/wp-json/ecombot/v1/catalog-export) specifically designed to paginate your products massively, managing variations and taxonomies without risking a server "Timeout" (504 Error).

2. Serialized Attribute Extraction

The power of AI lies in the details. The plugin does more than synchronize name and price. It includes a custom serializer to bypass the limitations of WooCommerce's WC_Product_Attribute object, allowing it to perfectly extract sizes, materials, and colors, even if they are created as complex taxonomies.

3. Custom Fields Management (ACF)

If you use Advanced Custom Fields (ACF) to enrich your product listings, the EcomBot plugin detects them. It is capable of prioritizing a hidden field specifically written for the AI over the standard public description, giving you total control over "what the bot knows about the product".

Real-Time Webhooks

Once installed, the plugin creates WooCommerce Webhooks that listen to your store's events (product.created, product.updated, product.deleted, order.created).

  • Background Process (WP Cron): These webhooks send a JSON payload to EcomBot servers completely asynchronously via a scheduled task wp_schedule_single_event.
  • Total Traceability: Unlike basic HTTP requests, this background process waits for the SaaS response and logs the exact success or error code.
  • Zero Impact on Sales: When a customer confirms an order on your site, the database commit is not paused waiting for EcomBot's response. The performance of your Sales Funnel remains intact.

Plugin Installation

  1. Go to your EcomBot dashboard, Integrations tab.
  2. Download the official plugin's .zip archive. Note that our secure distribution system (OTA) always guarantees you the latest version via a signed URL.
  3. In your WordPress, go to Plugins > Add New.
  4. Upload the zip file, activate the plugin.
  5. In the left WooCommerce menu, click on EcomBot. Enter the Project ID and Secret Key provided in your SaaS dashboard.

Automatic Widget Display

Starting from version 1.3.11, the plugin manages the display of the Chatbot on your store itself. No more need to modify your theme's source code to inject the installation script.

  • Optimal performance: The script is injected 100% asynchronously (defer attribute) in the header of your site to never slow down visual loading (TTFB).
  • Total control: You have a toggle "Enable Chatbot on the store" directly in the General tab of the plugin settings to hide the virtual assistant in one click if needed.

Diagnostics and Logs (Advanced Settings)

The plugin includes a real-time diagnostic console to analyze exchanges between your WooCommerce and the EcomBot SaaS:

  • Enable Debug Logs: Check this option to force the plugin to record details of payloads sent and server responses (very useful if a product doesn't synchronize).
  • Integrated Console: Read the log file directly from the plugin's settings interface, without having to manipulate files on your server.
  • Auto-cleanup: Configure the log retention period (e.g., 7 days). The plugin will automatically delete old history to save your hosting disk space. You can also clear the console manually with one click.