TWWIM AI: Voice-to-Action AI Agent for WooCommerce and WordPress

TWWIM AI is an AI assistant for WordPress and WooCommerce sites. Visitors type or speak what they want, and the plugin does it on the page. It navigates to the right category, filters products, opens an article, adds a product to the cart, or answers a question about your catalogue in the language the visitor used. A normal chatbot replies with text. TWWIM AI replies with text and also performs the action the visitor asked for. What a visitor can do

• Say or type "show me red running shoes under 80 euros" and land on the filtered product list.
• Say "add the black one to my cart" on a product page. The plugin picks the right variation and adds it.
• Ask about products, shipping, returns, or policies. The answers come from your own site content.
• Navigate hands-free: "go to checkout", "open the FAQ", "scroll to reviews". Useful for touchscreens, kiosks, and visitors who can't type easily.
• Skip filter menus on a phone. Speaking a request replaces the dropdowns, sliders, and filter chips that are awkward to use on a small screen.
• Use whatever language they prefer. The reply comes back in the same language.

On mobile Mobile shopping is where filters and faceted search get painful. Dropdowns cover half the screen, tap targets are small, typing a precise query on a soft keyboard is slow, and opening filters, picking values, and closing them again takes five or six taps. A visitor on their phone can instead say "black kitchen aprons under 25 euros, organic cotton" and land on the filtered list. One sentence replaces a handful of tap-throughs, which matters most on long-tail catalogues where the right product is buried four filters deep. How it differs from a normal chatbot

• It maps a spoken or typed request to a concrete on-page action, instead of stopping at a text reply.
• It reads from your own catalogue and pages, so it does not invent information.
• Input can be voice or text. Output is text. There is no synthesised voice talking back.

WooCommerce integration When WooCommerce is active, the plugin adds:

• Automatic catalogue sync. On activation and on every product create, update or delete, the plugin sends product data (title, description, price, stock, SKU, categories, attributes, variations, images, URL) to your TWWIM AI knowledge base. No customer data and no order data is sent.
• Product-aware answers. Questions like "do you have this in size 42" or "is this vegan" are answered against the products you have synced.
• Variation handling. Variable products (colour, size, plan length) are resolved before a cart action.
• Category and filter navigation. A spoken request maps to the correct WooCommerce category URL with the right attribute filters applied.
• Stock awareness. If an item is out of stock, the reply says so and points to alternatives from the same category.

What you get as a store owner

• Visitors who don't know the exact search term still land on the right product.
• Routine questions about shipping, returns, sizing and availability are handled from your own content, without a support ticket.
• Voice input and text output help visitors who can't type or prefer not to.
• A mobile shopping flow that does not rely on cramped filter UIs. Visitors describe what they want in one sentence instead of tapping through a filter drawer.
• One storefront that serves visitors in their own language, without a separate FAQ per locale.
• An admin dashboard embedded in WP admin for account, subscription, widget settings, and catalogue sync status.

Plugin features

• Voice and text input. Text replies. Floating widget on public pages.
• Automatic DOM and catalogue understanding. No manual content mapping.
• Widget position configurable (bottom-right, bottom-left, top-right, top-left).
• Per-page exclusion by page or post ID.
• WooCommerce product sync on create, update, delete.
• Admin dashboard embedded in WP admin (account, subscription, settings, sync status).
• One-click enable and disable.
• Custom CDN URL for enterprise setups.

How it works

1. Install and activate the plugin.
2. Open TWWIM AI in the WordPress admin sidebar, register or sign in, and create a tenant for this website. Creating the tenant generates the integration keys.
3. The plugin picks up the keys and injects a small script into your site's <head> automatically. If WooCommerce is active, it also starts syncing your products to your TWWIM AI knowledge base.
4. Visitors see a floating widget. They speak or type what they want.
5. The plugin works out the intent, reads from your catalogue and pages, and either replies in text or performs the action on the current page.

Requirements

• WordPress 6.0 or higher.
• PHP 8.0 or higher.
• WooCommerce 8.0 or higher for catalogue sync and cart actions. Optional. The widget works on any WordPress site.

You do not need a TWWIM AI account before installing. After activation, open TWWIM AI in the WordPress admin, register or sign in, and create a tenant for this website. Creating the tenant generates your integration keys and the plugin starts injecting the assistant script on your frontend automatically.

1. In WordPress admin, go to Plugins → Add New, search for TWWIM AI, click Install Now, then click Activate.
2. A TWWIM AI menu item appears in the WordPress admin sidebar.
3. Open TWWIM AI in the sidebar. Register a new account or sign in if you already have one.
4. From the embedded dashboard, create a tenant for this website. Creating the tenant generates your integration keys. The plugin picks them up and starts injecting the assistant script on your frontend automatically.

Adjusting the widget From the Settings screen you can toggle the widget on/off, change its dock position, or hide it on specific pages by entering comma-separated page or post IDs in the "Exclude Pages" field.

1.3.2

• Fixed: the frontend widget was invisible on sites using caching or minification plugins that self-host external JavaScript (WP-Optimize "Include external files", WP Rocket, Autoptimize, LiteSpeed Cache, Cloudflare Rocket Loader, etc.). Those plugins rewrote the widget script URL to a local cached copy without copying the widget's code-split chunks, so the loader 404'd on first import and the widget never rendered. The widget is now injected into the DOM at runtime via a tiny inline bootstrap, which HTML-scanning optimizers cannot see or rewrite. No settings change is needed — the fix is automatic on upgrade.

1.3.1

• Fixed: the Terms of Service / Privacy Policy consent checkbox on the in-plugin registration form was rendered with an almost-invisible border on some admin colour schemes. Now uses an explicit visible border and the native accent colour for the checked state.

1.3.0

• WooCommerce feature compatibility declared (custom_order_tables / cart_checkout_blocks / product_block_editor) — silences the "incompatible plugins" admin notice on modern WooCommerce setups. Plugin reads product data only; no order, cart/checkout or product-editor surfaces are touched.
• Registration form now requires explicit acceptance of Terms of Service and Privacy Policy via an inline checkbox with localised legal links (EN/DE).
• Admin notices (WooCommerce warnings, theme messages, updates nags) no longer push the embedded dashboard out of the viewport — they stack as toasts at the top-right of the TWWIM AI admin page so the SPA keeps its full height.
• Sidebar user profile and language switcher are no longer clipped below the WP admin bar — layout now correctly caps the embedded SPA inside the available viewport regardless of Tailwind min-h-screen rules.
• Admin stylesheet (admin-layout.css) is now cache-busted by file modification time so iterative CSS updates are picked up without manual browser cache-busting.
• Knowledge page no longer crashes when the URL carries a stale or malformed tenant id — the route self-heals by falling back to the first available tenant.

1.2.2

• Plugin listing refreshed: positioned as a Voice-to-Action AI agent for WooCommerce and WordPress. Expanded Description with WooCommerce integration details, mobile-first benefit section, and what store owners gain.
• Installation instructions updated to reflect the in-plugin registration and tenant-creation flow. No external sign-up step. Integration key is generated when the tenant is created and picked up by the plugin automatically.
• External services disclosures tightened: removed internal service-name labels, consolidated to TWWIM AI and Stripe entries.
• No functional code changes.

1.2.1

• Plugin slug aligned with text domain (twwim-ai) — resolves Plugin Check TextDomainMismatch errors.
• Renamed all internal PHP classes, constants, and helper functions to the Twwim_ / TWWIM_AI_ / twwim_ai_ prefix. Legacy Archer_ identifiers removed.
• Frontend widget now emits <script id="twwim-config"> (legacy #archer-config still accepted by the CDN bundle for backward compatibility).
• Admin dashboard JS global renamed to window.twwimAi (legacy window.archerAi alias emitted for bundles predating the rename).
• Hardened REST POST /twwim/v1/settings with per-field validation (URL validation via esc_url_raw, enum whitelist for dock position, boolean/CSV-ID validation) and is_array() guard on the request body.
• Sanitized $_SERVER and apache_request_headers() fallbacks in the sync-secret auth path (sanitize_text_field( wp_unslash(...) )).
• uninstall.php now cleans up four previously-missed options (twwim_api_url, twwim_tenant_id, twwim_sync_secret, twwim_wc_missing) and uses prefixed globals ($twwim_options, $twwim_option).

1.2.0

• Admin stylesheets moved to external CSS files (assets/admin-menu.css, assets/admin-layout.css) and enqueued via wp_enqueue_style() / wp_add_inline_style() — no more raw <style> tags.
• Full dashboard source code bundled under source/ for GPL compliance and WP.org reviewability.
• Expanded == External services == documentation to cover TWWIM AI and Stripe.
• Updated legal URLs to their current locations on twwim.ai (Terms of Service, Privacy Policy, GDPR).
• Contributor handle corrected to the WordPress.org account owning this plugin.

0.1.0

• Initial release
• AI voice and text assistant widget injection on frontend pages
• Admin dashboard (React SPA) embedded in WordPress admin panel
• REST API for plugin settings (integration key, CDN URL, dock position, DOM indexer, widget toggle, page exclusions)
• Configurable widget dock position
• Per-page widget exclusion by page/post ID
• DOM indexer toggle for automatic page content understanding
• Custom CDN URL support