What the plugin does
The AskThe.bot WordPress plugin includes optional WooCommerce features for storefronts. It can show a site-wide chat bubble, add a product-page Try it on button, and let the assistant search your public product catalog when shoppers ask product questions.
Setup takes a few minutes. You install the same WordPress plugin used for non-WooCommerce sites, connect your AskThe.bot account, pick or create an assistant, and choose which storefront features to show.
Install
Download the current WordPress plugin package: askthebot-wordpress-0.1.0.zip.
This is the same plugin used for standard WordPress sites. WooCommerce features turn on automatically when WooCommerce is active.
- In WordPress Admin, go to Plugins → Add Plugin.
- Click Upload Plugin, choose the downloaded zip, and install it.
- Activate AskThe.bot.
Connect
Open WooCommerce → AskThe.bot and click Connect AskThe.bot. You will sign in to AskThe.bot, then return to WordPress to choose an existing assistant or create a new one for this store.
You can also open the same settings page from Settings → AskThe.bot or from the plugin row's Settings link.
The connection uses OAuth. You do not need to paste agent slugs or API tokens into WordPress.
Choose Storefront Features
After connecting, choose what should appear on your store:
- Chat only — show the AI assistant across the store.
- Try-on only — show try-on on product pages without site-wide chat.
- Chat and try-on — use both together.
Leave the local color and label fields blank to use the styling from your AskThe.bot dashboard. Set them in WordPress only when you want the Woo store to override the dashboard values.
Product-Page Try-On
When try-on is enabled, product pages get a Try it on button near the WooCommerce product gallery. AskThe.bot receives the product image, product URL, product name, and selected variation image when the shopper opens try-on.
The plugin also adds your store domain to the connected assistant's allowed try-on domains during setup.
Catalog Search
The plugin can expose a protected, read-only product search endpoint so the assistant can answer questions like "Do you sell hats?" or "Which one is adjustable?"
The endpoint returns public catalog information only. A generated token protects the endpoint; WordPress stores only a hash of that token, and AskThe.bot stores the raw value as an encrypted agent secret.
Advanced Placement
The default Woo button works for most stores. If you want full control, keep the plugin installed and render your own theme button with data-tryon-trigger, or open the try-on modal with the JavaScript API.
Your theme controls the markup, placement, and styling. AskThe.bot handles the modal and rendering flow.
See try-on install modes, script attributes, and JavaScript API.
Troubleshooting
- Button doesn't appear: confirm Storefront features is set to Chat and try-on or Try-on only.
- "Domain not allowed": reconnect the Woo plugin or add your store domain in agent Profile → Allowed domains.
- Chat works but try-on does not: make sure the selected assistant has try-on enabled and the Woo storefront feature is not set to Chat only.
Back to WordPress docs · embed docs · try-on docs.