Trill AI Product Chat for WooCommerce

FAQ

Do I need a WooCommerce store to use this plugin?

Yes. Trill AI Chat Lite is a WooCommerce AI shopping assistant — it reads your WooCommerce product catalogue, your published pages, the current cart and the order history to answer shopper questions. It will not do anything useful on a WordPress site without WooCommerce installed and active.

Do I need an OpenAI or Anthropic API key?

No. We manage the AI infrastructure via Trill Cloud — you do not need to create an account with OpenAI, Anthropic or any other provider. Just install, activate and go.

How does the cart-aware feature work?

On every chat turn the plugin reads the visitor’s WooCommerce cart (items, quantities, line totals, cart subtotal and total) and injects a compact summary into the AI’s context. Robin can then answer “what’s in my cart”, “what’s my total”, or “help me checkout” using real cart state — no hallucination, no asking the shopper to repeat what they already added. The cart context is sent fresh on every message, so it stays accurate even if the visitor adds or removes items mid-conversation.

How is order tracking kept private?

For registered customers, identity is verified through their WordPress login — they only see orders bound to their wp_users.ID. For guests, the plugin requires both the order number and an email that matches the order’s billing email. A mismatch silently falls through to “I need to verify your email” instead of confirming or denying the order’s existence, so the plugin never leaks order data to an unverified caller.

How is the lead capture consent stored?

When Robin offers to take the visitor’s email (out-of-stock notification, price-drop alert, etc.) the exact consent line shown to the visitor is snapshotted into the wp_trcl_leads row alongside the email. If a future DSAR challenges the legitimate-interest basis the merchant can show what the visitor agreed to, verbatim, at capture time. Leads are managed from the Trill Chat → Leads admin page with CSV export.

How are orders attributed to chat conversations?

When woocommerce_thankyou fires, the plugin records an order_completed event and looks up any chat_started events that share the same WooCommerce session customer ID within the last 24 hours. On a match, an order_attributed event is written linking the order to the chat session. The dashboard then surfaces “Orders from chat” and “Revenue from chat” KPIs over a configurable 7/30/90-day window.

How many conversations does the plugin include?

The plugin includes a generous monthly conversation allowance, enforced server-side. Your admin dashboard shows a usage counter so you can track how many conversations you have used each calendar month.

What happens when I exceed the monthly conversation quota?

The chat widget remains visible but new shopper conversations are paused until the quota resets at the start of the next calendar month.

How do I add AI chat to my WooCommerce store?

Install Trill AI Chat Lite from the WordPress plugin directory, activate it, and open Trill Chat → Dashboard. The chat widget appears automatically on every page of your store. No API keys, no OpenAI account, no prompt engineering required — the plugin is ready in under 5 minutes.

Is Trill AI Chat Lite GDPR-compliant?

Yes, fully wired in. Greensolutions Pioneers Limited is a UK-registered company (Companies House 15693716) subject to UK GDPR and EU GDPR. The plugin auto-registers with WordPress’s native Tools → Export Personal Data (DSAR) and Tools → Erase Personal Data (right to be forgotten) — so any data subject request from a visitor flows through the standard WP admin, with conversations + messages + leads cascaded automatically. Retention is configurable (default 365 days, clamped 7-3650). All messages are transmitted over HTTPS. No IP addresses are ever persisted. Chat data is never used to train AI models. See our Privacy Policy for full details.

Does it work with HPOS (High-Performance Order Storage)?

Yes. Trill AI Chat Lite fully declares compatibility with WooCommerce HPOS / Custom Order Tables.

Does it work with variable and grouped products?

Yes. Product cards display variable products with a price range and a “View” button that links to the product page, where shoppers can select their variation before adding to cart. Simple products use direct AJAX “Add to Cart”.

Does it work with any WooCommerce theme?

Yes. The chat widget is rendered as a fixed-position overlay and works with any properly coded WooCommerce theme. It has been tested with Storefront, Astra, Flatsome, OceanWP and Kadence.

Can I customise the chat widget appearance?

Yes. Go to Trill Chat → Settings to change the widget colour (any hex value), position (bottom-right or bottom-left) and welcome message. The widget adapts to your chosen brand colour automatically.

Does the AI see my customer data?

The AI processes the chat messages a shopper sends and the product catalogue context needed to answer (product names, prices, descriptions, stock). No personal visitor data is collected or stored by the external service beyond what is strictly necessary to process each individual message. Chat data is never used for AI training.

Does it support multiple languages?

The widget interface is in UK English by default. The AI can understand and respond in many languages (Spanish, French, German, Italian, Portuguese and others). The plugin is fully translation-ready with a .pot file and works with Loco Translate, WPML and other translation tools.

Can I embed the chat on a specific page instead of the whole site?

Yes. Use the [trill_chat] shortcode to place a chat trigger on any page or post. Supports attributes: [trill_chat style="button" button_text="Ask Robin"].

Can I remove the “Powered by Trill AI” badge?

The badge is opt-in and off by default. It only appears if you explicitly enable it in Settings, fully complying with WordPress.org plugin guidelines. There is nothing to remove unless you have turned it on.

What happens if I have another Trill AI plugin installed?

This plugin automatically detects a conflicting Trill AI build (e.g. a legacy full-featured edition) and deactivates itself to prevent conflicts. You only need one version active at a time.

Does the plugin integrate with the WordPress Abilities API?

Yes, on WordPress 7.0 and higher. The plugin registers three abilities under the trill-ai/ namespace in the ecommerce category:

• trill-ai/search-products — search the WooCommerce catalogue (input: query, optional limit 1-10). Public read access (mirrors wc_get_products()).
• trill-ai/get-store-context — store metadata: name, currency, product count, top categories. Public read access (mirrors get_bloginfo()).
• trill-ai/get-conversation-summary — last N messages of a chat session by UUID (input: session_id, optional limit 1-50). Administrators (manage_options) always allowed; visitors must pass a valid UUID, matching the existing /wp-json/trcl/v1/conversation/{session_id} REST endpoint posture.

Example usage from another plugin or theme:

$ability = wp_get_ability( 'trill-ai/search-products' );
if ( $ability ) {
    $results = $ability->execute( [ 'query' => 'blue t-shirt', 'limit' => 5 ] );
}

On WordPress 6.x the abilities simply do not register and the rest of the plugin works as normal.

I found a bug or have a feature request.

Use the WordPress.org support forum or email hello@trillai.io. We read every message.