Adds WooCommerce shopping tools \u2014 catalog search, product and variant lookup, cart add\/update\/remove, and store-policy answers \u2014 on stores running WooCommerce 7.0 or newer; the tools stay hidden on other sites. A one-time database update runs automatically on upgrade.<\/p>","1.0.0":"
Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3630463,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3630463,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3630463,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3630463,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3630463,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3630463,"resolution":"1","location":"assets","locale":"","width":2400,"height":1640},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3630463,"resolution":"2","location":"assets","locale":"","width":2400,"height":1640},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3630463,"resolution":"3","location":"assets","locale":"","width":2400,"height":1640},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3630463,"resolution":"4","location":"assets","locale":"","width":2400,"height":1640},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3630463,"resolution":"5","location":"assets","locale":"","width":2880,"height":1880},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3630463,"resolution":"6","location":"assets","locale":"","width":2880,"height":1880},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3630463,"resolution":"7","location":"assets","locale":"","width":2880,"height":2150},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3630463,"resolution":"8","location":"assets","locale":"","width":2880,"height":2360}},"screenshots":{"1":"The chat launcher sitting in the bottom-right of the site, respecting iOS safe-area-inset above the home indicator.","2":"The expanded chat panel mid-conversation, streaming an answer grounded in a Knowledge Base article.","3":"Shopping in the chat \u2014 a product search returning live catalog results, each card carrying the store's own price, stock, and \"Add to cart\".","4":"Adding to the cart from the chat, with the running cart, totals, an Undo button, and a link straight to checkout.","5":"Sohay \u2192 Conversations<\/strong> \u2014 the admin SPA listing recent conversations with filter, search, and assignee controls.","6":"A single conversation opened in the admin, showing message history and the reply composer.","7":"Sohay \u2192 AI Settings \u2192 Spend protection<\/strong> \u2014 daily per-visitor and site-wide token caps with the live usage readout.","8":"Sohay \u2192 Dashboard<\/strong> \u2014 conversation volume and trends, recent activity, recently published Knowledge Base articles, and quick actions."}},"plugin_section":[],"plugin_tags":[2353,2364,2369,14090,286],"plugin_category":[47],"plugin_contributors":[154526],"plugin_business_model":[],"class_list":["post-317200","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chatbot","plugin_tags-customer-support","plugin_tags-knowledge-base","plugin_tags-woocommerce","plugin_category-education-and-support","plugin_contributors-bhoot","plugin_committers-bhoot"],"banners":{"banner":"https:\/\/ps.w.org\/sohaychat\/assets\/banner-772x250.png?rev=3630463","banner_2x":"https:\/\/ps.w.org\/sohaychat\/assets\/banner-1544x500.png?rev=3630463","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/sohaychat\/assets\/icon.svg?rev=3630463","icon":"https:\/\/ps.w.org\/sohaychat\/assets\/icon.svg?rev=3630463","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-1.png?rev=3630463","caption":"The chat launcher sitting in the bottom-right of the site, respecting iOS safe-area-inset above the home indicator."},{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-2.png?rev=3630463","caption":"The expanded chat panel mid-conversation, streaming an answer grounded in a Knowledge Base article."},{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-3.png?rev=3630463","caption":"Shopping in the chat \u2014 a product search returning live catalog results, each card carrying the store's own price, stock, and \"Add to cart\"."},{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-4.png?rev=3630463","caption":"Adding to the cart from the chat, with the running cart, totals, an Undo button, and a link straight to checkout."},{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-5.png?rev=3630463","caption":"Sohay \u2192 Conversations<\/strong> \u2014 the admin SPA listing recent conversations with filter, search, and assignee controls."},{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-6.png?rev=3630463","caption":"A single conversation opened in the admin, showing message history and the reply composer."},{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-7.png?rev=3630463","caption":"Sohay \u2192 AI Settings \u2192 Spend protection<\/strong> \u2014 daily per-visitor and site-wide token caps with the live usage readout."},{"src":"https:\/\/ps.w.org\/sohaychat\/assets\/screenshot-8.png?rev=3630463","caption":"Sohay \u2192 Dashboard<\/strong> \u2014 conversation volume and trends, recent activity, recently published Knowledge Base articles, and quick actions."}],"raw_content":"\n Sohay adds an AI chat widget to your WordPress site that answers visitor questions from the articles you publish. You write articles in the built-in Knowledge Base, and the chatbot looks up the best matches before it replies \u2014 so it stays on-topic and uses your real content instead of guessing.<\/p>\n\n On a WooCommerce store, the chatbot shops with your visitors.<\/strong> It searches your catalog, pulls up a product with its size and colour options, reads live stock and prices, answers shipping, returns, and refund questions from your store's own pages, and adds, changes, or removes items in the shopper's cart \u2014 without them leaving the conversation. Every cart change comes with an Undo button, and every price and stock status is read from your store rather than invented. On sites without WooCommerce, none of it appears.<\/p>\n\n Every conversation is saved in a built-in inbox under Sohay \u2192 Conversations<\/strong> \u2014 your team can read, search, filter, assign, and reply from one place.<\/p>\n\n Sohay sends data to OpenAI (https:\/\/openai.com) to generate chat answers and index your Knowledge Base. Without an OpenAI account and API key, the plugin has no upstream model to call and the chat widget cannot answer questions.<\/p>\n\n What is sent, and when<\/strong><\/p>\n\n What is not<\/em> sent.<\/strong> The cart data describes the basket, not the shopper: no name, email address, postal address, phone number, or payment details are included. Sohay never sends order history, customer records, or anything from WooCommerce's checkout to OpenAI, because none of the shopping tools read them.<\/p>\n\n Where it goes<\/strong><\/p>\n\n All requests go to How your API key is handled<\/strong><\/p>\n\n The OpenAI API key you enter under AI Settings<\/strong> authenticates every request. It is encrypted at rest (AES-256-GCM) in your WordPress database, masked in the admin UI after the first save, and excluded from the WordPress REST API. The plugin never sends the key anywhere other than Your responsibilities<\/strong><\/p>\n\n Before activating the plugin, please review OpenAI's Terms of Use<\/a> and Privacy Policy<\/a>. Site owners are responsible for obtaining the appropriate legal basis (consent, contract, legitimate interest, etc.) to share visitor messages with OpenAI under GDPR, CCPA, and other applicable privacy regimes in the jurisdictions they operate in. On a WooCommerce store that basis needs to cover the shopping tools too \u2014 what a visitor has put in their cart is information about that visitor, even though no name or address is attached to it. If you would rather it never left your site, the shopping tools can be switched off individually in code; see the FAQ below.<\/p>\n\n Conversations and messages are stored in custom database tables on your own site.<\/p>\n\n For signed-in visitors<\/strong>, the plugin registers WordPress's personal-data exporter and eraser, so the standard Tools \u2192 Export Personal Data<\/strong> and Tools \u2192 Erase Personal Data<\/strong> flows include their Sohay conversations, matched on their account email.<\/p>\n\n Anonymous (logged-out) visitors' chats<\/strong> aren't tied to an email address, so those email-based tools can't locate them. To erase a specific guest conversation, open it under Sohay \u2192 Conversations<\/strong> and delete it (available to users with the AI-settings capability); it leaves the inbox immediately and is permanently purged after the retention window \u2014 30 days by default, filterable in code. A visitor can also delete their own chat from the widget, and every soft-delete follows the same purge path.<\/p>\n\n On a WooCommerce store<\/strong>, the chatbot's shopping tools read your catalog, your policy pages, and the visitor's own cart. What they find is sent to OpenAI so the model can answer, and it is also saved with the conversation \u2014 that is what lets the product card or cart summary still be there when the visitor scrolls back. So a stored conversation on a WooCommerce store can contain a snapshot of what that visitor had in their cart at the time. It is covered by the same export, erase and retention paths as the rest of the conversation: erasing the chat erases the snapshot with it. No customer name, address, or payment detail is involved \u2014 see External services<\/strong> for the exact list.<\/p>\n\n See the External services<\/strong> section above for what gets sent to OpenAI.<\/p>\n\n\n Yes. Sohay is a front-end for OpenAI's models \u2014 without an OpenAI API key the plugin has no model to call and the chat cannot answer questions. OpenAI bills you directly per token; Sohay does not resell access. The Spend protection<\/strong> controls under AI Settings<\/strong> let you cap daily token usage to keep costs predictable.<\/p><\/dd>\n OpenAI charges per token, and the per-token rate depends on the model you pick (the cheaper models cost a fraction of a cent per chat reply). A small support site typically stays in single-digit dollars per month. The Spend protection<\/strong> controls under AI Settings<\/strong> let you cap daily token usage \u2014 once the cap is hit, the plugin stops calling OpenAI for the rest of the day. The Diagnostics<\/strong> page shows today's usage so you can spot a runaway loop or a hostile bot before it costs you real money.<\/p><\/dd>\n The chatbot is grounded<\/em> in the articles you publish \u2014 if it can't find a matching article, it tells the visitor it doesn't know instead of inventing an answer. To improve answer quality, publish articles covering the questions you actually get asked, and write a fallback \"Contact us\" article so the chatbot can route off-topic questions to your human support team.<\/p><\/dd>\n Sohay \u2192 Conversations<\/strong> lists every chat \u2014 search them, filter by status, assign a chat to a teammate, or reply yourself. The Diagnostics<\/strong> page shows OpenAI errors if you're investigating a technical problem.<\/p><\/dd>\n By default, every WordPress administrator can read every conversation. The plugin ships with five granular capabilities so you can delegate access \u2014 for example, give a support agent the ability to read and reply to chats without granting them access to AI Settings. See the developer questions below for an overview, and the capability documentation in the plugin's GitHub repository for the full matrix with worked role-configuration examples.<\/p><\/dd>\n A tiny launcher (~8 KB) loads on every page. The full chat code only downloads when a visitor actually clicks to open the chat, so most visitors never download it. No third-party scripts, fonts, or trackers are loaded from external CDNs.<\/p><\/dd>\n On stores running WooCommerce 7.0 or later, a shopper can:<\/p>\n\n The chatbot cannot take payment or place an order. When the shopper is ready it hands them to your normal WooCommerce checkout.<\/p><\/dd>\n Yes. The chat widget, Knowledge Base, and Conversations inbox work on any WordPress site \u2014 the shopping tools simply never appear. On stores running WooCommerce 7.0 or later they switch on by themselves, with no configuration. The plugin also declares HPOS and Cart-Checkout-Blocks compatibility so stores don't see an \"uncertified plugin\" banner.<\/p><\/dd>\n Uncheck Show widget<\/strong> under Sohay \u2192 AI Settings<\/strong> to hide it everywhere. To hide it only on certain pages or post types, see the developer questions below.<\/p><\/dd>\n Yes. Sohay \u2192 AI Settings<\/strong> has a Welcome Message field (max 280 characters). Sohay \u2192 KB Settings \u2192 Settings<\/strong> has a Custom System Prompt field (max 4000 characters) for the instructions the chatbot follows when it generates answers. The Custom System Prompt field recognises Encrypted with AES-256-GCM in your WordPress database. The admin UI shows a masked placeholder once you've saved the key, and the value is excluded from the WordPress REST API. The plugin never sends the key anywhere other than Uninstalling deletes the plugin's own database tables (conversations, messages, sync jobs, diagnostic logs), its settings, and the capabilities it added. Your Knowledge Base articles are kept<\/strong> \u2014 they're regular WordPress content, so removing the plugin doesn't delete them, and they're still there if you reinstall. If you want them gone too, delete the articles under KB Articles<\/strong> before you uninstall.<\/p><\/dd>\n Yes. Each site in the network keeps its own conversations, Knowledge Base, and settings \u2014 nothing is shared across the network. Network-activate to enable Sohay everywhere (each site sets itself up on first load) or activate it per-site. Uninstalling from the network removes Sohay's data from every site.<\/p><\/dd>\n The questions below cover code-level customization. Sohay exposes 43 filters and 12 actions in total; the most-used ones appear here, and the full catalog lives in The most commonly customized filters:<\/p>\n\n Example \u2014 keep the WooCommerce catalog answers but never let the cart leave the site:<\/p>\n\n The keys are the tool names: Example \u2014 hide the widget everywhere except the WooCommerce shop and product pages:<\/p>\n\n The constants on Five granular capabilities let you delegate parts of the plugin to non-admin roles:<\/p>\n\n WordPress's built-in Three independent limiter filters. The chat-message rate limit ( Behind Cloudflare or another reverse proxy, enable proxy-aware client-IP detection so per-visitor limits key off the real visitor rather than the proxy:<\/p>\n\n Enable Why site owners pick Sohay<\/h4>\n\n
\n
What's included<\/h4>\n\n
\n
You'll need<\/h4>\n\n
\n
External services<\/h4>\n\n
\n
https:\/\/api.openai.com\/v1\/responses<\/code> (or the equivalent streaming endpoint for the model you selected) and processed by the OpenAI model configured under Sohay \u2192 AI Settings<\/strong>.<\/li>\nhttps:\/\/api.openai.com\/v1\/files<\/code>, \/v1\/vector_stores<\/code>, \/v1\/vector_stores\/*\/files<\/code>) so the chat can retrieve them. The sync runs in the background, not while you click Save.<\/li>\nhttps:\/\/api.openai.com\/v1\/models<\/code> to populate the model-picker dropdown.<\/li>\napi.openai.com<\/code> over HTTPS. The plugin does not contact any other external service \u2014 no analytics, no telemetry, no third-party fonts or CDN assets, and no phone-home for updates. Updates come from WordPress.org.<\/p>\n\napi.openai.com<\/code>.<\/p>\n\nPrivacy<\/h4>\n\n
\n
\n
Do I need an OpenAI account?<\/h3><\/dt>\n
How much will OpenAI cost me?<\/h3><\/dt>\n
Will the chatbot make things up?<\/h3><\/dt>\n
Where can I see what visitors are asking?<\/h3><\/dt>\n
Will my visitors' chats be visible to other admins?<\/h3><\/dt>\n
Does this slow down my site?<\/h3><\/dt>\n
What can shoppers do in the chat on a WooCommerce store?<\/h3><\/dt>\n
\n
Does the plugin work without WooCommerce?<\/h3><\/dt>\n
Can I hide the widget on specific pages?<\/h3><\/dt>\n
Can I customize the welcome message and system prompt?<\/h3><\/dt>\n
{site_name}<\/code> and {current_date}<\/code> placeholders \u2014 they are replaced with your site's title and today's date before the prompt is sent to the model.<\/p><\/dd>\nWhere is my OpenAI API key stored?<\/h3><\/dt>\n
api.openai.com<\/code>.<\/p><\/dd>\nWhat happens to my data if I uninstall Sohay?<\/h3><\/dt>\n
Does Sohay work on WordPress Multisite?<\/h3><\/dt>\n
For developers<\/h3><\/dt>\n
docs\/HOOKS.md<\/code> in the plugin's GitHub repository, alongside docs\/CAPABILITIES.md<\/code> for the full capability matrix.<\/p><\/dd>\nHow do I customize the plugin with code?<\/h3><\/dt>\n
\n
sohaychat_should_render_widget<\/code> (bool) \u2014 per-request gate on the chat widget. Combine with is_singular()<\/code> \/ is_product()<\/code> to scope the widget to specific pages.<\/li>\nsohaychat_allowed_openai_models<\/code> (string[]) \u2014 allowlist of OpenAI model slugs the proxy may call. Restrict to cheaper models to cap spend.<\/li>\nsohaychat_help_url<\/code> and sohaychat_upgrade_url<\/code> (string) \u2014 override the admin-header \"Help\" and \"Upgrade\" links for resellers.<\/li>\nsohaychat_admin_conversation_scope<\/code> \u2014 restrict which conversations a non-admin operator can see.<\/li>\nsohaychat_tools<\/code> \u2014 the resolved tool list for the request. Remove an entry and the chatbot is never told that tool exists, so it can neither call it nor send its data to OpenAI.<\/li>\n<\/ul>\n\nadd_filter( 'sohaychat_tools', function ( $tools ) {\n unset( $tools['sohaychat-wc\/get-cart'], $tools['sohaychat-wc\/update-cart'] );\n return $tools;\n} );\n<\/code><\/pre>\n\nsohaychat-wc\/search-catalog<\/code>, sohaychat-wc\/lookup-catalog<\/code>, sohaychat-wc\/get-product<\/code>, sohaychat-wc\/search-shop-policies-and-faqs<\/code>, sohaychat-wc\/get-cart<\/code>, sohaychat-wc\/update-cart<\/code>, and sohaychat-kb\/get-information<\/code> for the Knowledge Base lookup. Returning an empty array disables tool use entirely \u2014 the chatbot still replies, just with no way to look anything up.<\/p>\n\nadd_filter( 'sohaychat_should_render_widget', function ( $enabled ) {\n if ( ! $enabled ) { return false; }\n return function_exists( 'is_shop' ) && ( is_shop() || is_product() );\n} );\n<\/code><\/pre>\n\nBengal_Studio\\Sohaychat\\Sohaychat_Hooks<\/code> are the recommended form for new code; the legacy literal form continues to work across releases.<\/p><\/dd>\nHow do I delegate access to non-admin roles?<\/h3><\/dt>\n
\n
sohaychat_manage<\/code> \u2014 AI Settings page, OpenAI key reveal, model selection. Implicitly grants all four other plugin caps.<\/li>\nsohaychat_view_conversations<\/code> \u2014 Sohay menu, Dashboard + Conversations submenus (read-only). Non-admin users with this cap are scoped to \"assigned to me or unassigned\" conversations.<\/li>\nsohaychat_reply_conversations<\/code> \u2014 everything sohaychat_view_conversations<\/code> grants, plus operator reply, assignee changes, pin \/ unpin, close \/ reopen. Implicitly grants sohaychat_view_conversations<\/code>.<\/li>\nsohaychat_manage_kb<\/code> \u2014 KB Settings admin page and KB sync routes.<\/li>\nsohaychat_view_logs<\/code> \u2014 Diagnostics admin page (read-only). Clearing the log buffer is escalated to sohaychat_manage<\/code> for forensics integrity.<\/li>\n<\/ul>\n\nmanage_options<\/code> capability implicitly grants all five, so administrators keep working unchanged. Use Members, User Role Editor, or WP-CLI (wp cap add <role> sohaychat_view_conversations<\/code>) to delegate caps to non-admin roles. See docs\/CAPABILITIES.md<\/code> in the GitHub repository for the full matrix, every REST route's required cap, three worked role-configuration examples, and the conversation-scope filter contract.<\/p><\/dd>\nHow do I adjust rate limits or the daily OpenAI token budget in code?<\/h3><\/dt>\n
limit<\/code> requests per rolling window<\/code> seconds, per visitor):<\/p>\n\nadd_filter( 'sohaychat_rate_limit_options', function ( $opts ) {\n $opts['limit'] = 60;\n $opts['window'] = 60;\n return $opts;\n} );\n<\/code><\/pre>\n\nadd_filter( 'sohaychat_rate_limit_options', function ( $opts ) {\n $opts['proxy_support'] = true;\n return $opts;\n} );\n<\/code><\/pre>\n\n