{"id":376494,"date":"2026-09-29T15:00:26","date_gmt":"2026-09-29T15:00:26","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/webangon-shop-bot\/"},"modified":"2026-09-29T13:53:24","modified_gmt":"2026-09-29T13:53:24","slug":"webangon-chat-assistant","status":"publish","type":"plugin","link":"https:\/\/nl.wordpress.org\/plugins\/webangon-chat-assistant\/","author":15600099,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"trunk","tested":"7.1.2","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Shopping Assistant Chatbot for WooCommerce","header_author":"Webangon","header_description":"Local WooCommerce shopping assistant. Finds products by budget, colour, size and preference, adds to cart, compares products, quotes your policy pages and approved coupons, tracks buying actions, and never calls an external AI service. Design the chat modal in the admin with a live preview.","assets_banners_color":"b7acd3","last_updated":"2026-09-29 13:53:24","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":25,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.gif":{"filename":"icon-128x128.gif","revision":3719180,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.gif":{"filename":"icon-256x256.gif","revision":3719180,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3719180,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3719180,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3719298,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"meta\":{\"title\":\"Shopping Assistant Chatbot for WooCommerce \\u2013 live preview\",\"description\":\"WooCommerce store with sample products, policy pages and the chat assistant ready on the shop page.\",\"author\":\"webangon\",\"categories\":[\"WooCommerce\",\"Chat\"]},\"landingPage\":\"\\\/shop\\\/\",\"preferredVersions\":{\"php\":\"8.2\",\"wp\":\"latest\"},\"features\":{\"networking\":true},\"login\":true,\"steps\":[{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"woocommerce\"},\"options\":{\"activate\":true}},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"webangon-chat-assistant\"},\"options\":{\"activate\":true}},{\"step\":\"setSiteOptions\",\"options\":{\"blogname\":\"Demo Shoe Store\",\"permalink_structure\":\"\\\/%postname%\\\/\",\"woocommerce_default_country\":\"US:NY\",\"woocommerce_currency\":\"USD\",\"woocommerce_coming_soon\":\"no\",\"woocommerce_task_list_hidden\":\"yes\",\"woocommerce_show_marketplace_suggestions\":\"no\",\"woocommerce_allow_tracking\":\"no\",\"woocommerce_onboarding_profile\":{\"skipped\":true}}},{\"step\":\"runPHP\",\"code\":\"<?php\\nrequire_once '\\\/wordpress\\\/wp-load.php';\\n\\n$cats = array();\\nforeach ( array( 'Sneakers', 'Boots', 'Sandals', 'Accessories' ) as $name ) {\\n\\t$term = term_exists( $name, 'product_cat' );\\n\\tif ( ! $term ) {\\n\\t\\t$term = wp_insert_term( $name, 'product_cat' );\\n\\t}\\n\\t$cats[ $name ] = (int) ( is_array( $term ) ? $term['term_id'] : $term );\\n}\\n\\n$products = array(\\n\\tarray( 'Cloud Runner Sneakers', 'Sneakers', '64.00', '54.00', 'Lightweight, comfortable running sneakers with a cushioned sole. Available in white, black and blue.' ),\\n\\tarray( 'Soft Walk Sneakers', 'Sneakers', '49.00', '', 'Comfortable everyday sneakers with memory foam insoles. Great gift for walkers.' ),\\n\\tarray( 'Street Classic Sneakers', 'Sneakers', '72.00', '', 'Classic canvas sneakers in red, black and white.' ),\\n\\tarray( 'Trail Hiker Boots', 'Boots', '119.00', '99.00', 'Waterproof leather hiking boots with a grippy outsole.' ),\\n\\tarray( 'City Chelsea Boots', 'Boots', '89.00', '', 'Brown suede chelsea boots, comfortable for all-day wear.' ),\\n\\tarray( 'Beach Flow Sandals', 'Sandals', '29.00', '', 'Lightweight summer sandals, quick drying, in blue and green.' ),\\n\\tarray( 'Kids Bounce Sandals', 'Sandals', '24.00', '19.00', 'Soft and comfy sandals for kids with an easy strap.' ),\\n\\tarray( 'Cotton Crew Socks (3 pack)', 'Accessories', '12.00', '', 'Breathable cotton socks, three pairs. Makes a nice small gift.' ),\\n);\\nforeach ( $products as $p ) {\\n\\t$product = new WC_Product_Simple();\\n\\t$product->set_name( $p[0] );\\n\\t$product->set_regular_price( $p[2] );\\n\\tif ( '' !== $p[3] ) {\\n\\t\\t$product->set_sale_price( $p[3] );\\n\\t}\\n\\t$product->set_description( $p[4] );\\n\\t$product->set_short_description( $p[4] );\\n\\t$product->set_category_ids( array( $cats[ $p[1] ] ) );\\n\\t$product->set_stock_status( 'instock' );\\n\\t$product->set_status( 'publish' );\\n\\t$product->save();\\n}\\n\\n$pages = array(\\n\\t'Shipping Policy' => 'We ship within 1-2 business days. Standard shipping takes 3-5 days and is free on orders over $50.',\\n\\t'Returns and Refunds' => 'You can return unworn shoes within 30 days for a full refund. Return shipping is free.',\\n\\t'Size Guide' => 'Our shoes run true to size. If you are between sizes, choose the larger size.',\\n);\\nforeach ( $pages as $title => $content ) {\\n\\twp_insert_post( array( 'post_type' => 'page', 'post_status' => 'publish', 'post_title' => $title, 'post_content' => $content ) );\\n}\\n\\nif ( class_exists( 'WBNCHAT_Index' ) ) {\\n\\tWBNCHAT_Index::build_all();\\n}\\nif ( class_exists( 'WBNCHAT_Knowledge' ) ) {\\n\\tWBNCHAT_Knowledge::rebuild();\\n}\\nflush_rewrite_rules();\\n\"}]}"}},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3719180,"resolution":"1","location":"assets","locale":"","width":1280,"height":800},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3719180,"resolution":"2","location":"assets","locale":"","width":1280,"height":800},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3719180,"resolution":"3","location":"assets","locale":"","width":1280,"height":800},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3719180,"resolution":"4","location":"assets","locale":"","width":1280,"height":800}},"screenshots":{"1":"The chat on the storefront, showing product cards with Add to cart buttons.","2":"Design tab with the live, working preview.","3":"Insights: buying actions, top searches and most added products.","4":"Unanswered questions grouped by count."}},"plugin_section":[],"plugin_tags":[3175,2364,5183,247874,143783],"plugin_category":[],"plugin_contributors":[183622],"plugin_business_model":[],"class_list":["post-376494","plugin","type-plugin","status-publish","hentry","plugin_tags-add-to-cart","plugin_tags-chatbot","plugin_tags-product-search","plugin_tags-shopping-assistant","plugin_tags-woocommerce-chatbot","plugin_contributors-webangon","plugin_committers-webangon"],"banners":{"banner":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/banner-772x250.png?rev=3719180","banner_2x":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/banner-1544x500.png?rev=3719180","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/icon-128x128.gif?rev=3719180","icon_2x":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/icon-256x256.gif?rev=3719180","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/screenshot-1.png?rev=3719180","caption":"The chat on the storefront, showing product cards with Add to cart buttons."},{"src":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/screenshot-2.png?rev=3719180","caption":"Design tab with the live, working preview."},{"src":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/screenshot-3.png?rev=3719180","caption":"Insights: buying actions, top searches and most added products."},{"src":"https:\/\/ps.w.org\/webangon-chat-assistant\/assets\/screenshot-4.png?rev=3719180","caption":"Unanswered questions grouped by count."}],"raw_content":"<!--section=description-->\n<p><strong>Shopping Assistant Chatbot for WooCommerce<\/strong> puts a friendly chat window on your store that helps shoppers find the right product and buy it, without leaving the page.<\/p>\n\n<p>Shoppers type the way they talk: <em>\"comfy sneakers under $60\"<\/em>, <em>\"blue hoodie in XL\"<\/em>, <em>\"boots on sale\"<\/em>, <em>\"what is your return policy?\"<\/em>. The assistant replies with matching product cards, quotes your own policy pages, and can add items straight to the cart.<\/p>\n\n<p>It runs entirely on your WordPress server. <strong>No OpenAI, no API keys, no monthly fees, and no customer data sent anywhere.<\/strong> Every reply comes from your own products and pages, so it never invents prices, stock or promises.<\/p>\n\n<h4>Help shoppers find products faster<\/h4>\n\n<ul>\n<li>Understands budgets: \"under 50\", \"between 20 and 40\", \"around 30\"<\/li>\n<li>Understands sorting and filters: cheapest, best rated, newest, on sale, in stock<\/li>\n<li>Understands colours, sizes and preferences like comfortable, lightweight, gift or kids<\/li>\n<li>Follow-ups just work: \"cheaper\", \"in red\", \"show more\", \"only on sale\"<\/li>\n<li>Every product card says <em>why<\/em> it was picked: within budget, on sale, comes in blue, rated 4.5<\/li>\n<\/ul>\n\n<h4>Turn conversations into sales<\/h4>\n\n<ul>\n<li><strong>Add to cart from the chat<\/strong>: \"add 2 wired earphones\", \"make the mouse 3\", \"remove the earphones\", \"checkout\"<\/li>\n<li><strong>Variable products<\/strong>: the bot asks for the missing option (\"Which colour?\") with one-tap choices<\/li>\n<li><strong>Product comparison<\/strong>: \"compare X and Y\" shows price, sale, rating, stock and options side by side<\/li>\n<li><strong>Approved coupons only<\/strong>: suggests only the codes you list, and skips expired ones<\/li>\n<li><strong>Lead capture<\/strong>: after unanswered questions, or when a shopper asks for a human, the bot collects an email<\/li>\n<li>The theme's mini-cart updates live, for guests and logged-in customers<\/li>\n<\/ul>\n\n<h4>Answer store questions automatically<\/h4>\n\n<ul>\n<li>Tick your shipping, returns, warranty or payment pages and the bot quotes the right paragraph, with a link<\/li>\n<li><strong>Order helper<\/strong>: logged-in customers can check their recent orders and status (never anyone else's)<\/li>\n<li><strong>Blocked topics<\/strong>: stop conversations about subjects you don't want to discuss<\/li>\n<\/ul>\n\n<h4>Design it with a live preview<\/h4>\n\n<ul>\n<li>Style the launcher, header, colours, shape and layout, and see the real working chat update as you go<\/li>\n<li>Set the greeting, quick-reply chips, no-answer message and where the chat appears<\/li>\n<li>Show it on every page or only on shop, product, cart, checkout and account pages<\/li>\n<\/ul>\n\n<h4>Learn what your customers want<\/h4>\n\n<ul>\n<li><strong>Insights<\/strong>: searches, product opens, add-to-cart, checkout clicks, comparisons and coupon use, over 7, 30 or 90 days<\/li>\n<li><strong>Unanswered questions<\/strong>: see what shoppers asked that the bot couldn't answer, so you can fill the gaps<\/li>\n<li><strong>Conversations and leads<\/strong>: read transcripts and export them as CSV<\/li>\n<\/ul>\n\n<h4>Private and lightweight<\/h4>\n\n<ul>\n<li>No external services, no tracking scripts, no IP addresses stored<\/li>\n<li>Configurable retention, with old conversations pruned automatically<\/li>\n<li>Settings import and export as JSON<\/li>\n<\/ul>\n\n<h3>How answers are produced<\/h3>\n\n<p>Nothing is generated. Every reply is a template or a quote from your own content.<\/p>\n\n<ol>\n<li><strong>Product index<\/strong>: one row per visible product (title, SKU, price, sale, stock, rating, sales, categories, tags, attributes, colours, sizes, description) with full-text keys. Rows refresh when a product is saved.<\/li>\n<li><strong>Language rules<\/strong>: <code>includes\/rules-en.php<\/code> lists the phrases the bot understands (prices, sorting, filters, colours, sizes, preferences, small talk, product questions and policy topics).<\/li>\n<li><strong>Search<\/strong>: constraints become database filters, the remaining words run as a full-text search with fallbacks, and preference words boost ranking. If a budget returns nothing, it is relaxed and the reply says so.<\/li>\n<li><strong>Policy pages<\/strong>: the pages you tick are split into paragraphs under their headings; a policy question gets the best-matching paragraph, quoted word for word, with a link.<\/li>\n<\/ol>\n\n<h3>For developers<\/h3>\n\n<p>REST endpoints:<\/p>\n\n<ul>\n<li><code>POST \/wp-json\/webangon-chat-assistant\/v1\/chat<\/code> with <code>{ \"message\", \"session\" }<\/code><\/li>\n<li><code>POST \/wp-json\/webangon-chat-assistant\/v1\/event<\/code> with <code>{ \"event\": \"product_open|checkout_click|chip\", \"product_id\", \"label\", \"session\" }<\/code><\/li>\n<li><code>POST \/wp-json\/webangon-chat-assistant\/v1\/lead<\/code> with <code>{ \"email\", \"name\", \"message\", \"page\", \"session\" }<\/code><\/li>\n<\/ul>\n\n<p>Rate limits per hashed IP per 5 minutes: chat 30, event 120, lead 5. IP addresses are not stored.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>The plugin makes no external requests. Sessions store the last search context and the message log, never IP addresses. Retention is configurable and a daily task prunes old sessions. Logging can be switched off under <strong>Behaviour &gt; Privacy<\/strong>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce.<\/li>\n<li>Upload the plugin to <code>wp-content\/plugins\/<\/code>, or install it from <strong>Plugins &gt; Add New<\/strong>, then activate it.<\/li>\n<li>Go to <strong>Chat Assistant &gt; Knowledge &amp; Index<\/strong> and click <strong>Rebuild<\/strong> to index your products, then tick your policy pages.<\/li>\n<li>Style the chat under <strong>Design<\/strong> and try it in the live preview. The chat now appears on your store.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20use%20chatgpt%20or%20another%20ai%20service%3F\"><h3>Does it use ChatGPT or another AI service?<\/h3><\/dt>\n<dd><p>No. Nothing is sent to an external service and no API key is needed. The assistant matches questions against your own product catalogue and pages, so every answer is based on your store's real data.<\/p><\/dd>\n<dt id=\"will%20it%20make%20up%20prices%20or%20promises%3F\"><h3>Will it make up prices or promises?<\/h3><\/dt>\n<dd><p>No. Replies are built from templates and quotes of your own content. It cannot invent discounts, stock levels or policies.<\/p><\/dd>\n<dt id=\"which%20languages%20does%20it%20understand%3F\"><h3>Which languages does it understand?<\/h3><\/dt>\n<dd><p>English out of the box. Developers can add another rules file and switch to it with the <code>wbnchat_rules<\/code> filter.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20variable%20products%3F\"><h3>Does it work with variable products?<\/h3><\/dt>\n<dd><p>Yes. When a product has options, the bot asks for the missing colour or size and then adds the right variation to the cart.<\/p><\/dd>\n<dt id=\"does%20it%20work%20for%20guests%3F\"><h3>Does it work for guests?<\/h3><\/dt>\n<dd><p>Yes. Guests can search, compare and add to cart. The order helper is only available to logged-in customers, and only shows their own orders.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20the%20bot%20can%27t%20answer%3F\"><h3>What happens when the bot can't answer?<\/h3><\/dt>\n<dd><p>It shows your fallback message and logs the question under <strong>Chat Assistant &gt; Unanswered<\/strong>. You can then add product attributes, tick another policy page, or offer lead capture.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: product search chat with budgets, colours, sizes and follow-ups, cart and variation assistant, product comparison, policy page answers, order helper, lead capture, approved coupons, blocked topics, buying-action insights, unanswered questions, conversations with CSV export, and a live design preview.<\/li>\n<\/ul>","raw_excerpt":"A WooCommerce chatbot that finds products, answers store questions and adds to cart. Runs on your own server, no API keys or external AI.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/376494","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=376494"}],"author":[{"embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/webangon"}],"wp:attachment":[{"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=376494"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=376494"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=376494"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=376494"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=376494"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/nl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=376494"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}